Get-CMTSStepPartitionDisk

Module:

ConfigurationManager Module

Get the Format and Partition Disk step from a specific task sequence.

Get-CMTSStepPartitionDisk
 [-InputObject] <IResultObject>
 [-StepName <String>]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

Get-CMTSStepPartitionDisk
 [-TaskSequenceId] <String>
 [-StepName <String>]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

Get-CMTSStepPartitionDisk
 [-TaskSequenceName] <String>
 [-StepName <String>]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

Use this cmdlet to get a task sequence step object for one or more instances of the Format and Partition Disk step. You can use this object to:

• Remove the step from a task sequence with Remove-CMTSStepPartitionDisk
• Copy the step to another task sequence with Add-CMTaskSequenceStep

For more information on this step, see About task sequence steps: Format and Partition Disk.

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.

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsStepNameFormatDisk = "Partition Disk 0 - UEFI"
$tsStepFormatDisk = Get-CMTSStepPartitionDisk -InputObject $tsOsd -StepName $tsStepNameFormatDisk

This example builds on the previous example. To view the first partition settings, reference the Partitions property, which is an array of SMS_TaskSequence_PartitionSettings objects.

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