New-CMTSStepPartitionDisk
建立 [格式化] 和 [磁碟分區 ] 步驟，您可以將其新增至工作順序。
語法
New-CMTSStepPartitionDisk
[-DiskNumber <Int32>]
[-DiskNumberVariable <String>]
[-DiskType <PartitionDiskStyle>]
[-IsBootDisk <Boolean>]
-PartitionSetting <IResultObject[]>
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
此 Cmdlet 會建立新的 Format 和 Partition Disk 步驟物件。 然後使用 Add-CMTaskSequenceStep Cmdlet 將步驟新增至工作順序。 如需此步驟的詳細資訊，請 參閱關於工作順序步驟：格式化和分割磁碟。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1
此範例會先建立四個數據分割設定物件，也就是 UEFI 磁碟的預設磁碟分區。
然後，它會使用 UEFI 磁碟的數據分割設定和其他一般組態，為 [格式化] 和 [磁碟分區 ] 步驟建立物件。
然後，它會取得工作順序物件，並將這個新步驟新增至索引 11 的工作順序。
$partEfi = New-CMTSPartitionSetting -Name "EFI" -PartitionEfi -Size 500 -SizeUnit MB
$partMsr = New-CMTSPartitionSetting -Name "MSR" -PartitionMsr -Size 128 -SizeUnit MB
$partWin = New-CMTSPartitionSetting -Name "Windows" -PartitionPrimary -Size 99 -SizeUnit Percent -EnableDriveLetterAssignment $true -EnableQuickFormat $true -PartitionFileSystem NTFS -IsBootPartition $true
$partRec = New-CMTSPartitionSetting -Name "Recovery" -PartitionRecovery -Size 100 -SizeUnit Percent
$step = New-CMTSStepPartitionDisk -Name "Partition Disk 0 - UEFI" -PartitionSetting @($partEfi,$partMsr,$partWin,$partRec) -DiskNumber 0 -DiskType Gpt -IsBootDisk $true
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11參數
-Condition
指定要與這個步驟搭配使用的條件物件。 若要取得這個物件，請使用其中一個工作順序條件 Cmdlet。 例如， Get-CMTSStepConditionVariable。
| 類型: | IResultObject[] |
| 別名: | Conditions |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ContinueOnError
新增此參數以啟用 [ 發生錯誤時繼續] 步驟選項。 當您啟用此選項時，如果步驟失敗，工作順序會繼續。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定此工作順序步驟的選擇性描述。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Disable
新增此參數以停用此工作順序步驟。
| 類型: | SwitchParameter |
| 別名: | DisableThisStep |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DiskNumber
為要格式化之磁碟的實體磁碟編號指定整數。 此數目是以 Windows 磁碟列舉順序為基礎。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DiskNumberVariable
適用於 2006 版和更新版本。 使用工作順序變數來指定要格式化的目標磁碟。 此變數選項支援具有動態行為的更複雜工作順序。 如需詳細資訊，請 參閱關於工作順序步驟 - 格式化和剖析磁碟。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DiskType
指定要格式化磁碟型態：
-
Mbr：主要開機記錄 -
Gpt：GUID 資料分割數據表
| 類型: | PartitionDiskStyle |
| 接受的值: | Mbr, Gpt |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-IsBootDisk
針對新的資料分割，請將此參數設定為 true ，使其成為開機分割區。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定此步驟的名稱，以在工作順序中識別它。
| 類型: | String |
| 別名: | StepName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PartitionSetting
指定數據分割設定物件的陣列。 若要取得此物件，請使用 New-CMTSPartitionSetting Cmdlet。
| 類型: | IResultObject[] |
| 別名: | PartitionSettings |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 它不會執行 Cmdlet。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
輸出
IResultObject
備註
如需這個傳回物件及其屬性的詳細資訊，請 參閱SMS_TaskSequence_PartitionDiskAction伺服器 WMI 類別。