New-CMTSStepApplyOperatingSystem
タスク シーケンスに追加できる [OS イメージの適用 ] ステップを作成します。
構文
New-CMTSStepApplyOperatingSystem
[-ConfigFileName <String>]
[-ConfigFilePackage <IResultObject>]
[-Destination <DestinationType>]
[-DestinationDisk <Int32>]
[-DestinationDriveLetter <String>]
[-LayeredDriver <OsdLayeredDriver>]
[-DestinationPartition <Int32>]
[-DestinationVariable <String>]
[-ImagePackage <IResultObject>]
[-ImagePackageIndex <Int32>]
[-InstallPackage <IResultObject>]
[-InstallPackageIndex <Int32>]
[-RunFromNet <Boolean>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットは、新しい Apply OS Image ステップ オブジェクトを作成します。 次に、 Add-CMTaskSequenceStep コマンドレットを使用して、タスク シーケンスにステップを追加します。 この手順の詳細については、「 タスク シーケンスの手順について: OS イメージを適用する」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1
この例では、最初に Get-CMOperatingSystemImage コマンドレットを使用して、OS イメージ パッケージのオブジェクトを取得します。 このオブジェクトは 、$osImgPkg 変数に保存されます。 次の手順では、$osImgPkg オブジェクトをイメージ パッケージとして使用して、OS イメージの適用ステップのオブジェクトを作成します。
次に、タスク シーケンス オブジェクトを取得し、インデックス 11 のタスク シーケンスにこの新しいステップを追加します。
$osImgPkg = Get-CMOperatingSystemImage -Name "OSImagePkg01"
$step = New-CMTSStepApplyOperatingSystem -Name "Apply OS image" -ImagePackage $osImgPkg -ImagePackageIndex 1
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11パラメーター
-Condition
この手順で使用する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば、 Get-CMTSStepConditionVariable です。
| 型: | IResultObject[] |
| Aliases: | Conditions |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ConfigFileName
カスタム インストールに使用する無人応答ファイルまたは Sysprep 応答ファイルのファイル名を指定します。 ConfigFilePackage パラメーターでこのパラメーターを使用します。
| 型: | String |
| Aliases: | AnswerFileName |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ConfigFilePackage
カスタム インストールに使用する無人応答ファイルまたは Sysprep 応答ファイルを含むパッケージ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMPackage コマンドレットを使用します。 ConfigFileName パラメーターでこのパラメーターを使用します。
| 型: | IResultObject |
| Aliases: | AnswerFilePackage |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ContinueOnError
このパラメーターを追加して、ステップ オプション [ エラー時に続行] を有効にします。 このオプションを有効にすると、ステップが失敗した場合、タスク シーケンスは続行されます。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
このタスク シーケンス ステップの説明 (省略可能) を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Destination
この OS を適用する場所を指定します。 このパラメーターを指定しない場合、既定値は NextAvailableFormattedPartition。
NextAvailableFormattedPartition: このタスク シーケンスの [オペレーティング システムの適用] ステップまたは [ データ イメージの適用] ステップの対象とされていない次のシーケンシャル パーティションを使用します。SpecificDiskAndPartition: DestinationDisk パラメーターを使用してディスク番号を指定し、 DestinationPartition パラメーターを使用してパーティション番号を指定します。SpecificLogicalDriverLetter: DestinationDriveLetter パラメーターを使用して、Windows PE によってパーティションに割り当てられた論理ドライブ文字を指定します。 このドライブ文字は、新しくデプロイされた OS によって割り当てられたドライブ文字とは異なる場合があります。LogicalDriverLetterInVariable: DestinationVariable パラメーターを使用して、Windows PE によってパーティションに割り当てられたドライブ文字を含むタスク シーケンス変数を指定します。 この変数は、通常、Set-CMTSStepPartitionDisk または New-CMTSStepPartitionDisk コマンドレットの DiskNumberVariable パラメーターを使用して、フォーマットおよびパーティション ディスクタスク シーケンス ステップに設定されます。
| 型: | DestinationType |
| 指定可能な値: | NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DestinationDisk
-Destination SpecificDiskAndPartitionを使用する場合は、このパラメーターを使用してディスク番号を指定します。
0から99までの整数を指定します。
DestinationPartition パラメーターも使用します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DestinationDriveLetter
-Destination SpecificLogicalDriverLetterを使用する場合は、このパラメーターを使用して論理ドライブ文字を指定します。
CからZまでのドライブ文字を指定します。
| 型: | String |
| Aliases: | DestinationLogicalDrive |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DestinationPartition
-Destination SpecificDiskAndPartitionを使用する場合は、このパラメーターを使用してパーティション番号を指定します。
1から99までの整数を指定します。
DestinationDisk パラメーターも使用します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DestinationVariable
-Destination LogicalDriverLetterInVariableを使用する場合は、このパラメーターを使用して、論理ドライブ文字を使用してタスク シーケンス変数を指定します。 変数名は、スペースを含まず、256 文字未満の英数字にする必要があります。
| 型: | String |
| Aliases: | DestinationVariableName |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Disable
このタスク シーケンス ステップを無効にするには、このパラメーターを追加します。
| 型: | SwitchParameter |
| Aliases: | DisableThisStep |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ImagePackage
OS イメージ パッケージ オブジェクトを指定します。 この手順では、このイメージから OS を適用します。 ImagePackageIndex パラメーターを使用して、イメージ インデックスを設定します。
このオブジェクトを取得するには、 Get-CMOperatingSystemImage コマンドレットを 使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ImagePackageIndex
イメージ インデックスの整数値を指定します。 ImagePackage パラメーターでこのパラメーターを使用します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InstallPackage
OS アップグレード パッケージ オブジェクトを指定します。 この手順では、この元のインストール ソースから OS を適用します。 InstallPackageIndex パラメーターを使用して、エディションを設定します。
このオブジェクトを取得するには、 Get-CMOperatingSystemInstaller コマンドレットを 使用します。
| 型: | IResultObject |
| Aliases: | UpgradePackage |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InstallPackageIndex
OS アップグレード パッケージ エディションの整数値を指定します。 InstallPackage パラメーターでこのパラメーターを使用します。
| 型: | Int32 |
| Aliases: | UpgradePackageIndex |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LayeredDriver
バージョン 2107 以降では、このパラメーターを使用して、日本語と韓国語の言語に共通する他の種類のキーボードを選択します。 Windows でインストールする階層化ドライバーの整数値を指定します。 OsdLayeredDriver タスク シーケンス変数と同じ値を使用します。
| 型: | OsdLayeredDriver |
| Aliases: | KeyboardDriver |
| 指定可能な値: | DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
この手順の名前を指定して、タスク シーケンスで識別します。
| 型: | String |
| Aliases: | StepName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunFromNet
タスク シーケンスが配布ポイントから OS イメージを直接適用できるようにするには、このパラメーターを $true に設定します。
セキュリティを最大限に高めるために、この設定を有効にしないことをお勧めします。 このオプションは、ストレージ容量が限られているデバイスで使用するように設計されています。 詳細については、「 配布ポイントからコンテンツに直接アクセスする」を参照してください。
| 型: | Boolean |
| Aliases: | AllowAccessFromDistributionPoint |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_ApplyOperatingSystemAction」を参照してください。