New-CMTSPartitionSetting

模組:

ConfigurationManager

建立磁碟分割物件，以搭配 格式化及分割磁片 的任務順序步驟使用。

Syntax

New-CMTSPartitionSetting
   [-EnableDriveLetterAssignment <Boolean>]
   [-EnableQuickFormat <Boolean>]
   [-IsBootPartition <Boolean>]
   [-Name <String>]
   [-PartitionFileSystem <FileSystemType>]
   [-PartitionPrimary]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-Variable <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionEfi]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionExtended]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionHidden]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionLogical]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionMsr]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTSPartitionSetting
   [-Name <String>]
   [-PartitionRecovery]
   [-Size <Int32>]
   [-SizeUnit <SizeUnitType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

這個 Cmdlet 會建立磁碟分割物件，以用於 格式化及分割磁片 任務順序步驟。 使用此 Cmdlet 來定義分割區設定，然後使用該物件與CMTSStepPartitionDisk或CMTSStepPartitionDisk Cmdlet 的 -PartitionSetting參數。

您可以根據您搭配此 Cmdlet 使用的 switch 參數，來建立下列類型的磁碟分割設定物件：

• PartitionPrimary：主要分割區
• PartitionEfi EFI 分割區
• PartitionExtended：擴充分割區
• PartitionHidden：隱藏分割區
• PartitionLogical：邏輯分割區
• PartitionMsr： MSR 分割區
• PartitionRecovery：復原分割區

如果您未指定分區切換參數，Cmdlet 會建立主要磁碟分割設定物件。

如需詳細資訊，請參閱 Format And Partition Disk： Volume。

範例

範例1：建立 EFI 分割區的設定

這個範例會建立500 MB的EFI分割區的設定，並將其儲存為partEfi變數。

$partEfi = New-CMTSPartitionSetting -Name "EFI" -PartitionEfi -Size 500 -SizeUnit MB

範例2：建立 MSR 磁碟分割的設定

這個範例會建立128 MB的MSR分割區的設定，並將它儲存為partMsr變數。

$partMsr = New-CMTSPartitionSetting -Name "MSR" -PartitionMsr -Size 128 -SizeUnit MB

範例3：建立 Windows 主要分割區的設定

這個範例會建立Windows主要分割區的設定，並將它儲存為partWin變數。

$partWin = New-CMTSPartitionSetting -Name "Windows" -PartitionPrimary -Size 99 -SizeUnit Percent -EnableDriveLetterAssignment $true -EnableQuickFormat $true -PartitionFileSystem NTFS -IsBootPartition $true

範例4：建立修復分割區的設定

此範例會建立 復原分割區的設定 ，其為剩餘磁碟空間的 100% ，並將其儲存為 partMsr 變數。

$partRec = New-CMTSPartitionSetting -Name "Recovery" -PartitionRecovery -Size 100 -SizeUnit Percent

範例5：查看步驟的磁碟分割設定詳細資料

這個範例會先在 $tsOsd 變數中取得任務順序物件。 然後，它會將該變數當做輸入物件，以取得 Format 和分割磁片 步驟。

然後，若要查看第一個分割區設定，請參照 partition 屬性，該屬性 是 SMS_TaskSequence_PartitionSettings 物件的陣列。

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsStepNameFormatDisk = "Partition Disk 0 - UEFI"
$tsStepFormatDisk = Get-CMTSStepPartitionDisk -InputObject $tsOsd -StepName $tsStepNameFormatDisk

$tsStepFormatDisk.Partitions[0]

您可以使用此程式來複製步驟或任務順序之間的磁碟分割設定。 將此分割區設定物件儲存為變數，然後將它新增至另一個步驟。

參數

-Confirm

執行 Cmdlet 之前提示您確認。

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

-EnableDriveLetterAssignment

將此參數設定為 true ，讓 Configuration Manager 將磁碟機號指派給磁碟分割。

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

-EnableQuickFormat

將此參數設定為 true ，可讓 Configuration Manager 快速格式化磁碟分割。

Type:	Boolean
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

-IsBootPartition

將此參數設為， true 使此分割區成為啟動分割區。

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

-PartitionEfi

新增此參數可使磁碟分割類型成為 EFI。

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

-PartitionExtended

新增此參數可將分割區類型 擴充。

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

-PartitionFileSystem

指定用來格式化磁碟分割的檔案系統。

Type:	FileSystemType
Accepted values:	Ntfs, Fat32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionHidden

新增此參數可使磁碟分割類型 隱藏。

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

-PartitionLogical

新增此參數使磁碟分割類型成為 邏輯。

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

-PartitionMsr

新增此參數可使分割區類型成為 MSR。

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

-PartitionPrimary

新增此參數使分割區類型成為 主要。

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

-PartitionRecovery

新增此參數可讓分割 區類型復原。

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

-Size

指定磁碟分割大小的整數值。 請將此參數與 -SizeUnit 參數搭配使用。 如果 -SizeUnit 是 Percent ，請為此參數指定1-100 之間的數位。 若 -SizeUnit 為 MB or GB ，請指定特定分割區大小的數位。

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

-SizeUnit

指定大小的單位類型。 請將此參數與 -Size 參數搭配使用。

• Percent：使用 大小 設定磁碟分割的剩餘可用空間百分比。

• MB 或 GB ：使用 大小 以設定磁碟分割的特定大小。

Type:	SizeUnitType
Accepted values:	MB, GB, Percent
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Variable

依預設，Configuration Manager 會將下一個可用的磁碟機號指派至此磁碟分割。 若要儲存此磁碟機號以供日後使用，使用此參數設定自訂任務序列變數。

Type:	String
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:	String
Aliases:	PartitionName, VolumeName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

無

輸出

IResultObject

備註

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

相關連結

• CMTSStepPartitionDisk
• 新 CMTSStepPartitionDisk
• CMTSStepPartitionDisk
• 關於任務順序步驟-格式及分割磁片
• UEFI/GPT 磁片磁碟機分割區
• BIOS/MBR 磁碟磁片磁碟機分割區