New-CMRequirementRuleOUValue

Creare una regola di requisito dell'unità organizzativa di Active Directory per un tipo di distribuzione dell'applicazione.

Sintassi

New-CMRequirementRuleOUValue
   -OrganizationalUnit <Hashtable[]>
   -RuleOperator <RuleExpressionOperator>
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per creare una regola di requisito dell'unità organizzativa (OU) di Active Directory per un tipo di distribuzione dell'applicazione.

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 unità organizzative di Active Directory

Questo esempio usa innanzitutto il cmdlet Get-CMGlobalCondition per ottenere la condizione globale predefinita dell'unità organizzativa . Definisce quindi diverse variabili per due unità organizzative di Active Directory. Successivamente viene creato l'oggetto regola del requisito. Infine passa l'oggetto regola al cmdlet Set-CMScriptDeploymentType per aggiungere il requisito.

$myGC = Get-CMGlobalCondition -Name "Organizational unit (OU)"

$ouName1 = "CN=Computers,DC=Contoso,DC=Com"

$ouName2 = "CN=Servers,DC=Contoso,DC=Com"

$ouA = @{"OU"=$ouName1; "IsIncludeSubOU"=$true}

$ouB = @{"OU"=$ouName2; "IsIncludeSubOU"=$false}

$myRule = $myGC | New-CMRequirementRuleOUValue -RuleOperator NoneOf -OU $ouA,$ouB

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

Parametri

-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

-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 da usare come base per questa regola del requisito. Per ottenere questo oggetto, usare il cmdlet Get-CMGlobalCondition .

Nella maggior parte dei casi si userà la condizione globale predefinita dell'unità organizzativa,ad esempio: Get-CMGlobalCondition -Name "Organizational unit (OU)".

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

-OrganizationalUnit

Specificare una tabella hash per specificare il nome dell'unità organizzativa e se includere le unità organizzative figlio. Ad esempio:

@{"OU"="CN=Computers,DC=Contoso,DC=Com"; "IsIncludeSubOU"=$true}

Type:Hashtable[]
Aliases:OrganizationalUnits, OU, OUs, OrganizationalUnitWithSubOUOption, OrganizationalUnitWithSubOUOptions
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RuleOperator

Specificare l'operatore per confrontare l'impostazione del dispositivo con il valore previsto.

Type:RuleExpressionOperator
Accepted values:OneOf, NoneOf
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object