Set-CMSoftwareUpdatePhase
使用此 cmdlet 配置软件更新的部署阶段。
语法
Set-CMSoftwareUpdatePhase
[-AlertDelta <Int32>]
[-AlertThresholdPercentage <Int32>]
[-AlertUnit <TimeUnitType>]
[-AllowMeteredConnection <Boolean>]
[-AllowSystemRestart <Boolean>]
[-AllowWumuFallback <Boolean>]
[-DisableScomAlert <Boolean>]
[-EnableAlert <Boolean>]
[-EnableWakeOnLan <Boolean>]
[-GenerateScomAlertOnFailure <Boolean>]
[-PhaseDescription <String>]
[-RequirePostRebootFullScan <Boolean>]
[-ServerRestartSuppression <Boolean>]
[-SoftwareInstallation <Boolean>]
[-StateMessageVerbosity <VerbosityLevelType>]
[-UseNeighborDP <Boolean>]
[-UserNotificationOption <UserNotificationType>]
[-UseSiteDefaultDP <Boolean>]
[-WorkstationRestartSuppression <Boolean>]
[-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-MovePhase <ReorderType>]
[-MoveToOrder <Int32>]
[-NewCollection <IResultObject>]
[-NewCollectionId <String>]
[-NewCollectionName <String>]
[-NewPhaseName <String>]
[-ThrottlingDays <Int32>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Id <String>]
[-InputObject] <IResultObject>
[-Name <String>]
[-Order <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMSoftwareUpdatePhase
[-AlertDelta <Int32>]
[-AlertThresholdPercentage <Int32>]
[-AlertUnit <TimeUnitType>]
[-AllowMeteredConnection <Boolean>]
[-AllowSystemRestart <Boolean>]
[-AllowWumuFallback <Boolean>]
[-DisableScomAlert <Boolean>]
[-EnableAlert <Boolean>]
[-EnableWakeOnLan <Boolean>]
[-GenerateScomAlertOnFailure <Boolean>]
[-PhaseDescription <String>]
[-RequirePostRebootFullScan <Boolean>]
[-ServerRestartSuppression <Boolean>]
[-SoftwareInstallation <Boolean>]
[-StateMessageVerbosity <VerbosityLevelType>]
[-UseNeighborDP <Boolean>]
[-UserNotificationOption <UserNotificationType>]
[-UseSiteDefaultDP <Boolean>]
[-WorkstationRestartSuppression <Boolean>]
[-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-MovePhase <ReorderType>]
[-MoveToOrder <Int32>]
[-NewCollection <IResultObject>]
[-NewCollectionId <String>]
[-NewCollectionName <String>]
[-NewPhaseName <String>]
[-ThrottlingDays <Int32>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Id <String>]
[-Name <String>]
[-Order <Int32>]
[-PhasedDeploymentId] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMSoftwareUpdatePhase
[-AlertDelta <Int32>]
[-AlertThresholdPercentage <Int32>]
[-AlertUnit <TimeUnitType>]
[-AllowMeteredConnection <Boolean>]
[-AllowSystemRestart <Boolean>]
[-AllowWumuFallback <Boolean>]
[-DisableScomAlert <Boolean>]
[-EnableAlert <Boolean>]
[-EnableWakeOnLan <Boolean>]
[-GenerateScomAlertOnFailure <Boolean>]
[-PhaseDescription <String>]
[-RequirePostRebootFullScan <Boolean>]
[-ServerRestartSuppression <Boolean>]
[-SoftwareInstallation <Boolean>]
[-StateMessageVerbosity <VerbosityLevelType>]
[-UseNeighborDP <Boolean>]
[-UserNotificationOption <UserNotificationType>]
[-UseSiteDefaultDP <Boolean>]
[-WorkstationRestartSuppression <Boolean>]
[-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-MovePhase <ReorderType>]
[-MoveToOrder <Int32>]
[-NewCollection <IResultObject>]
[-NewCollectionId <String>]
[-NewCollectionName <String>]
[-NewPhaseName <String>]
[-ThrottlingDays <Int32>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Id <String>]
[-Name <String>]
[-Order <Int32>]
[-PhasedDeploymentName] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
适用于版本 2006 和更高版本。 使用此 cmdlet 配置软件更新的部署阶段。 有关详细信息,请参阅创建 分阶段部署。
示例
示例 1:更改集合
此示例更改通过命令行传递的软件更新分阶段部署中第二阶段的集合。
$phasedDeployment = Get-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeployment"
$phasedDeployment | Set-CMSoftwareUpdatePhase -Order 2 -NewCollectionId "XYZ00227"
示例 2:上移一个阶段
本示例将一个阶段按序上移。 它按 ID 选择分阶段部署,然后按关联的集合 ID 选择阶段。
Set-CMSoftwareUpdatePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp
示例 3:配置阶段设置
本示例更改选定阶段的配置设置。
Set-CMSoftwareUpdatePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -EnableWakeOnLan $true -PhaseDescription "this is phase 1" -StateMessageVerbosity AllMessages -ServerRestartSuppression $true -WorkstationRestartSuppression $true -RequirePostRebootFullScan $true -EnableAlert $true -AlertThresholdPercentage 90 -AlertDelta 12 -AlertUnit Hours -DisableSCOMAlert $true -GenerateSCOMAlertOnFailure $true -UseNeighborDP $true -UseSiteDefaultDP $true -AllowWUMUFallback $true -AllowMeteredConnection $true -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12
参数
-AlertDelta
此参数与控制台中"添加阶段向导"的****"通知"页上的**** 以下设置相同:"从截止时间偏移"。 指定偏移的整数值,然后使用 AlertUnit 参数指定时间段类型。
若要设置此值,您必须使用 EnableAlert 参数。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertThresholdPercentage
此参数与控制台中"添加阶段向导"的****"警报"页上的**** 以下设置相同:客户端合规性低于以下 (百分比) 。 指定百分比的整数值。 若要设置此值,您必须使用 EnableAlert 参数。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertUnit
指定时间段的类型。 此参数与 AlertDelta 一同使用。
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowMeteredConnection
此参数与控制台中"添加阶段向导"的"下载设置" 页上的以下**** 设置相同:允许按流量计费的 Internet 连接上的客户端在安装截止时间后下载内容,这可能会产生额外的成本。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSystemRestart
此参数与控制台中"添加阶段向导"的****"用户体验"页上的**** 以下设置相同:如果需要完成安装 (请**重新启动) 。 ** 当达到安装截止时间时,此设置适用,以允许在维护时段外执行此活动。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowWumuFallback
此参数与控制台中"添加阶段向导"的"下载设置" 页上的以下**** 设置相同:如果软件更新在当前、邻域或站点边界组的分发点上不可用,请从Microsoft 更新下载内容。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BeginCondition
指定在上一阶段成功后开始此部署阶段的选项:
AfterPeriod
:此参数与控制台中"添加阶段向导"的"阶段设置" 页上的以下**** 设置相同:在延迟期后自动开始此阶段 (天数 **) 。 ** 如果指定此值,请使用 DaysAfterPreviousPhaseSuccess 配置时间段。Manually
:此参数与控制台中"添加阶段向导"的****"阶段设置"页上的以下**** 设置相同:手动开始此部署阶段。
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
指定目标集合的对象。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
按 ID 指定目标集合。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
按名称指定目标集合。
Type: | String |
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 |
-CriteriaOption
指定一个选项以选择上一阶段是否成功的条件:
Compliance
:此参数与控制台中"添加阶段向导"的****"阶段设置"页上的以下设置**** 相同:部署成功百分比。 使用 CriteriaValue 参数指定百分比值。Number
:此参数与控制台中"添加阶段向导"的****"阶段设置"页上的以下设置**** 相同:已成功部署的设备数。 使用 CriteriaValue 参数指定设备数。
Type: | CriteriaType |
Accepted values: | Compliance, Number |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaValue
此整数值取决于为 CriteriaOption 指定的值:
Compliance
:指定百分比Number
:指定设备数
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
指定上一阶段成功后天数的整数值以开始此阶段。 此参数与控制台中"添加阶段向导"的"阶段设置" 页上的以下**** 设置相同:在延迟期 ((以天) )后自动开始此阶段。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineUnit
指定截止时间的类型。 此参数与 DeadlineValue 一起使用。
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineValue
此参数仅在使用 AfterPeriod
InstallationChoice 参数指定时使用。
指定截止时间时间段的整数值。 使用DeadlineUnit参数指定时间段的类型 Hours
Days
Weeks
:、、、。 Months
此参数与控制台中"添加阶段向导"的****"阶段设置"页上的以下**** 设置相同:在此时间段后需要安装。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableScomAlert
此参数与控制台中"添加阶段向导"的****"警报"页上的**** 以下设置相同:在软件更新运行时禁用Operations Manager 警报。
Type: | Boolean |
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 |
-EnableAlert
此参数与控制台中"添加阶段向导"的****"警报"页上的**** 以下设置相同:在满足以下条件时生成警报。 当您将此参数设置为 $true
时,还要设置以下参数:
- AlertThresholdPercentage
- AlertDelta
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableWakeOnLan
此参数与控制台中"添加阶段向导"的****"部署 设置"页上的以下**** 设置相同:使用 LAN 唤醒客户端以执行所需部署。
Type: | Boolean |
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 |
-GenerateScomAlertOnFailure
此参数与控制台中"添加阶段向导"的****"警报"页上的**** 以下设置相同:在软件更新安装失败时生成Operations Manager 警报。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
指定要配置的阶段的 ID。
Type: | String |
Aliases: | PhaseId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定包含要配置的阶段的分阶段部署对象。
Type: | IResultObject |
Aliases: | PhasedDeployment |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstallationChoice
指定与软件可用时间相关的行为选项:
AsSoonAsPossible
:此参数与控制台中"添加阶段向导"的****"阶段 设置"页上的**** 以下设置相同:尽快需要安装。AfterPeriod
:此参数与控制台中"添加阶段向导"的****"阶段 设置"页上的以下**** 设置相同:在此时间段后需要安装。 如果指定此值,请使用 DeadlineUnit 和 DeadlineValue 配置时间段。
Type: | InstallationChoiceType |
Accepted values: | AsSoonAsPossible, AfterPeriod |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MovePhase
更改选定阶段的顺序。 您可以将其向上移动一个索引,向下移动一个索引,或移动到特定索引。 如果指定 MoveToOrder
,请使用 -MoveToOrder 参数设置特定索引。
Type: | ReorderType |
Accepted values: | MoveUp, MoveDown, MoveToOrder |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MoveToOrder
将 -MovePhase 参数设置为 MoveToOrder
时,使用此参数设置特定索引。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollection
指定要用作选定阶段的新目标的集合对象。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollectionId
按 ID 指定要用作选定阶段的新目标的集合。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollectionName
按名称指定要用作选定阶段的新目标的集合。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewPhaseName
使用此参数可重命名所选阶段。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Order
指定要配置的阶段的索引。
Type: | Int32 |
Aliases: | PhaseOrder |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhasedDeploymentId
按 ID 选择分阶段部署。 然后,使用其他参数选择该部署中的特定阶段。
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhasedDeploymentName
按名称选择分阶段部署。 然后,使用其他参数选择该部署中的特定阶段。
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhaseDescription
指定阶段的说明。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequirePostRebootFullScan
此参数与控制台中"添加阶段向导"的****"用户体验"页上的**** 以下设置相同:如果此部署中的更新需要重新启动系统,则重启后运行更新部署评估周期。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerRestartSuppression
此参数与控制台中"添加阶段向导"的****"用户体验"页上的以下设置相同。 禁止在下列设备上重新启动系统: 服务器。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
此参数与控制台中"添加阶段向导"的****"用户体验"页上的**** 以下设置相同:软件安装。 当达到安装截止时间时,此设置适用,以允许在维护时段外执行此活动。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StateMessageVerbosity
此参数与控制台中"添加阶段向导"设置"部署策略"页上的以下设置**** 相同: 状态消息详细信息级别,具有以下值: ****
AllMessages
:所有邮件OnlySuccessAndErrorMessages
:仅成功和错误消息OnlyErrorMessages
:仅错误消息
Type: | VerbosityLevelType |
Accepted values: | AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottlingDays
指定一个整数值,用于逐步提供该软件的天数。 此参数与控制台中"添加阶段向导"的"阶段设置" 页上的以下**** 设置相同:逐步使此软件在此时段内可用 (天数 **) 。 **
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseNeighborDP
此参数与控制台中"添加阶段向导"的"下载设置" 页上的以下**** 设置相同:选择客户端使用邻近边界组或默认站点边界组的分发点时使用的部署选项。 指定以下值:
$true
:从分发点下载软件更新并安装$false
:不安装软件更新
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotificationOption
此参数与控制台中"添加阶段向导"的"用户体验"页上的**** 以下设置相同:使用下列值**** 指定此部署的用户体验设置: ****
DisplayAll
:在软件中心中显示并显示所有通知DisplaySoftwareCenterOnly
:在软件中心中显示,并且仅显示计算机重启通知HideAll
:在软件中心中隐藏以及所有通知
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSiteDefaultDP
此参数与控制台中"添加阶段向导"的"下载设置" 页上的以下**** 设置相同:当软件更新在当前或邻域边界组的任何分发点上不可用时,客户端可以从站点默认边界组的分发点下载和安装软件更新。 指定以下值:
$true
:从站点默认边界组的分发点下载并安装软件更新$false
:不安装软件更新
Type: | Boolean |
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 |
-WorkstationRestartSuppression
此参数与控制台中"添加阶段向导"的****"用户体验"页上的以下设置相同。 禁止在下列设备上重新启动系统 :Workstations。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WriteFilterCommit
此参数与控制台中"添加阶段向导"的****"用户体验"页上的**** 以下设置相同:在截止时间或维护窗口期间提交更改 (需要重新启动) 。 此设置适用于嵌入式设备的Windows处理。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-名称
指定要配置的阶段的名称。
Type: | String |
Aliases: | PhaseName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject
相关链接
- Get-CMPhase
- New-CMSoftwareUpdatePhase
- Get-CMSoftwareUpdatePhasedDeployment
- New-CMSoftwareUpdateAutoPhasedDeployment
- New-CMSoftwareUpdateManualPhasedDeployment
- Remove-CMSoftwareUpdatePhasedDeployment
- Set-CMSoftwareUpdatePhasedDeployment
- Get-CMPhasedDeploymentStatus
- Move-CMPhasedDeploymentToNext
- Resume-CMPhasedDeployment
- Suspend-CMPhasedDeployment
- 创建分阶段部署