New-CMTSPartitionSetting

Module:

ConfigurationManager Module

Create a disk partition object to use with the Format and Partition Disk task sequence step.

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

This cmdlet creates a disk partition object to use with the Format and Partition Disk task sequence step. Use this cmdlet to define the partition settings, and then use that object with the -PartitionSetting parameter of the New-CMTSStepPartitionDisk or Set-CMTSStepPartitionDisk cmdlets.

You can create the following types of partition settings objects, based on the switch parameter that you use with this cmdlet:

• PartitionPrimary: Primary partition
• PartitionEfi EFI partition
• PartitionExtended: Extended partition
• PartitionHidden: Hidden partition
• PartitionLogical: Logical partition
• PartitionMsr: MSR partition
• PartitionRecovery: Recovery partition

If you don't specify a partition switch parameter, the cmdlet creates a primary partition settings object.

For more information, see Format and Partition Disk: Volume.

This example creates settings for an EFI partition that's 500 MB and saves it as the partEfi variable.

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

This example creates settings for an MSR partition that's 128 MB and saves it as the partMsr variable.

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

This example creates settings for a Windows primary partition and saves it as the partWin variable.

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

This example creates settings for a Recovery partition that's 100% of the remaining disk space and saves it as the partMsr variable.

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

This example first gets a task sequence object in the $tsOsd variable. It then passes that variable as the input object to get the Format and Partition Disk step.

Then to view the first partition settings, reference the Partitions property, which is an array of SMS_TaskSequence_PartitionSettings objects.

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

You can use this process to copy partition settings between steps or task sequences. Save this partition settings object as a variable and then add it to another step.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

For more information on this return object and its properties, see SMS_TaskSequence_PartitionSettings server WMI class.