Update-ServiceFabricApplicationUpgrade

參考

模組:: ServiceFabric

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

Syntax

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 會根據 Cluster 資訊清單中指定的 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 之應用程式的升級設定。

Type:	Uri
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

在執行 Cmdlet 前提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConsiderWarningAsError

指出是否要在健康情況評估期間將警告健康情況報告視為錯誤。

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

-DefaultServiceTypeHealthPolicy

指定服務類型的預設健全狀況原則。健康情況原則用於受監視的升級。此原則遵循 MaxPercentUnhealthyPartitionsPerService、MaxPercentUnhealthyReplicasPerPartition、MaxPercentUnhealthyServices 格式。例如，5,10,15 表示下列值：

MaxPercentUnhealthyPartitionsPerService = 5
MaxPercentUnhealthyReplicasPerPartition = 10
MaxPercentUnhealthyServices = 15

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

-FailureAction

指定監視升級失敗時要採取的動作。此參數可接受的值為：

復原
手動

Type:	UpgradeFailureAction
Accepted values:	Invalid, Rollback, Manual
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

表示此 Cmdlet 會略過警告訊息並強制更新。

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

-ForceRestart

指出服務主機是否重新開機，即使升級為僅限設定的變更也一樣。

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

-HealthCheckRetryTimeoutSec

指定持續時間，以秒為單位，之後 Service Fabric 會在先前的健康情況檢查失敗時重試健康情況檢查。

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

-HealthCheckStableDurationSec

指定 Service Fabric 等候的持續時間，以秒為單位，以確認應用程式在繼續進行下一個升級網域或完成升級之前，應用程式是否穩定。執行健康情況檢查之後，此等候持續時間會防止未偵測到的健康情況變更。

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

-HealthCheckWaitDurationSec

指定 Service Fabric 在升級網域完成升級之後，會在執行初始健康狀態檢查之前等候的持續時間，以秒為單位。

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

-InstanceCloseDelayDurationSec

指定以秒為單位的持續時間，以等候應用程式升級所影響的無狀態實例關閉，以允許作用中的要求正常清空。此等候持續時間僅適用于針對 InstanceCloseDelayDuration 設定非零值的無狀態服務實例，而且會覆寫預先設定的值。如需詳細資訊，請參閱 InstanceCloseDelayDuration 。

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

-MaxPercentUnhealthyDeployedApplications

指定可具有錯誤健康狀態的容許已部署應用程式百分比上限。如果在叢集中的節點上部署的狀況不良應用程式實例百分比超過此參數所指定的值，應用程式的健康情況狀態就會發生錯誤。

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

-ServiceTypeHealthPolicyMap

指定要用於不同服務類型的健康情況原則對應。以下列格式指定對應做為雜湊表：@ {「ServiceTypeName」：「MaxPercentUnhealthyPartitionsPerService，MaxPercentUnhealthyReplicasPerPartition，MaxPercentUnhealthyServices」}。例如：

@{ 「ServiceTypeName01」 = 「5，10，5」;「ServiceTypeName02」 = 「5，5，5」 }

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

-TimeoutSec

指定作業的逾時期間，以秒為單位。

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

-UpgradeDomainTimeoutSec

指定 Service Fabric 升級單一升級網域所花費的時間上限，以秒為單位。在此期間之後，升級會失敗。

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

-UpgradeMode

指定升級的新 UpgradeMode 。

Type:	RollingUpgradeMode
Accepted values:	Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpgradeReplicaSetCheckTimeoutSec

指定 Service Fabric 等候服務重新設定為安全狀態，如果尚未處於安全狀態，則 Service Fabric 在繼續進行升級之前，以秒為單位的時間上限。

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

-UpgradeTimeoutSec

指定 Service Fabric 針對整個升級所花費的時間上限，以秒為單位。在此期間之後，升級會失敗。

Type:	UInt32
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:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

None

輸出

System.Object