New-CMTSRule

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

[動的変数の設定] タスク シーケンス ステップに追加 するルール を作成します。

構文

New-CMTSRule
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-AssetTag <String>]
   [-MacAddress <String>]
   [-SerialNumber <String>]
   [-Uuid <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-DefaultGateway <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-Make <String>]
   [-Model <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-ReferencedVariableName <String>]
   [-ReferencedVariableOperator <VariableOperatorType>]
   [-ReferencedVariableValue <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、動的変数の設定タスク シーケンス ステップに追加する ルール オブジェクト を作成します。 ルールを追加するには 、New-CMTSStepSetDynamicVariable コマンドレットまたは Set-CMTSStepSetDynamicVariable コマンドレットを使用します。 タスク シーケンスでこの手順を実行すると、動的ルールと変数が順番に評価されます。 特定のデバイスのルールを評価すると、それらのルールに基づいてタスク シーケンス変数を設定できます。

ルールには次の 4 種類があります。

  • コンピューター: ハードウェア アセット タグ、UUID、シリアル番号、または MAC アドレスの値を評価します。
  • 場所: 既定のネットワーク ゲートウェイの値を評価します。
  • Make and Model: コンピューターの make と model の値を評価します。
  • タスク シーケンス変数: 評価するタスク シーケンス変数、条件、および値を追加します。

詳細については、「動的ルール と変数」を参照してください。

注意

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

例

例 1: PE でダウンロード先を設定Windowsする

この例では、次のルールを作成します。

IF _SMSTSInWinPE equals "TRUE" THEN SET OSDDownloadDestinationLocationType = "TSCache"

次に、このルールをタスク シーケンス内のこの手順の既存のインスタンスに追加します。

$tsrule = New-CMTSRule -Variable @{'OSDDownloadDestinationLocationType' = 'TSCache'} -ReferencedVariableName "_SMSTSInWinPE" -ReferencedVariableOperator equals -ReferencedVariableValue TRUE

$tsname = "Default IPU"
$tsstep = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsname -StepName $tsstep -AddRule $tsrule

パラメーター

-AssetTag

コンピューター ルール の種類の Asset タグを 指定します。 最大値は 255 文字です。

たとえば、この値をに設定すると 123456 、次のルールが追加されます。 IF Asset tag equals "123456" THEN

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

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DefaultGateway

場所ルール の種類の 既定の ゲートウェイを 指定します。

たとえば、この値をに設定すると 192.168.10.1 、次のルールが追加されます。 IF Default gateway equals "192.168.10.1" THEN

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

-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

-MacAddress

コンピューター ルール の種類の MAC アドレスを 指定します。

たとえば、この値をに設定すると 00:11:22:33:44:55 、次のルールが追加されます。 IF MAC address equals "00:11:22:33:44:55" THEN

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

-Make

Make ルール と Model ルール の種類を 指定します。 他の値を設定するには、Model パラメーター を使用 します。 両方の値が true の場合、ルールは true と評価されます。

ワイルドカード文字を使用できます。

  • *: 複数の文字
  • ?: 1 文字

たとえば、この値を [Model] に設定すると Surface **** * 、次のルールが追加されます。IF Make equals "Surface" AND Model equals "*" THEN

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

-Model

Make ルール タイプと Model ルールタイプのモデルを 指定します。 他の値を設定するには 、Make パラメーターを使用 します。 両方の値が true の場合、ルールは true と評価されます。

ワイルドカード文字を使用できます。

  • *: 複数の文字
  • ?: 1 文字

たとえば、この値を [Make] に設定すると * **** Surface 、次のルールが追加されます。IF Make equals "Surface" AND Model equals "*" THEN

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

-ReferencedVariableName

[タスク シーケンス 変数 ] ルール の種類に変数を 指定します。 また 、ReferencedVariableOperator パラメーターと ReferencedVariableValue パラメーターも設定する必要 があります。

この変数名には、組み込みのタスク シーケンス変数または作成したカスタム変数を指定できます。 詳細については 、「Configuration Manager でタスク シーケンス変数を使用する方法」を参照してください。

たとえば、次の値を設定するとします。

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

次に、次のルールを追加します。 IF OSDRegisteredOrgName equals "Contoso" THEN

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

-ReferencedVariableOperator

タスク シーケンス 変数ルール の 種類の条件を 指定します。 また、ReferencedVariableName パラメーターと ReferencedVariableValue パラメーターも設定する必要 があります。 使用可能な演算子については、このパラメーターで使用できる値の一覧を参照してください。

たとえば、次の値を設定するとします。

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

次に、次のルールを追加します。 IF OSDRegisteredOrgName equals "Contoso" THEN

Type:VariableOperatorType
Accepted values:Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ReferencedVariableValue

[タスク シーケンス 変数 ] ルール の種類に値を 指定します。 また 、ReferencedVariableName パラメーターと ReferencedVariableOperator パラメーターも設定する必要 があります。

たとえば、次の値を設定するとします。

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

次に、次のルールを追加します。 IF OSDRegisteredOrgName equals "Contoso" THEN

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

-SerialNumber

[コンピューター] ルールの種類に シリアル 番号を 指定します。

たとえば、この値をに設定すると 123456 、次のルールが追加されます。 IF Asset tag equals "123456" THEN

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

-Uuid

コンピューター ルール の種類に UUID を 指定します。

たとえば、この値をに設定すると de5ba380-f692-45e0-bbd3-0e40543b549e 、次のルールが追加されます。 IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN

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

-Variable

ルールが true に評価される場合に、手順で設定する必要がある既存またはカスタムのタスク シーケンス変数と関連付けられた値を指定します。

たとえば、この値をに設定すると、ルールの後に次 @{'OSDDownloadDestinationLocationType' = 'TSCache'} の変数 THEN が追加されます。 SET OSDDownloadDestinationLocationType = "TSCache"

同じハッシュテーブルで複数の変数を指定するには、セミコロン ( ) 区切り ; 記号を使用します。 例: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

Type:Hashtable
Aliases:Variables
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

入力

なし

出力

IResultObject