New-CMTSStepApplyOperatingSystem

模块:

ConfigurationManager

创建 "应用操作系统映像 "步骤，可将其添加到任务序列。

语法

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 创建新的 "应用操作系统映像" 步骤对象。 然后使用 Add-CMTaskSequenceStep cmdlet 将步骤添加到任务序列。 有关此步骤详细信息，请参阅关于 任务序列步骤：应用操作系统映像。

备注

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

示例

示例 1

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

然后，它获取一个任务序列对象，并将这个新步骤添加到索引为 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。

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

-ConfigFileName

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

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

-ConfigFilePackage

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

Type:	IResultObject
Aliases:	AnswerFilePackage
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

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

-ContinueOnError

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

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

-Destination

指定要应用此操作系统的位置。 如果不指定此参数，则默认为 NextAvailableFormattedPartition 。

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

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

• SpecificLogicalDriverLetter：使用DestinationDriveLetter参数指定通过 PE 分配给分区Windows驱动器号。 此驱动器号可以不同于新部署的操作系统分配的驱动器号。

• LogicalDriverLetterInVariable：使用DestinationVariable参数指定任务序列变量，该变量包含通过 PE 分配给分区的Windows号。 此变量通常使用Set-CMTSStepPartitionDisk或New-CMTSStepPartitionDisk cmdlet 的DiskNumberVariable参数设置，用于Format and Partition Disk任务序列步骤。

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

-DestinationDisk

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

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

-DestinationDriveLetter

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

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

-DestinationPartition

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

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

-DestinationVariable

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

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

-Disable

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-ImagePackage

指定操作系统映像包对象。 该步骤从此映像应用操作系统。 使用 ImagePackageIndex 参数设置图像索引。

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

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

-ImagePackageIndex

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

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

-InstallPackage

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

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

Type:	IResultObject
Aliases:	UpgradePackage
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallPackageIndex

指定操作系统升级程序包版本的整数值。 此参数与 InstallPackage 参数一 同使用。

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

-LayeredDriver

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

Type:	OsdLayeredDriver
Aliases:	KeyboardDriver
Accepted values:	DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunFromNet

设置此参数 $true 以允许任务序列直接从分发点应用操作系统映像。

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

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

-WhatIf

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

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

-名称

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

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

-描述

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

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

输入

无

输出

IResultObject

备注

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

相关链接

• Get-CMTSStepApplyOperatingSystem
• Remove-CMTSStepApplyOperatingSystem
• Set-CMTSStepApplyOperatingSystem
• 关于任务序列步骤：应用操作系统映像