共用方式為

Update-ServiceFabricApplicationUpgrade

  • 參考
模組:
ServiceFabric

修改使用中應用程式升級的升級描述。

語法

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>]

Description

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