New-CMRequirementRuleCMSiteValue

  • 参考
模块:
ConfigurationManager

为应用程序部署类型创建Configuration Manager站点要求规则。

语法

New-CMRequirementRuleCMSiteValue
   -Site <String[]>
   -RuleOperator <RuleExpressionOperator>
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

说明

使用此 cmdlet 为应用程序部署类型创建Configuration Manager站点要求规则。

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

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

注意

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

示例

示例 1：为Configuration Manager网站添加要求规则

此示例首先使用 Get-CMGlobalCondition cmdlet 获取默认Configuration Manager站点全局条件。 然后，它定义包含两个Configuration Manager站点的字符串数组。 接下来，它将创建要求规则对象。 最后，它将该规则对象传递给 Set-CMScriptDeploymentType cmdlet 以添加要求。

$gc = Get-CMGlobalCondition -Name "Configuration Manager site"
$sites = @('XYZ', 'ABC')
$rule = New-CMRequirementRuleActiveDirectorySiteValue -InputObject $gc -RuleOperator OneOf -Site $sites

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

参数

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

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

在大多数情况下，将使用默认Configuration Manager站点全局条件，例如：Get-CMGlobalCondition -Name "Configuration Manager site"。

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

-RuleOperator

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

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

-Site

指定Configuration Manager网站代码的字符串数组。

Type:String[]
Aliases:Sites, SiteCode, SiteCodes
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object