Get-CMTSStepPartitionDisk
从特定任务序列获取 “格式化磁盘和分区” 步骤。
语法
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>]
说明
使用此 cmdlet 获取 格式化和分区磁盘 步骤的一个或多个实例的任务序列步骤对象。 可以使用此对象来:
- 使用 Remove-CMTSStepPartitionDisk 从任务序列中删除步骤
- 使用 Add-CMTaskSequenceStep 将步骤复制到另一个任务序列
有关此步骤的详细信息,请参阅 关于任务序列步骤:格式化和分区磁盘。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 1:从任务序列获取步骤
此示例首先获取 $tsOsd 变量中的任务序列对象。 然后,它将该变量作为输入对象传递,以获取 “格式化和分区磁盘” 步骤。
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsStepNameFormatDisk = "Partition Disk 0 - UEFI"
$tsStepFormatDisk = Get-CMTSStepPartitionDisk -InputObject $tsOsd -StepName $tsStepNameFormatDisk
示例 2:查看步骤的分区设置详细信息
此示例基于上一个示例。 若要查看第一个分区设置,请引用 Partitions 属性,该属性是 SMS_TaskSequence_PartitionSettings 对象的数组。
$tsStepFormatDisk = Get-CMTSStepPartitionDisk -InputObject $tsOsd -StepName $tsStepNameFormatDisk
$tsStepFormatDisk.Partitions[0]
可以使用此过程在步骤或任务序列之间复制分区设置。 将此分区设置对象保存为变量,然后将其添加到另一个步骤。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-InputObject
指定要从中获取 “格式化和分区磁盘 ”步骤的任务序列对象。 若要获取此对象,请使用 Get-CMTaskSequence cmdlet。
类型: | IResultObject |
别名: | TaskSequence |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-StepName
指定要从任务序列获取的 格式化和分区磁盘 步骤的名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-TaskSequenceId
指定要从中获取格式化和分区磁盘步骤的任务序列的包 ID。 此值是标准包 ID,例如 XYZ00858
。
类型: | String |
别名: | Id, TaskSequencePackageId |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-TaskSequenceName
指定要从中获取 “格式化和分区磁盘 ”步骤的任务序列的名称。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object