New-CMRequirementRuleCommonValue

创建要求规则来评估应用程序部署类型的基于值的全局条件。

语法

New-CMRequirementRuleCommonValue
   [-PropertyForAssembly <AssemblyProperty>]
   [-PropertyForFileFolder <FileFolderProperty>]
   -RuleOperator <RuleExpressionOperator>
   -Value1 <String[]>
   [-Value2 <String[]>]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

说明

使用此 cmdlet 在应用程序部署类型上创建要求规则,该部署类型使用 Value 规则类型评估全局条件。

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

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

注意

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

示例

示例 1:为处理器数添加要求规则

此示例首先使用 Get-CMGlobalCondition cmdlet 获取默认 的处理器数 全局条件。 接下来,它会创建要求规则对象,以评估设备上大于或等于 2 的全局条件。 最后,它将该规则对象传递给 Set-CMScriptDeploymentType cmdlet 以添加要求。

换句话说,设备需要至少有两个处理器才能安装应用。

$myGC = Get-CMGlobalCondition -Name "Number of processors"
$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $myGC -Value1 "2" -RuleOperator GreaterEquals

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。

全局条件需要支持 Value 的规则类型

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

-PropertyForAssembly

如果全局条件支持它,请指定要与预期值进行比较的程序集属性。

类型:AssemblyProperty
接受的值:Culture, Version, PublicKeyToken
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PropertyForFileFolder

如果全局条件支持它,请指定文件或文件夹属性以与预期值进行比较。

例如:

$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $myGC -PropertyForFileFolder DateCreated -Value1 "2018-08-07T05:32:45Z" -RuleOperator GreaterEquals

类型:FileFolderProperty
接受的值:Size, Version, DateCreated, DateModified, Company, ProductName, SHA1Hash, Permissions, Attributes
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RuleOperator

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

类型:RuleExpressionOperator
接受的值:And, Or, Other, IsEquals, NotEquals, GreaterThan, LessThan, Between, NotBetween, GreaterEquals, LessEquals, BeginsWith, NotBeginsWith, EndsWith, NotEndsWith, Contains, NotContains, AllOf, OneOf, NoneOf, SetEquals, SubsetOf, ExcludesAll
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Value1

指定要比较的预期值的字符串或数组。

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

-Value2

如果使用类似于 Between的 RuleOperator,请使用此参数指定上限值。

例如:

$myRule = New-CMRequirementRuleCommonValue -GlobalCondition $GC -PropertyForFileFolder Size -Value1 200 -Value2 300 -RuleOperator between

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object