New-CMTSStepApplyDataImage
建立 [ 套用資料映射 ] 步驟,您可以將其新增至工作順序。
Syntax
New-CMTSStepApplyDataImage
[-Destination <DestinationType>]
[-DestinationDisk <Int32>]
[-DestinationDriveLetter <String>]
[-DestinationPartition <Int32>]
[-DestinationVariable <String>]
-ImagePackage <IResultObject>
-ImagePackageIndex <Int32>
[-WipePartition <Boolean>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
此 Cmdlet 會建立新的 套用資料影像 步驟物件。 然後使用 Add-CMTaskSequenceStep Cmdlet 將步驟新增至工作順序。 如需此步驟的詳細資訊,請 參閱關於工作順序步驟:套用資料映射。
注意事項
從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1
此範例會先使用 Get-CMOperatingSystemImage Cmdlet 來取得資料映射套件的物件。 它會將這個物件儲存在 $pkgDataImg 變數中。 下一個步驟會使用$pkgDataImg 物件做為映射套件,為 [套用資料映射] 步驟建立 物件。
然後,它會取得工作順序物件,並將這個新步驟新增至索引 11 的工作順序。
$pkgDataImg = Get-CMOperatingSystemImage -Name "Data image"
$step = New-CMTSStepApplyDataImage -Name "Apply data image" -ImagePackage $pkgDataImg -ImagePackageIndex 1
$tsName = "Custom task sequence"
$ts = Get-CMTaskSequence -Name $tsName -Fast
$ts | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
參數
-Condition
指定要與這個步驟搭配使用的條件物件。 若要取得這個物件,請使用其中一個工作順序條件 Cmdlet。 例如, Get-CMTSStepConditionVariable。
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
新增此參數以啟用 [ 發生錯誤時繼續] 步驟選項。 當您啟用此選項時,如果步驟失敗,工作順序會繼續。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
指定此工作順序步驟的選擇性描述。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Destination
指定您要套用此資料影像的位置。 如果您未指定此參數,則預設值為 NextAvailableFormattedPartition
。
NextAvailableFormattedPartition
:使用此工作順序中[ 套用作業系統 ] 或 [ 套用資料映射 ] 步驟尚未設為目標的下一個循序資料分割。SpecificDiskAndPartition
:使用 DestinationDisk 參數指定磁片編號,並使用 DestinationPartition 參數指定分割區編號。SpecificLogicalDriverLetter
:使用 DestinationDriveLetter 參數來指定 Windows PE 指派給分割區的邏輯磁碟機號。 這個磁碟機號可以與新部署的 OS 所指派的磁碟機號不同。LogicalDriverLetterInVariable
:使用 DestinationVariable 參數來指定工作順序變數,其中包含 Windows PE 指派給磁碟分割的磁碟機號。 此變數通常是使用Set-CMTSStepPartitionDisk或New-CMTSStepPartitionDisk Cmdlet 的DiskNumberVariable參數來設定,以進行格式化和分割磁片工作順序步驟。
Type: | DestinationType |
Accepted values: | NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationDisk
當您使用 -Destination SpecificDiskAndPartition
時,請使用此參數來指定磁片編號。 指定從 0
到 99
的整數。 也請使用 DestinationPartition 參數。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationDriveLetter
當您使用 -Destination SpecificLogicalDriverLetter
時,請使用此參數來指定邏輯磁碟機號。 指定從 C
到 的 Z
磁碟機號。
Type: | String |
Aliases: | DestinationLogicalDrive |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationPartition
當您使用 -Destination SpecificDiskAndPartition
時,請使用此參數來指定分割區編號。 指定從 1
到 99
的整數。 也請使用 DestinationDisk 參數。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationVariable
當您使用 -Destination LogicalDriverLetterInVariable
時,請使用此參數來指定具有邏輯磁碟機號的工作順序變數。 變數名稱需要不含空格且少於 256 個字元的英數位元。
Type: | String |
Aliases: | DestinationVariableName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
新增此參數以停用此工作順序步驟。
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此參數會處理萬用字元,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImagePackage
指定資料映射套件物件。 此步驟會套用此影像中的資料。 使用 ImagePackageIndex 參數來設定影像索引。
若要取得此物件,請使用 Get-CMOperatingSystemImage Cmdlet。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImagePackageIndex
指定影像索引的整數值。 搭配 ImagePackage 參數使用此參數。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定此步驟的名稱,以在工作順序中識別它。
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WipePartition
預設會啟用此設定,這會先刪除分割區上的所有內容,再套用影像。
將此參數設定為 $false
,以不刪除資料分割的先前內容。 此動作可用來將更多內容套用至先前的目標分割區。
Type: | Boolean |
Aliases: | WipePartitionBeforeApplyImage |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
None
輸出
IResultObject
備註
如需這個傳回物件及其屬性的詳細資訊,請 參閱SMS_TaskSequence_ApplyDataImageAction伺服器 WMI 類別。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應