New-CMRequirementRuleCommonValue

  • リファレンス
モジュール:
ConfigurationManager

アプリケーションのデプロイの種類に対して値ベースのグローバル条件を評価する要件ルールを作成します。

構文

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

説明

このコマンドレットを使用して、 Value 規則の種類でグローバル条件を評価するアプリケーション展開の種類に対して要件ルールを作成します。

このコマンドレットを使用した後、展開の種類に 対して Add またはSet- のいずれかのコマンドレットを使用します。 この要件ルール オブジェクトを AddRequirement パラメーターまたは RemoveRequirement パラメーターに渡します。

詳細については、「 展開の種類の要件 」および「 グローバル条件の作成」を参照してください。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 1: プロセッサ数の要件規則を追加する

この例では、最初に Get-CMGlobalCondition コマンドレットを使用して、既定 のプロセッサ数 グローバル条件を取得します。 次に、デバイスのグローバル条件を 2 以上に評価するための要件ルール オブジェクトを作成します。 最後に、その規則オブジェクトを Set-CMScriptDeploymentType コマンドレットに渡して、要件を追加します。

つまり、アプリをインストールするには、デバイスに少なくとも 2 つのプロセッサが必要です。

$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 コマンドレットを 使用します。

グローバル条件は、値の規則の種類をサポートする必要があります。

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

のような BetweenRuleOperator を使用する場合は、このパラメーターを使用して上限値を指定します。

以下に例を示します。

$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