New-CMTSStepApplyOperatingSystem

モジュール:

ConfigurationManager

タスク シーケンス に追加できる [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>]

説明

このコマンドレットは、新しい [OS イメージの適用] ステップ オブジェクトを 作成します。 次に 、Add-CMTaskSequenceStep コマンドレットを使用して、手順をタスク シーケンスに追加します。 この手順の詳細については、「タスク シーケンスの手順 について:OS イメージを適用する」を参照してください。

注意

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

例

例 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 です。

Type:	IResultObject[]
Aliases:	Conditions
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ConfigFileName

カスタム インストールに使用する無人応答ファイルまたは Sysprep 応答ファイルのファイル名を指定します。 ConfigFilePackage パラメーターと一緒 にこのパラメーターを使用 します。

Type:	String
Aliases:	AnswerFileName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ConfigFilePackage

カスタム インストールに使用する無人応答ファイルまたは Sysprep 応答ファイルを含むパッケージ オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMPackage コマンドレットを使用 します。 ConfigFileName パラメーターと一緒 にこのパラメーターを使用 します。

Type:	IResultObject
Aliases:	AnswerFilePackage
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinueOnError

このパラメーターを追加して、エラー時にステップ オプション [続行] を有効にします。 このオプションを有効にすると、手順が失敗した場合、タスク シーケンスは続行されます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

このタスク シーケンス ステップのオプションの説明を指定します。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Destination

この OS を適用する場所を指定します。 このパラメーターを指定しない場合、既定値は NextAvailableFormattedPartition .

• NextAvailableFormattedPartition: このタスク シーケンスで、[オペレーティング システム**** の適用]**** または [データ イメージの適用] ステップによって対象とされていない次のシーケンシャル パーティションを使用します。

• SpecificDiskAndPartition: DestinationDisk パラメーターを使用してディスク番号を 指定し、DestinationPartition パラメーターを使用して パーティション番号を指定 します。

• SpecificLogicalDriverLetter: DestinationDriveLetter パラメーターを使用して、PE によってパーティションに割り当てられた論理ドライブ文字Windowsします。 このドライブ文字は、新しく展開された OS によって割り当てられたドライブ文字とは異なる場合があります。

• LogicalDriverLetterInVariable: DestinationVariable パラメーターを使用して、PE によってパーティションに割り当てられたドライブ文字を含むタスク シーケンス変数Windowsします。 この変数は、通常、Set-CMTSStepPartitionDiskコマンドレットまたはNew-CMTSStepPartitionDiskコマンドレットのDiskNumberVariableパラメーターを使用して、Format および Partition Diskタスク シーケンス ステップで設定されます。

Type:	DestinationType
Accepted values:	NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DestinationDisk

使用する場合は -Destination SpecificDiskAndPartition 、このパラメーターを使用してディスク番号を指定します。 ~ の整数を指定 0 します 99 。 DestinationPartition パラメーターも使用します。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DestinationDriveLetter

使用する場合 -Destination SpecificLogicalDriverLetter は、このパラメーターを使用して論理ドライブ文字を指定します。 からドライブ文字を指定 C します Z 。

Type:	String
Aliases:	DestinationLogicalDrive
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DestinationPartition

使用する場合は -Destination SpecificDiskAndPartition 、このパラメーターを使用してパーティション番号を指定します。 ~ の整数を指定 1 します 99 。 DestinationDisk パラメーター も使用 します。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DestinationVariable

使用する場合 -Destination LogicalDriverLetterInVariable は、このパラメーターを使用して、論理ドライブ文字でタスク シーケンス変数を指定します。 変数名は、スペースを使用せず、256 文字未満の英数字にする必要があります。

Type:	String
Aliases:	DestinationVariableName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Disable

このパラメーターを追加して、このタスク シーケンス ステップを無効にします。

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

-ImagePackage

OS イメージ パッケージ オブジェクトを指定します。 この手順では、このイメージから OS を適用します。 ImagePackageIndex パラメーターを使用して、イメージ インデックスを設定します。

このオブジェクトを取得するには 、Get-CMOperatingSystemImage コマンドレットを使用 します。

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ImagePackageIndex

イメージ インデックスの整数値を指定します。 ImagePackage パラメーターと一緒 にこのパラメーターを使用 します。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallPackage

OS アップグレード パッケージ オブジェクトを指定します。 この手順では、この元のインストール ソースから OS を適用します。 InstallPackageIndex パラメーターを使用してエディションを設定します。

このオブジェクトを取得するには 、Get-CMOperatingSystemInstaller コマンドレットを使用 します。

Type:	IResultObject
Aliases:	UpgradePackage
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallPackageIndex

OS アップグレード パッケージ エディションの整数値を指定します。 InstallPackage パラメーターと一緒 にこのパラメーターを使用 します。

Type:	Int32
Aliases:	UpgradePackageIndex
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LayeredDriver

バージョン 2107 から、このパラメーターを使用して、日本語および韓国語に共通する他の種類のキーボードを選択します。 レイヤードライバーを使用してインストールする整数値を指定Windows。 OsdLayeredDriverタスク シーケンス変数と同じ値を使用します。

Type:	OsdLayeredDriver
Aliases:	KeyboardDriver
Accepted values:	DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

タスク シーケンスで識別するには、この手順の名前を指定します。

Type:	String
Aliases:	StepName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunFromNet

タスク シーケンスが配布ポイントから直接 OS イメージを適用するには、この $true パラメーターを設定します。

セキュリティを強化するために、この設定を有効にしない方が推奨されます。 このオプションは、ストレージ容量が制限されているデバイスで使用するように設計されています。 詳細については、「Access content from the distribution point 」を参照してください。

Type:	Boolean
Aliases:	AllowAccessFromDistributionPoint
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_ApplyOperatingSystemAction WMI クラス」を参照してください。

関連リンク

• Get-CMTSStepApplyOperatingSystem
• Remove-CMTSStepApplyOperatingSystem
• Set-CMTSStepApplyOperatingSystem
• タスク シーケンスの手順について: [OS イメージの適用]