New-CMTSStepConditionOperatingSystem

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

タスク シーケンス ステップの OS バージョン 条件を作成します。

構文

New-CMTSStepConditionOperatingSystem
   -SupportedPlatform <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

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

詳細については、「 タスク シーケンス エディターの使用: 条件」を参照してください。

注:

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

例

例 1

この例では、最初に Get-CMSupportedPlatform コマンドレットを使用して、Windows 10 および Windows 11 64 ビット クライアントを含むサポートされているプラットフォーム オブジェクトを作成します。 次に、そのオブジェクトを使用してタスク シーケンス ステップ条件オブジェクトを作成します。

次に、Set-CMTSStepSetDynamicVariable コマンドレットを使用して、この条件オブジェクトを既定の OS 展開タスク シーケンスの動的変数の設定ステップに追加します。

$osPlat = Get-CMSupportedPlatform -Name "*Windows 1? (64-bit) Client" -Fast

$condition = New-CMTSStepConditionOperatingSystem -SupportedPlatform $osPlat

$tsNameOsd = "Default OS deployment"
$tsStepNameDynVar = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsNameOsd -StepName $tsStepNameDynVar -AddCondition $condition

このサンプル スクリプトは、この手順で次の条件を作成します。

Operating System equals All Windows 10 (64-bit) Or All Windows 11 (64-bit)

パラメーター

-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

-SupportedPlatform

この条件でサポートされている 1 つ以上のプラットフォーム オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMSupportedPlatform コマンドレットを 使用します。

型:IResultObject[]
Aliases:SupportedPlatforms
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

IResultObject

メモ

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

OS 言語条件を作成するには、 New-CMTSStepConditionOperatingSystemLanguage コマンドレットを 使用します。