New-CMTSStepConditionQueryWmi

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

タスク シーケンス ステップの WMI クエリ条件を作成します。

構文

New-CMTSStepConditionQueryWmi
   [-Namespace <String[]>]
   -Query <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、 タスク シーケンス ステップの WMI クエリ条件オブジェクトを作成します。 次に、Condition パラメーターまたはAddConditionパラメーターを使用して** * 、New-CMTSStep _ または ** Set-CMTSStep * _** コマンドレットのいずれかを使用します。 たとえば 、Set-CMTSStepApplyDataImageです。

詳細については、「Use the task sequence editor: Conditions 」を参照してください。

注意

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

例

例 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

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

Type:SwitchParameter
Aliases:cf
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
-Namespace

クエリの WMI 名前空間を指定します。 たとえば、root\cimv2 のように指定します。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Query

WMI クエリを指定します。 コマンドレットはクエリの有効性をテストしない。

Type:String
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

メモ

この戻り値オブジェクトとそのプロパティの詳細については、「SMS_TaskSequence_WMIConditionExpression WMI クラス」を参照してください。