New-CMTSPartitionSetting

模块:

ConfigurationManager

创建磁盘分区对象以用于 Format and Partition Disk 任务序列步骤。

语法

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

说明

此 cmdlet 创建磁盘分区对象以用于 "格式化和分区磁盘" 任务序列步骤。 使用此 cmdlet 定义分区设置，然后将该对象与New-CMTSStepPartitionDisk或Set-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 and Partition Disk 步骤。

然后，若要查看第一个分区设置，请引用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 之前进行确认。

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

添加此参数使分区类型为 Logical。

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

添加此参数使分区类型为 Primary。

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 或 GB ，请为特定分区大小指定一个数字。

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

-SizeUnit

指定大小的单位类型。 此参数与 -Size 参数 一同使用。

• Percent：使用 -Size 将分区设置为磁盘上剩余可用空间的百分比。

• MB``GB或 ：使用 -Size设置分区的特定大小。

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

备注

有关此返回对象及其属性的信息，请参阅SMS_TaskSequence_PartitionSettings WMI 类。

相关链接

• Get-CMTSStepPartitionDisk
• New-CMTSStepPartitionDisk
• Set-CMTSStepPartitionDisk
• 关于任务序列步骤 - 格式化和分区磁盘
• 基于 UEFI/GPT 的硬盘驱动器分区
• 基于 BIOS/MBR 的硬盘驱动器分区