New-CMTSStepUpgradeOperatingSystem

模块:

ConfigurationManager

创建可添加到任务序列的 升级 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。

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

-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

-DriverPackage

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

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

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

-DynamicUpdateSetting

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

• DisablePolicy：请勿使用动态更新
• UsingPolicy：启用安装程序以使用动态更新，例如搜索、下载和安装更新。
• OverridePolicy：实时临时替代本地策略以运行动态更新操作。 计算机从Windows 更新获取更新。

Type:	DynamicUpdateOption
Accepted values:	DisablePolicy, UsingPolicy, OverridePolicy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EditionIndex

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

Type:	Int32
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

-IgnoreMessage

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
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

-ProductKey

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

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

-ScanOnly

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

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

-SetupTimeout

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

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

-SoftwareUpdate

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

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

-SourcePath

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

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

-StagedContent

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

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

-UpgradePackage

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

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

Type:	IResultObject
Position:	Named
Default value:	None
Required:	False
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

输入

None

输出

IResultObject

备注

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

相关链接

• Get-CMTSStepUpgradeOperatingSystem
• Remove-CMTSStepUpgradeOperatingSystem
• Set-CMTSStepUpgradeOperatingSystem
• 关于任务序列步骤：升级 OS