New-CMTSStepConditionQueryWmi
タスク シーケンス ステップの WMI クエリ 条件を作成します。
構文
New-CMTSStepConditionQueryWmi
[-Namespace <String[]>]
-Query <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットを使用して、タスク シーケンス ステップの WMI クエリ 条件オブジェクトを作成します。 次に、Condition パラメーターまたは AddCondition パラメーターを使用して、New-CMTSStep* コマンドレットまたは Set-CMTSStep* コマンドレットのいずれかを使用します。 たとえば、 Set-CMTSStepApplyDataImage です。
詳細については、「 タスク シーケンス エディターの使用: 条件」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ハードウェア モデルに基づいてクエリ条件を作成する
この例では、まず、コンピューター モデルの WMI に対してクエリを実行する条件オブジェクトを作成します。
次に、Set-CMTSStepRunPowerShellScript コマンドレットを使用して、この条件オブジェクトを既定の OS 展開タスク シーケンスの PowerShell スクリプトの実行ステップに追加します。
$model = "Latitude E7470"
$query = "Select * From Win32_ComputerSystem Where Model = `"$model`""
$condition = New-CMTSStepConditionQueryWMI -Namespace "root\cimv2" -Query $query
$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"
Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -AddCondition $conditionこのサンプル スクリプトは、この手順で次の条件を作成します。
WMI Query Select * From Win32_ComputerSystem Where Model = "Latitude E7470"
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Namespace
クエリの WMI 名前空間を指定します。 たとえば、root\cimv2 のように指定します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Query
WMI クエリを指定します。 コマンドレットはクエリの有効性をテストしません。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_WMIConditionExpression」を参照してください。