New-CMTSStepApplyOperatingSystem

创建可添加到任务序列 的“应用 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-CMTSStepPartitionDiskNew-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时,请使用此参数指定逻辑驱动器号。 指定从 CZ的驱动器号。

类型: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 类