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:\> 。 詳細については 、「Getting started」を参照してください。

例

例 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
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

この要件ルールの基礎として使用するグローバル条件オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMGlobalCondition コマンドレットを使用 します。

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

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

グローバル条件でサポートされている場合は、期待値と比較する assembly プロパティを指定します。

Type:AssemblyProperty
Accepted values:Culture, Version, PublicKeyToken
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
-Value1

比較する必要がある値の文字列または配列を指定します。

Type:String[]
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object