New-CMRequirementRuleRegistryKeyPermissionValue

  • Riferimento
Modulo:
ConfigurationManager

Creare una regola di requisito per verificare le autorizzazioni della chiave del Registro di sistema.

Sintassi

New-CMRequirementRuleRegistryKeyPermissionValue
   -ControlEntry <RegistryAccessControlEntry[]>
   [-Exclusive <Boolean>]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per creare una regola di requisito in un tipo di distribuzione dell'applicazione che verifica le autorizzazioni della chiave del Registro di sistema. Richiede una condizione globale personalizzata della chiave del Registro di sistema del tipo di dati.

Consiglio

Per il confronto, se si crea manualmente questa regola dei requisiti nella console di Configuration Manager, selezionare le opzioni seguenti:

  • Categoria: Personalizzata
  • Condizione: selezionare una condizione globale personalizzata della chiave del Registro di sistema del tipo di dati
  • Tipo di regola: Valore
  • Proprietà: Autorizzazioni

Dopo aver usato questo cmdlet, usare uno dei cmdlet Add- o Set- per i tipi di distribuzione. Passare questo oggetto regola di requisito ai parametri AddRequirement o RemoveRequirement .

Per altre informazioni, vedere Requisiti del tipo di distribuzione e Creare condizioni globali.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Aggiungere una regola di requisito per le autorizzazioni della chiave del Registro di sistema

Questo esempio usa innanzitutto il cmdlet Get-CMGlobalCondition per ottenere una condizione globale personalizzata. Usa quindi il cmdlet New-CMRegistryAccessControlEntry per creare due voci di controllo di accesso per utenti specifici. Successivamente viene creato l'oggetto regola di requisito per verificare che la chiave del Registro di sistema disponga delle autorizzazioni specificate nelle voci di controllo di accesso. Infine passa l'oggetto regola al cmdlet Set-CMScriptDeploymentType per aggiungere il requisito.

$myGC = Get-CMGlobalCondition -Name "LOB app registry key"

$userName = "contoso\jqpublic"
$ce = New-CMRegistryAccessControlEntry -GroupOrUserName $userName -AccessOption Allow -Permission Read,Write

$userName2 = "contoso\jdoe"
$ce2 = New-CMRegistryAccessControlEntry -GroupOrUserName $userName2 -AccessOption Allow -Permission Read

$myRule = $myGC | New-CMRequirementRuleRegistryKeyPermissionValue -Exclusive $false -ControlEntry $ce,$ce2

Set-CMScriptDeploymentType -ApplicationName "Central app" -DeploymentTypeName "Install" -AddRequirement $myRule

Parametri

-ControlEntry

Specificare una matrice di oggetti voce di controllo di accesso. Una voce di controllo di accesso definisce autorizzazioni specifiche per un utente o un gruppo specifico. Per ottenere questo oggetto, usare il cmdlet New-CMRegistryAccessControlEntry .

Type:RegistryAccessControlEntry[]
Aliases:ControlEntries, RegistryAccessControlEntry, RegistryAccessControlEntries
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Exclusive

Se questo parametro è $true, affinché la regola sia conforme, deve corrispondere esattamente all'ACE specificato. Qualsiasi altra autorizzazione per la chiave del Registro di sistema causa l'esito negativo della regola.

Se impostato su $false, affinché la regola sia conforme, l'ACE specificato deve esistere e possono esistere anche altre autorizzazioni.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specificare un oggetto condizione globale personalizzato da usare come base per questa regola del requisito. Per ottenere questo oggetto, usare il cmdlet Get-CMGlobalCondition .

Per visualizzare l'elenco delle condizioni globali della chiave del Registro di sistema disponibili nel sito, usare il comando di PowerShell seguente:

Get-CMGlobalCondition | Where-Object DataType -eq "RegistryKey" | Select-Object LocalizedDisplayName

Type:IResultObject
Aliases:GlobalCondition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object