New-CMRequirementRuleOUValue

为应用程序部署类型创建 Active Directory 组织单位 (OU) 要求规则。

语法

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

说明

使用此 cmdlet 为应用程序部署类型创建 Active Directory 组织单位 (OU) 要求规则。

使用此 cmdlet 后,请对部署类型使用其中一个 Add-Set- cmdlet。 将此要求规则对象传递给 AddRequirementRemoveRequirement 参数。

有关详细信息,请参阅 部署类型要求创建全局条件

注意

从Configuration Manager站点驱动器运行Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:为 Active Directory OU 添加要求规则

此示例首先使用 Get-CMGlobalCondition cmdlet 获取默认 组织单位 (OU) 全局条件。 然后,它为两个 Active Directory OU 定义多个变量。 接下来,它将创建要求规则对象。 最后,它将该规则对象传递给 Set-CMScriptDeploymentType cmdlet 以添加要求。

$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

参数

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定要用作此要求规则基础的全局条件对象。 若要获取此对象,请使用 Get-CMGlobalCondition cmdlet。

在大多数情况下,将使用默认 的组织单位 (OU) 全局条件,例如: Get-CMGlobalCondition -Name "Organizational unit (OU)"

类型:IResultObject
别名:GlobalCondition
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-OrganizationalUnit

指定哈希表以指定 OU 的名称以及是否包括子 OU。 例如:

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

类型:Hashtable[]
别名:OrganizationalUnits, OU, OUs, OrganizationalUnitWithSubOUOption, OrganizationalUnitWithSubOUOptions
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-RuleOperator

指定运算符以将设备的设置与预期值进行比较。

类型:RuleExpressionOperator
接受的值:OneOf, NoneOf
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object