New-CMTSStepApplyDataImage
创建可添加到任务序列 的“应用数据映像 ”步骤。
语法
New-CMTSStepApplyDataImage
[-Destination <DestinationType>]
[-DestinationDisk <Int32>]
[-DestinationDriveLetter <String>]
[-DestinationPartition <Int32>]
[-DestinationVariable <String>]
-ImagePackage <IResultObject>
-ImagePackageIndex <Int32>
[-WipePartition <Boolean>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
此 cmdlet 将创建新的 “应用数据映像” 步骤对象。 然后使用 Add-CMTaskSequenceStep cmdlet 将步骤添加到任务序列。 有关此步骤的详细信息，请参阅 关于任务序列步骤：应用数据映像。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1
此示例首先使用 Get-CMOperatingSystemImage cmdlet 获取数据映像包的对象。 它将此对象保存在 $pkgDataImg 变量中。 下一步使用 $pkgDataImg 对象作为映像包，为“应用数据映像”步骤创建对象。
然后，它获取任务序列对象，并将此新步骤添加到索引 11 处的任务序列。
$pkgDataImg = Get-CMOperatingSystemImage -Name "Data image"
$step = New-CMTSStepApplyDataImage -Name "Apply data image" -ImagePackage $pkgDataImg -ImagePackageIndex 1
$tsName = "Custom task sequence"
$ts = Get-CMTaskSequence -Name $tsName -Fast
$ts | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11参数
-Condition
指定要用于此步骤的条件对象。 若要获取此对象，请使用任务序列条件 cmdlet 之一。 例如 Get-CMTSStepConditionVariable。
| 类型: | IResultObject[] |
| 别名: | Conditions |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ContinueOnError
添加此参数以启用步骤选项“ 出错时继续”。 启用此选项时，如果步骤失败，任务序列将继续。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
为此任务序列步骤指定可选说明。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Destination
指定要应用此数据图像的位置。 如果未指定此参数，则默认值为 NextAvailableFormattedPartition。
NextAvailableFormattedPartition：使用此任务序列中的 “应用操作系统” 或 “应用数据映像 ”步骤尚未面向的下一个顺序分区。SpecificDiskAndPartition：使用 DestinationDisk 参数指定磁盘编号，使用 DestinationPartition 参数指定分区号。SpecificLogicalDriverLetter：使用 DestinationDriveLetter 参数指定由 Windows PE 分配给分区的逻辑驱动器号。 此驱动器号可以不同于新部署的 OS 分配的驱动器号。LogicalDriverLetterInVariable：使用 DestinationVariable 参数指定包含 Windows PE 分配给分区的驱动器号的任务序列变量。 此变量通常使用 Set-CMTSStepPartitionDisk 或 New-CMTSStepPartitionDisk cmdlet 的 DiskNumberVariable 参数设置，用于格式化和分区磁盘任务序列步骤。
| 类型: | DestinationType |
| 接受的值: | NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DestinationDisk
使用 -Destination SpecificDiskAndPartition时，使用此参数指定磁盘编号。 指定从 0 到 的 99整数。 另请使用 DestinationPartition 参数。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DestinationDriveLetter
使用 -Destination SpecificLogicalDriverLetter时，请使用此参数指定逻辑驱动器号。 指定从 C 到 Z的驱动器号。
| 类型: | String |
| 别名: | DestinationLogicalDrive |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DestinationPartition
使用 -Destination SpecificDiskAndPartition时，请使用此参数指定分区号。 指定从 1 到 的 99整数。 另请使用 DestinationDisk 参数。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DestinationVariable
使用 -Destination LogicalDriverLetterInVariable时，使用此参数使用逻辑驱动器号指定任务序列变量。 变量名称需要不带空格且少于 256 个字符的字母数字。
| 类型: | String |
| 别名: | DestinationVariableName |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Disable
添加此参数以禁用此任务序列步骤。
| 类型: | SwitchParameter |
| 别名: | DisableThisStep |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ImagePackage
指定数据图像包对象。 此步骤应用此图像中的数据。 使用 ImagePackageIndex 参数设置图像索引。
若要获取此对象，请使用 Get-CMOperatingSystemImage cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ImagePackageIndex
指定图像索引的整数值。 将此参数与 ImagePackage 参数一起使用。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定此步骤的名称，以便在任务序列中标识它。
| 类型: | String |
| 别名: | StepName |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WipePartition
默认情况下启用此设置，这会在应用映像之前删除分区上的所有内容。
将此参数设置为 $false 不删除分区的先前内容。 此操作可用于将更多内容应用于以前的目标分区。
| 类型: | Boolean |
| 别名: | WipePartitionBeforeApplyImage |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
IResultObject
备注
有关此返回对象及其属性的详细信息，请参阅 SMS_TaskSequence_ApplyDataImageAction服务器 WMI 类。