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 之一。 将此要求规则对象传递给 AddRequirement 或 RemoveRequirement 参数。
注意
从 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
相关链接
- New-CMRequirementRuleActiveDirectorySiteValue
- New-CMRequirementRuleBooleanValue
- New-CMRequirementRuleCMSiteValue
- New-CMRequirementRuleDeviceOwnershipValue
- New-CMRequirementRuleExistential
- New-CMRequirementRuleExpression
- New-CMRequirementRuleFileAttributeValue
- New-CMRequirementRuleFilePermissionValue
- New-CMRequirementRuleFreeDiskSpaceValue
- New-CMRequirementRuleInputTypeValue
- New-CMRequirementRuleOperatingSystemLanguageValue
- New-CMRequirementRuleOperatingSystemValue
- New-CMRequirementRuleOUValue
- New-CMRequirementRuleRegistryKeyPermissionValue
- New-CMRequirementRuleScreenResolutionValue
- Get-CMGlobalCondition
- 部署类型要求
- 创建全局条件