Get-CMTSStepConditionVariable
タスク シーケンス ステップからタスク シーケンス変数の条件を取得します。
構文
Get-CMTSStepConditionVariable
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
説明
タスク シーケンス ステップから タスク シーケンス変数 条件オブジェクトを取得するには、このコマンドレットを使用します。 このオブジェクトを使用すると、次のことができます。
- 手順で条件の詳細を表示します。
- 条件を別のタスク シーケンス ステップにコピーします。
New-CMTSStep* または Set-CMTSStep* コマンドレットを使用する場合は、この条件オブジェクトに Condition パラメーターまたは AddCondition パラメーターを指定します。 たとえば、 Set-CMTSStepApplyDataImage です。
詳細については、「 タスク シーケンス エディターの使用: 条件」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 変数条件の詳細を表示する
この例では、最初に 既定の OS 展開 タスク シーケンスを取得し、[ Windows PE で再起動する] 手順を取得します。 タスク シーケンス ステップ オブジェクトをこのコマンドレットに渡して、条件の詳細を表示します。
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsStepNameRestart = "Restart in Windows PE"
$tsStepRestart = Get-CMTSStepReboot -InputObject $tsOsd -StepName $tsStepNameRestart
Get-CMTSStepConditionVariable -InputObject $tsStepRestart
SmsProviderObjectPath : SMS_TaskSequence_VariableConditionExpression
Operator : equals
Value : false
Variable : _SMSTSInWinPE
例 2: 条件を別のステップにコピーする
この例では、最初に 既定の OS 展開 タスク シーケンスを取得し、[ Windows PE で再起動する] 手順を取得します。 タスク シーケンス ステップ オブジェクトをこのコマンドレットに渡し、オブジェクトを $condition 変数に保存します。
次に、 Set-CMTSStepSetVariable コマンドレットと AddCondition パラメーターを使用して、この同じ条件を タスク シーケンス変数の設定 ステップに追加します。
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsStepNameRestart = "Restart in Windows PE"
$tsStepRestart = Get-CMTSStepReboot -InputObject $tsOsd -StepName $tsStepNameRestart
$condition = Get-CMTSStepConditionVariable -InputObject $tsStepRestart
$tsStepNameSetTSVar = "Set Task Sequence Variable"
Set-CMTSStepSetVariable -TaskSequenceName $tsNameOsd -StepName $tsStepNameSetTSVar -AddCondition $condition
パラメーター
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
変数条件を持つタスク シーケンス ステップ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMTSStep コマンドレットのいずれかを使用します。 たとえば、 Get-CMTSStepApplyDataImage です。
型: | IResultObject |
Aliases: | TaskSequenceStep |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject[]
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_VariableConditionExpression」を参照してください。