New-CMTSPartitionSetting

參考

模組:: ConfigurationManager

建立磁碟分區物件，以搭配 [格式化] 和 [磁碟分區 ] 工作順序步驟使用。

語法

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 來定義數據分割設定，然後搭配 New-CMTSStepPartitionDisk 或 Set-CMTSStepPartitionDisk Cmdlet 的 -PartitionSetting 參數使用該物件。

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

PartitionPrimary：主要分割區
PartitionEfi EFI 磁碟分區
PartitionExtended：擴充的數據分割
PartitionHidden：隱藏的數據分割
PartitionLogical：邏輯分割區
PartitionMsr： MSR 分割區
PartitionRecovery：復原分割區

如果您未指定分割區參數，此 Cmdlet 會建立主要數據分割設定物件。

如需詳細資訊，請參閱格式化和分割磁碟：磁碟區。

範例

範例 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 變數中的工作順序物件。然後，它會將該變數傳遞為輸入物件，以取得 [格式化] 和 [磁碟分區 ] 步驟。

然後，若要檢視第一個數據分割設定，請參考 Partitions 屬性，這是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 之前提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。您無法將其與 ForceWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableDriveLetterAssignment

將此參數設定為， true 讓 Configuration Manager 將驅動器號指派給磁碟分區。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableQuickFormat

將此參數設定為， true 讓 Configuration Manager 執行數據分割的快速格式。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。您無法將其與 DisableWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IsBootPartition

將此參數設定為， true 讓此分割區成為開機數據分割。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

指定數據分割的名稱。

類型:	String
別名:	PartitionName, VolumeName
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PartitionEfi

新增此參數，使數據分割類型成為 EFI。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PartitionExtended

新增此參數，使數據分割類型成為 Extended。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PartitionFileSystem

指定要格式化資料分割的檔案系統。

類型:	FileSystemType
接受的值:	Ntfs, Fat32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PartitionHidden

新增此參數，讓數據分割類型成為 Hidden。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PartitionLogical

新增此參數，使數據分割類型成為邏輯。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PartitionMsr

新增此參數，使數據分割類型成為 MSR。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PartitionPrimary

新增此參數，使數據分割類型成為 Primary。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PartitionRecovery

新增此參數，讓數據分割類型成為 Recovery。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Size

指定數據分割大小的整數值。使用此參數搭配 -SizeUnit 參數。如果 -SizeUnit 為 Percent，則為此參數指定介於 1-100 之間的數位。如果 -SizeUnit 是 MB 或 GB，請指定特定數據分割大小的數位。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SizeUnit

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

Percent：使用 -Size 將磁碟分區設定為磁碟上剩餘可用空間的百分比。
MB 或 GB：使用 -Size 來設定資料分割的特定大小。

類型:	SizeUnitType
接受的值:	MB, GB, Percent
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Variable

根據預設，Configuration Manager 會將下一個可用的驅動器號指派給這個磁碟分區。若要儲存此驅動器號以供日後使用，請使用此參數設定自定義工作順序變數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

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

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出

IResultObject

備註

如需此傳回物件及其屬性的詳細資訊，請參閱SMS_TaskSequence_PartitionSettings伺服器 WMI 類別。

共用方式為

New-CMTSPartitionSetting

語法

Description

範例

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

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

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

範例 4：建立復原數據分割的設定

範例 5：檢視步驟的數據分割設定詳細數據

參數

-Confirm

-DisableWildcardHandling

-EnableDriveLetterAssignment

-EnableQuickFormat

-ForceWildcardHandling

-IsBootPartition

-Name

-PartitionEfi

-PartitionExtended

-PartitionFileSystem

-PartitionHidden

-PartitionLogical

-PartitionMsr

-PartitionPrimary

-PartitionRecovery

-Size

-SizeUnit

-Variable

-WhatIf

輸入

輸出

備註

意見反應

其他資源

共用方式為

New-CMTSPartitionSetting

語法

Description

範例

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

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

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

範例 4：建立復原數據分割的設定

範例 5：檢視步驟的數據分割設定詳細數據

參數

-Confirm

-DisableWildcardHandling

-EnableDriveLetterAssignment

-EnableQuickFormat

-ForceWildcardHandling

-IsBootPartition

-Name

-PartitionEfi

-PartitionExtended

-PartitionFileSystem

-PartitionHidden

-PartitionLogical

-PartitionMsr

-PartitionPrimary

-PartitionRecovery

-Size

-SizeUnit

-Variable

-WhatIf

輸入

輸出

備註

相關連結

意見反應

其他資源