Share via

New-CMRequirementRuleCommonValue

  • 參考
模組:
ConfigurationManager

建立需求規則，以在應用程式部署類型上評估以值為基礎的全域條件。

Syntax

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

Description

使用此 Cmdlet 在評估具有 值 規則類型的全域條件的應用程式部署類型上建立需求規則。

使用此 Cmdlet 之後，請針對部署類型使用其中一個 Add- 或 Set- Cmdlet。 將此需求規則物件傳遞至 AddRequirement 或 RemoveRequirement 參數。

如需詳細資訊，請 參閱部署類型需求 和 建立全域條件。

注意事項

從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：新增處理器數目的需求規則

此範例會先使用 Get-CMGlobalCondition Cmdlet 來取得預設 的處理器全域條件數目 。 接下來，它會建立需求規則物件，以評估裝置上的全域條件是否大於或等於兩個。 最後，它會將該規則物件傳遞至 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結合。

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 。

全域條件必須支援Value的規則類型。

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

-PropertyForAssembly

如果全域條件支援它，請指定要與預期值比較的元件屬性。

Type:AssemblyProperty
Accepted values:Culture, Version, PublicKeyToken
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PropertyForFileFolder

如果全域條件支援，請指定要與預期值比較的檔案或資料夾屬性。

例如：

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

Type:FileFolderProperty
Accepted values:Size, Version, DateCreated, DateModified, Company, ProductName, SHA1Hash, Permissions, Attributes
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RuleOperator

指定操作員，以比較裝置的設定與預期的值。

Type:RuleExpressionOperator
Accepted values: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value1

指定要比較之預期值的字串或陣列。

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value2

如果您使用 RuleOperator ，例如 Between ，請使用此參數來指定上限值。

例如：

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object