New-CMTSStepUpgradeOperatingSystem

创建可添加到任务序列的 升级 OS 步骤。

语法

New-CMTSStepUpgradeOperatingSystem
   [-DriverPackage <IResultObject>]
   [-DynamicUpdateSetting <DynamicUpdateOption>]
   [-EditionIndex <Int32>]
   [-IgnoreMessage <Boolean>]
   [-ProductKey <String>]
   [-ScanOnly <Boolean>]
   [-SetupTimeout <Int32>]
   [-SourcePath <String>]
   [-StagedContent <String>]
   [-UpgradePackage <IResultObject>]
   [-SoftwareUpdate <IResultObject[]>]
   [-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-CMOperatingSystemInstaller cmdlet 获取 OS 升级包的对象。 它将此对象保存在 $osUpgPkg 变量中。 下一步使用 $osUpgPkg 对象作为 OS 升级包,为升级 OS 步骤创建对象。

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

$osUpgPkg = Get-CMOperatingSystemInstaller -Name "OSUpgradePkg01"
$step = New-CMTSStepUpgradeOperatingSystem -Name "Upgrade OS" -UpgradePackage $osUpgPkg -EditionIndex 1

$tsNameOsd = "Default OS upgrade"
$tsUpg = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsUpg | 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

-Disable

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

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

-DisableWildcardHandling

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

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

-DriverPackage

指定驱动程序包对象,以在升级期间将其驱动程序内容提供给 Windows 安装程序。 若要获取此包,请使用 Get-CMDriverPackage cmdlet。

使用 StagedContent 参数指定驱动程序内容的位置。

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

-DynamicUpdateSetting

使用此参数通过 Windows 更新动态更新 Windows 安装程序。

  • DisablePolicy:请勿使用动态更新
  • UsingPolicy:启用安装程序以使用动态更新,例如搜索、下载和安装更新。
  • OverridePolicy:实时临时替代本地策略以运行动态更新操作。 计算机从 Windows 更新获取更新。
类型:DynamicUpdateOption
接受的值:DisablePolicy, UsingPolicy, OverridePolicy
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EditionIndex

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

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

-ForceWildcardHandling

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

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

-IgnoreMessage

将此参数设置为 以 $true 指定 Windows 安装程序完成安装,忽略任何已解除的兼容性消息。

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

-Name

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

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

-ProductKey

指定要应用于升级过程的产品密钥。

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

-ScanOnly

将此参数设置为 以 $true 在不开始升级的情况下运行 Windows 安装程序兼容性扫描。

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

-SetupTimeout

指定 Configuration Manager 在此步骤失败之前的分钟数。 如果 Windows 安装程序停止处理但未终止,则此选项很有用。

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

-SoftwareUpdate

从版本 2107 开始,使用功能更新指定软件更新对象以升级客户端的 Windows OS。 若要获取此对象,请使用 Get-CMSoftwareUpdate cmdlet。

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

-SourcePath

指定 Windows 安装程序使用的 Windows 媒体的本地或网络路径。

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

-StagedContent

将此参数与 DriverPackage 配合使用可指定驱动程序内容的位置。 可以指定本地文件夹、网络路径或任务序列变量。

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

-UpgradePackage

指定 OS 升级包对象。 使用 EditionIndex 参数设置版本。

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

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

-WhatIf

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

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

输入

None

输出

IResultObject

备注

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