New-CMTSStepApplyOperatingSystem

模块:

ConfigurationManager

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

语法

New-CMTSStepApplyOperatingSystem
   [-ConfigFileName <String>]
   [-ConfigFilePackage <IResultObject>]
   [-Destination <DestinationType>]
   [-DestinationDisk <Int32>]
   [-DestinationDriveLetter <String>]
   [-LayeredDriver <OsdLayeredDriver>]
   [-DestinationPartition <Int32>]
   [-DestinationVariable <String>]
   [-ImagePackage <IResultObject>]
   [-ImagePackageIndex <Int32>]
   [-InstallPackage <IResultObject>]
   [-InstallPackageIndex <Int32>]
   [-RunFromNet <Boolean>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

此 cmdlet 将创建新的 “应用 OS 映像” 步骤对象。 然后使用 Add-CMTaskSequenceStep cmdlet 将步骤添加到任务序列。 有关此步骤的详细信息，请参阅 关于任务序列步骤：应用 OS 映像。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1

此示例首先使用 Get-CMOperatingSystemImage cmdlet 获取 OS 映像包的对象。 它将此对象保存在 $osImgPkg 变量中。 下一步使用 $osImgPkg 对象作为映像包，为“应用 OS 映像”步骤创建对象。

然后，它获取任务序列对象，并将此新步骤添加到索引 11 处的任务序列。

$osImgPkg = Get-CMOperatingSystemImage -Name "OSImagePkg01"
$step = New-CMTSStepApplyOperatingSystem -Name "Apply OS image" -ImagePackage $osImgPkg -ImagePackageIndex 1

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

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

参数

-Condition

指定要用于此步骤的条件对象。 若要获取此对象，请使用任务序列条件 cmdlet 之一。 例如 Get-CMTSStepConditionVariable。

类型:	IResultObject[]
别名:	Conditions
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ConfigFileName

指定要用于自定义安装的无人参与或 Sysprep 应答文件的文件名。 将此参数与 ConfigFilePackage 参数一起使用。

类型:	String
别名:	AnswerFileName
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ConfigFilePackage

指定一个包对象，其中包含用于自定义安装的无人参与或 Sysprep 应答文件。 若要获取此对象，请使用 Get-CMPackage cmdlet。 将此参数与 ConfigFileName 参数一起使用。

类型:	IResultObject
别名:	AnswerFilePackage
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

指定要应用此 OS 的位置。 如果未指定此参数，则默认值为 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

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

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

类型:	IResultObject
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ImagePackageIndex

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

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InstallPackage

指定 OS 升级包对象。 此步骤应用来自此原始安装源的 OS。 使用 InstallPackageIndex 参数设置版本。

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

类型:	IResultObject
别名:	UpgradePackage
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InstallPackageIndex

指定 OS 升级包版本的整数值。 将此参数与 InstallPackage 参数一起使用。

类型:	Int32
别名:	UpgradePackageIndex
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LayeredDriver

从版本 2107 开始，使用此参数选择日语和韩语通用的其他类型的键盘。 为要与 Windows 一起安装的分层驱动程序指定整数值。 使用与 OsdLayeredDriver 任务序列变量相同的值。

类型:	OsdLayeredDriver
别名:	KeyboardDriver
接受的值:	DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

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

类型:	String
别名:	StepName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RunFromNet

将此参数设置为 $true 以允许任务序列直接从分发点应用 OS 映像。

为了获得最大的安全性，建议不要启用此设置。 此选项旨在用于存储容量有限的设备。 有关详细信息，请参阅 直接从分发点访问内容。

类型:	Boolean
别名:	AllowAccessFromDistributionPoint
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

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

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

输出

IResultObject

备注

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

相关链接

• Get-CMTSStepApplyOperatingSystem
• Remove-CMTSStepApplyOperatingSystem
• Set-CMTSStepApplyOperatingSystem
• 关于任务序列步骤：应用 OS 映像