New-CMTSStepApplyDataImage

模块:

ConfigurationManager

创建可添加到任务序列 的“应用数据映像 ”步骤。

语法

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。

Type:	IResultObject[]
Aliases:	Conditions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinueOnError

添加此参数以启用步骤选项“ 出错时继续”。 启用此选项时，如果步骤失败，任务序列将继续。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

为此任务序列步骤指定可选说明。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Destination

指定要应用此数据图像的位置。 如果未指定此参数，则默认值为 NextAvailableFormattedPartition。

• NextAvailableFormattedPartition：使用此任务序列中的 “应用操作系统” 或 “应用数据映像 ”步骤尚未面向的下一个顺序分区。

• SpecificDiskAndPartition：使用 DestinationDisk 参数指定磁盘编号，使用 DestinationPartition 参数指定分区号。

• SpecificLogicalDriverLetter：使用 DestinationDriveLetter 参数指定由 Windows PE 分配给分区的逻辑驱动器号。 此驱动器号可以不同于新部署的 OS 分配的驱动器号。

• LogicalDriverLetterInVariable：使用 DestinationVariable 参数指定包含 Windows PE 分配给分区的驱动器号的任务序列变量。 此变量通常使用 Set-CMTSStepPartitionDisk 或 New-CMTSStepPartitionDisk cmdlet 的 DiskNumberVariable 参数设置，用于格式化和分区磁盘任务序列步骤。

Type:	DestinationType
Accepted values:	NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DestinationDisk

使用 -Destination SpecificDiskAndPartition时，使用此参数指定磁盘编号。 指定从 0 到 的 99整数。 另请使用 DestinationPartition 参数。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DestinationDriveLetter

使用 -Destination SpecificLogicalDriverLetter时，请使用此参数指定逻辑驱动器号。 指定从 C 到 Z的驱动器号。

Type:	String
Aliases:	DestinationLogicalDrive
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DestinationPartition

使用 -Destination SpecificDiskAndPartition时，请使用此参数指定分区号。 指定从 1 到 的 99整数。 另请使用 DestinationDisk 参数。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DestinationVariable

使用 -Destination LogicalDriverLetterInVariable时，使用此参数使用逻辑驱动器号指定任务序列变量。 变量名称需要字母数字，不带空格且少于 256 个字符。

Type:	String
Aliases:	DestinationVariableName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Disable

添加此参数以禁用此任务序列步骤。

Type:	SwitchParameter
Aliases:	DisableThisStep
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ImagePackage

指定数据图像包对象。 此步骤应用此图像中的数据。 使用 ImagePackageIndex 参数设置图像索引。

若要获取此对象，请使用 Get-CMOperatingSystemImage cmdlet。

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ImagePackageIndex

指定图像索引的整数值。 将此参数与 ImagePackage 参数一起使用。

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

指定此步骤的名称，以便在任务序列中标识它。

Type:	String
Aliases:	StepName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WipePartition

默认情况下启用此设置，这会在应用映像之前删除分区上的所有内容。

将此参数设置为 $false 不删除分区的先前内容。 此操作可用于将更多内容应用于以前的目标分区。

Type:	Boolean
Aliases:	WipePartitionBeforeApplyImage
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

输出

IResultObject

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_TaskSequence_ApplyDataImageAction服务器 WMI 类。

相关链接

• Get-CMTSStepApplyDataImage
• Remove-CMTSStepApplyDataImage
• Set-CMTSStepApplyDataImage
• 关于任务序列步骤：应用数据图像