Freigeben über

New-CMRequirementRuleOUValue

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie eine Anforderungsregel für eine Active Directory-Organisationseinheit (OE) für einen Anwendungsbereitstellungstyp.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Anforderungsregel für eine Active Directory-Organisationseinheit (OE) für einen Anwendungsbereitstellungstyp zu erstellen.

Nachdem Sie dieses Cmdlet verwendet haben, verwenden Sie eines der Add- oder Set-Cmdlets für Bereitstellungstypen. Übergeben Sie dieses Anforderungsregelobjekt entweder an die Parameter AddRequirement oder RemoveRequirement .

Weitere Informationen finden Sie unter Anforderungen für den Bereitstellungstyp und Erstellen globaler Bedingungen.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Hinzufügen einer Anforderungsregel für Active Directory-Organisationseinheiten

In diesem Beispiel wird zunächst das Cmdlet Get-CMGlobalCondition verwendet, um die globale Standardbedingung organisationseinheit (OE) abzurufen. Anschließend werden mehrere Variablen für zwei Active Directory-Organisationseinheiten definiert. Als Nächstes wird das Anforderungsregelobjekt erstellt. Schließlich wird dieses Regelobjekt an das Cmdlet Set-CMScriptDeploymentType übergeben, um die Anforderung hinzuzufügen.

$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

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Geben Sie ein globales Bedingungsobjekt an, das als Grundlage für diese Anforderungsregel verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMGlobalCondition .

In den meisten Fällen verwenden Sie die globale Standardbedingung organisationseinheit (OE), z. B.: Get-CMGlobalCondition -Name "Organizational unit (OU)".

Typ:IResultObject
Aliase:GlobalCondition
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OrganizationalUnit

Geben Sie eine Hashtabelle an, um den Namen der Organisationseinheit und die Angabe, ob untergeordnete Organisationseinheiten eingeschlossen werden sollen, anzugeben. Zum Beispiel:

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

Typ:Hashtable[]
Aliase:OrganizationalUnits, OU, OUs, OrganizationalUnitWithSubOUOption, OrganizationalUnitWithSubOUOptions
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RuleOperator

Geben Sie den Operator an, der die Einstellung des Geräts mit dem erwarteten Wert vergleichen soll.

Typ:RuleExpressionOperator
Zulässige Werte:OneOf, NoneOf
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object