你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Update-ServiceFabricApplicationUpgrade

修改活动应用程序升级的升级说明。

语法

Update-ServiceFabricApplicationUpgrade
      [-ApplicationName] <Uri>
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-DefaultServiceTypeHealthPolicy <String>]
      [-MaxPercentUnhealthyDeployedApplications <Byte>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-Force]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Update-ServiceFabricApplicationUpgrade cmdlet 修改应用程序升级说明的参数,同时升级仍处于活动状态。 Service Fabric 根据群集清单中指定的 UpgradeStatusPollInterval 值检测并应用更改。 除了运行状况评估策略,此 cmdlet 仅更新指定的参数。 未指定的参数不受影响。 必须一起更新以下运行状况评估策略,而不是单独更新:

  • ConsiderWarningAsError
  • DefaultServiceTypeHealthPolicy
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap

在 Service Fabric 群集上执行任何操作之前,请使用 Connect-ServiceFabricCluster cmdlet 建立与群集的连接。

示例

示例 1:更新应用程序升级的值

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

此命令将副本集检查超时值设置为 0,以获取 fabric:/MyApplication 上的挂起升级。 更新将保留所有其他升级值。

参数

-ApplicationName

指定 Service Fabric 应用程序的统一资源标识符(URI)。 该 cmdlet 更新具有此参数所指定的 URI 的应用程序升级的设置。

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

-Confirm

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

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

-ConsiderWarningAsError

指示是否在运行状况评估期间将警告运行状况报告视为错误。

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

-DefaultServiceTypeHealthPolicy

指定服务类型的默认运行状况策略。 运行状况策略用于监视的升级。 策略遵循 MaxPercentUnhealthyPartitionsPerService、MaxPercentUnhealthyReplicasPerPartition、MaxPercentUnhealthyServices 的格式。 例如,5,10,15 指示以下值:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FailureAction

指定监视升级失败时要执行的操作。 此参数的可接受值为:

  • 反转
  • 手动
类型:UpgradeFailureAction
接受的值:Invalid, Rollback, Manual
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Force

指示此 cmdlet 跳过警告消息并强制更新。

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

-ForceRestart

指示服务主机是否重启,即使升级是仅配置更改。

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

-HealthCheckRetryTimeoutSec

指定持续时间(以秒为单位),之后,Service Fabric 会重试运行状况检查(如果上一个运行状况检查失败)。

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

-HealthCheckStableDurationSec

指定 Service Fabric 等待的持续时间(以秒为单位)以验证应用程序在继续到下一个升级域或完成升级之前是否稳定。 执行运行状况检查后,此等待持续时间可防止未检测到的运行状况更改。

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

-HealthCheckWaitDurationSec

指定 Service Fabric 在升级域完成升级后执行初始运行状况检查之前等待的持续时间(以秒为单位)。

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

-InstanceCloseDelayDurationSec

指定持续时间(以秒为单位),等待应用程序升级影响的无状态实例关闭,以允许活动请求正常耗尽。 此等待持续时间仅适用于为 InstanceCloseDelayDuration 配置了非零值的无状态服务的实例,并且将替代预配置的值。 有关详细信息,请参阅 InstanceCloseDelayDuration

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

-MaxPercentUnhealthyDeployedApplications

指定可具有错误运行状况的已部署应用程序的最大百分比。 如果群集中节点上部署的不正常应用程序实例的百分比超过此参数指定的值,则应用程序的运行状况状态为错误。

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

-ServiceTypeHealthPolicyMap

指定要用于不同服务类型的运行状况策略的映射。 将映射指定为以下格式的哈希表:@ {“ServiceTypeName” : “MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices”}。 例如:

@{ “ServiceTypeName01” = “5,10,5”;“ServiceTypeName02” = “5,5,5” }

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

-TimeoutSec

指定操作的超时期限(以秒为单位)。

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

-UpgradeDomainTimeoutSec

指定 Service Fabric 升级单个升级域所需的时间(以秒为单位)。 在此时间段后,升级失败。

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

-UpgradeMode

指定升级的新 UpgradeMode

类型:RollingUpgradeMode
接受的值:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpgradeReplicaSetCheckTimeoutSec

指定 Service Fabric 等待服务重新配置为安全状态(如果尚未处于安全状态)之前 Service Fabric 继续升级的最长时间(以秒为单位)。

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

-UpgradeTimeoutSec

指定 Service Fabric 在整个升级中花费的最大时间(以秒为单位)。 在此时间段后,升级失败。

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

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

输入

None

输出

System.Object