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