New-CMTSPartitionSetting

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

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.

Examples

Example 1: Create settings for an EFI partition

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

Example 2: Create settings for an MSR partition

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

Example 3: Create settings for a Windows primary partition

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

Example 4: Create settings for a recovery partition

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

Example 5: View the partition setting details for a step

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.

Parameters

-Confirm

-DisableWildcardHandling

-EnableDriveLetterAssignment

-EnableQuickFormat

-ForceWildcardHandling

-IsBootPartition

-Name

-PartitionEfi

-PartitionExtended

-PartitionFileSystem

-PartitionHidden

-PartitionLogical

-PartitionMsr

-PartitionPrimary

-PartitionRecovery

-Size

-SizeUnit

-Variable

-WhatIf

Inputs

None

Outputs

IResultObject

Notes

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

Related Links

• Get-CMTSStepPartitionDisk
• New-CMTSStepPartitionDisk
• Set-CMTSStepPartitionDisk
• About task sequence steps - Format and Partition Disk
• UEFI/GPT-based hard drive partitions
• BIOS/MBR-based hard drive partitions