共用方式為

New-CMRequirementRuleCommonValue

  • 參考
模組:
ConfigurationManager

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

語法

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 結合。

類型: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

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

例如：

$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