New-CMTSPartitionSetting
创建用于 格式化和分区磁盘 任务序列步骤的磁盘分区对象。
语法
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 将创建主分区设置对象。
有关详细信息，请参阅 格式化和分区磁盘：卷。
示例
示例 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
添加此参数以使分区类型 扩展。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-PartitionFileSystem
指定要设置分区格式的文件系统。
| 类型: | FileSystemType |
| 接受的值: | Ntfs, Fat32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PartitionHidden
添加此参数以使分区类型 隐藏。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-PartitionLogical
添加此参数以使分区类型为 Logical。
| 类型: | 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
添加此参数以使 分区类型恢复。
| 类型: | 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 类。