New-CMTSStepApplyOperatingSystem

模組:

ConfigurationManager

建立 [套用 OS 映射 ] 步驟，您可以將它新增至任務順序。

Syntax

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>]

Description

此 Cmdlet 會建立新的套用 OS 映射 步驟物件。 然後使用 CMTaskSequenceStep Cmdlet，將步驟新增至任務順序。 如需此步驟的詳細資訊，請參閱 關於任務順序的步驟：套用 OS 映射。

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。

範例

範例 1

這個範例會先使用 CMOperatingSystemImage 指令程式來取得作業系統影像套件的物件。 它會將此物件儲存在 $osImgPkg 變數中。 下一個步驟會使用 $osImgPkg物件做為影像套件，為Apply 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

參數

-ConfigFileName

指定要用於自訂安裝的自動或 Sysprep 應答檔案的檔案名。 請將此參數與 ConfigFilePackage 參數搭配使用。

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

-ConfigFilePackage

指定包含要用於自訂安裝之自動或 Sysprep 答案檔案的 package 物件。 若要取得此物件，請使用 CMPackage Cmdlet。 請將此參數與 ConfigFileName 參數搭配使用。

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-DestinationDisk

使用時 -Destination SpecificDiskAndPartition ，請使用此參數指定磁片號碼。 指定從 to 的 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 ，請使用此參數指定分割區號碼。 指定從 to 的 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

-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 映射套件物件。 步驟會從這個影像套用作業系統。 使用 ImagePackageIndex 參數來設定影像索引。

若要取得此物件，請使用 CMOperatingSystemImage Cmdlet。

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 升級套件物件。 步驟會從此原始安裝來源套用作業系統。 使用 InstallPackageIndex 參數來設定 edition。

若要取得此物件，請使用 CMOperatingSystemInstaller Cmdlet。

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

-InstallPackageIndex

指定 OS 升級套件 edition 的整數值。 請將此參數與 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

-RunFromNet

將此參數設定為 $true 以允許任務順序直接從發佈點套用 OS 映射。

為了獲得最佳的安全性，建議不要啟用此設定。 此選項專為在具有有限儲存容量的裝置上使用而設計。 如需詳細資訊，請參閱 直接從發佈點存取內容。

Type:	Boolean
Aliases:	AllowAccessFromDistributionPoint
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。

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

-停用

新增此參數以停用此任務序列步驟。

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

-名稱

指定此步驟的名稱，以在任務順序中識別。

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

-條件

指定要與此步驟搭配使用的 condition 物件。 若要取得此物件，請使用其中一個工作順序條件 Cmdlet。 例如， CMTSStepConditionVariable。

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

-目的地

指定您要套用此作業系統的位置。 如果您未指定此參數，則預設值為 NextAvailableFormattedPartition 。

• NextAvailableFormattedPartition：使用此工作順序中的 [ Apply 作業系統 ] 或 [套用 資料影像 ] 步驟尚未設定的下一個連續分割區。

• SpecificDiskAndPartition：使用 DestinationDisk 參數指定磁片號碼，並使用 DestinationPartition 參數指定分割區編號。

• SpecificLogicalDriverLetter：使用DestinationDriveLetter參數，依 Windows PE，指定指派給磁碟分割的邏輯磁碟機號。 此磁碟機號可以與新部署的 OS 所指派的磁碟機號不同。

• LogicalDriverLetterInVariable：使用DestinationVariable參數，指定包含指派給分割區之磁碟機盤符的任務順序變數，Windows PE。 此變數通常是使用 CMTSStepPartitionDisk和分割磁片任務順序步驟的set-或CMTSStepPartitionDisk Cmdlet 的DiskNumberVariable參數來設定。

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

輸入

無

輸出

IResultObject

備註

如需此 return 物件及其屬性的詳細資訊，請參閱 SMS_TaskSequence_ApplyOperatingSystemAction SERVER WMI 類別。

相關連結

• CMTSStepApplyOperatingSystem
• Remove-CMTSStepApplyOperatingSystem
• CMTSStepApplyOperatingSystem
• 關於任務順序步驟：套用 OS 映射