New-CMTSRule
[動的変数の設定] タスク シーケンス ステップに追加するルールを作成します。
構文
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 と Model: コンピューターの make と model の値を評価します。
- タスク シーケンス変数: 評価するタスク シーケンス変数、条件、値を追加します。
詳細については、「 動的ルールと変数」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: Windows PE でダウンロード先を設定する
この例では、次の規則を作成します。
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
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultGateway
[場所] 規則の種類に既定のゲートウェイを指定します。
たとえば、この値を 192.168.10.1
に設定すると、次の規則が追加されます。 IF Default gateway equals "192.168.10.1" THEN
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MacAddress
[コンピューター] 規則の種類の MAC アドレスを指定します。
たとえば、この値を 00:11:22:33:44:55
に設定すると、次の規則が追加されます。 IF MAC address equals "00:11:22:33:44:55" THEN
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Make
[作成] ルールと [モデル] ルールの種類に [Make]\(作成\) と [モデル] ルールの種類を指定します。 他の値を設定するには、 Model パラメーターを使用します。 両方の値が true の場合、ルールは true と評価されます。
ワイルドカード文字を使用できます。
-
*
: 複数の文字 -
?
: 1 文字
たとえば、この値を Surface
に設定し、[ モデル ] を *
すると、次の規則が追加されます。 IF Make equals "Surface" AND Model equals "*" THEN
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Model
[作成] ルールと[モデル] ルールの種類に [モデル] を指定します。 他の値を設定するには、 Make パラメーターを使用します。 両方の値が true の場合、ルールは true と評価されます。
ワイルドカード文字を使用できます。
-
*
: 複数の文字 -
?
: 1 文字
たとえば、この値を [ *
] に設定し、[ 作成] を [ Surface
] に設定すると、次の規則が追加されます。 IF Make equals "Surface" AND Model equals "*" THEN
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ReferencedVariableName
[タスク シーケンス 変数] ルールの種類に [変数] を 指定します。 ReferencedVariableOperator パラメーターと ReferencedVariableValue パラメーターも設定する必要があります。
この変数名には、組み込みのタスク シーケンス変数または作成したカスタム変数を指定できます。 詳細については、「 Configuration Manager でタスク シーケンス変数を使用する方法」を参照してください。
たとえば、次の値を設定するとします。
-
ReferencedVariableName:
OSDRegisteredOrgName
-
ReferencedVariableOperator:
Equals
-
ReferencedVariableValue:
Contoso
次に、次の規則を追加します。 IF OSDRegisteredOrgName equals "Contoso" THEN
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ReferencedVariableOperator
[タスク シーケンス変数] ルールの種類に [条件] を指定します。 ReferencedVariableName パラメーターと ReferencedVariableValue パラメーターも設定する必要があります。 使用可能な演算子については、このパラメーターで受け入れられる値の一覧を参照してください。
たとえば、次の値を設定するとします。
-
ReferencedVariableName:
OSDRegisteredOrgName
-
ReferencedVariableOperator:
Equals
-
ReferencedVariableValue:
Contoso
次に、次の規則を追加します。 IF OSDRegisteredOrgName equals "Contoso" THEN
型: | VariableOperatorType |
指定可能な値: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ReferencedVariableValue
[タスク シーケンス変数] ルールの種類に [値] を指定します。 ReferencedVariableName パラメーターと ReferencedVariableOperator パラメーターも設定する必要があります。
たとえば、次の値を設定するとします。
-
ReferencedVariableName:
OSDRegisteredOrgName
-
ReferencedVariableOperator:
Equals
-
ReferencedVariableValue:
Contoso
次に、次の規則を追加します。 IF OSDRegisteredOrgName equals "Contoso" THEN
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SerialNumber
[コンピューター] ルールの種類にシリアル番号を指定します。
たとえば、この値を 123456
に設定すると、次の規則が追加されます。 IF Asset tag equals "123456" THEN
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Uuid
[コンピューター] ルールの種類に UUID を指定します。
たとえば、この値を de5ba380-f692-45e0-bbd3-0e40543b549e
に設定すると、次の規則が追加されます。 IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Variable
ルールが true と評価されたときにステップで設定する必要がある既存のタスク シーケンス変数またはカスタム タスク シーケンス変数と関連する値を指定します。
たとえば、この値を @{'OSDDownloadDestinationLocationType' = 'TSCache'}
に設定すると、ルールの THEN
の後に次の変数が追加されます。 SET OSDDownloadDestinationLocationType = "TSCache"
同じハッシュテーブルに複数の変数を指定するには、セミコロン (;
) 区切り記号を使用します。 例: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}
型: | Hashtable |
Aliases: | Variables |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject