Share via

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

説明

Update-ServiceFabricApplicationUpgrade コマンドレットは、アップグレードがまだアクティブな間に、アプリケーションのアップグレードの説明のパラメーターを変更します。 Service Fabric は、クラスター マニフェストで指定されている UpgradeStatusPollInterval 値に従って変更を検出して適用します。 正常性評価ポリシーを除き、このコマンドレットは指定したパラメーターのみを更新します。 指定されていないパラメーターは影響を受けません。 個別ではなく、次の正常性評価ポリシーを一緒に更新する必要があります。

  • ConsiderWarningAsError
  • DefaultServiceTypeHealthPolicy
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap

Service Fabric クラスターで操作を実行する前に、 Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。

例

例 1: アプリケーションのアップグレードの値を更新する

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

このコマンドは、fabric:/MyApplication で保留中のアップグレードのレプリカ セットのチェック タイムアウト値を 0 に設定します。 更新プログラムは、他のすべてのアップグレード値のみを残します。

パラメーター

-ApplicationName

Service Fabric アプリケーションの Uniform Resource Identifier (URI) を指定します。 コマンドレットは、このパラメーターが指定する URI を持つアプリケーションのアップグレードの設定を更新します。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

このコマンドレットが警告メッセージをスキップし、強制的に更新することを示します。

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 に対して 0 以外の値が構成され、構成済みの値をオーバーライドするステートレス サービスのインスタンスに対してのみ有効です。 詳細については、 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 が 1 つのアップグレード ドメインのアップグレードに要する最大時間を秒単位で指定します。 この期間が経過すると、アップグレードは失敗します。

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 がアップグレードを続行する前に、サービスがまだ安全な状態でない場合は、サービスが安全な状態に再構成されるのを待機する最大時間を秒単位で指定します。

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

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

None

出力

System.Object