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 と 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

次の方法で共有

New-CMTSRule

構文

説明

例

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

パラメーター

-AssetTag

-Confirm

-DefaultGateway

-DisableWildcardHandling

-ForceWildcardHandling

-MacAddress

-Make

-Model

-ReferencedVariableName

-ReferencedVariableOperator

-ReferencedVariableValue

-SerialNumber

-Uuid

-Variable

-WhatIf

入力

出力

フィードバック

その他のリソース

次の方法で共有

New-CMTSRule

構文

説明

例

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

パラメーター

-AssetTag

-Confirm

-DefaultGateway

-DisableWildcardHandling

-ForceWildcardHandling

-MacAddress

-Make

-Model

-ReferencedVariableName

-ReferencedVariableOperator

-ReferencedVariableValue

-SerialNumber

-Uuid

-Variable

-WhatIf

入力

出力

関連リンク

フィードバック

その他のリソース