你当前正在访问 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