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

型:Uri
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ConsiderWarningAsError

正常性評価中に警告正常性レポートをエラーとして扱うかどうかを示します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultServiceTypeHealthPolicy

サービスの種類の既定の正常性ポリシーを指定します。 正常性ポリシーは、監視対象のアップグレードに使用されます。 ポリシーは、MaxPercentUnhealthyPartitionsPerService、MaxPercentUnhealthyReplicasPerPartition、MaxPercentUnhealthyServices の形式に従います。 たとえば、5,10,15 は次の値を示します。

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FailureAction

監視対象のアップグレードが失敗した場合に実行するアクションを指定します。 このパラメーターに使用できる値は次のとおりです。

  • ロールバック
  • 手動
型:UpgradeFailureAction
指定可能な値:Invalid, Rollback, Manual
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceRestart

アップグレードが構成のみの変更である場合でも、サービス ホストが再起動するかどうかを示します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-HealthCheckRetryTimeoutSec

前の正常性チェックが失敗した場合に Service Fabric が正常性チェックを再試行する期間を秒単位で指定します。

型:UInt32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-HealthCheckStableDurationSec

次のアップグレード ドメインに進むか、アップグレードを完了する前に、アプリケーションが安定していることを確認するために Service Fabric が待機する時間を秒単位で指定します。 この待機時間により、正常性チェックが実行された直後に検出されない正常性の変更が防止されます。

型:UInt32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-HealthCheckWaitDurationSec

アップグレード ドメインでのアップグレードが完了した後、Service Fabric が最初の正常性チェックを実行するまでの待機時間を秒単位で指定します。

型:UInt32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InstanceCloseDelayDurationSec

アクティブな要求が正常にドレインできるように、アプリケーションのアップグレードの影響を受けるステートレス インスタンスが閉じられるまで待機する時間を秒単位で指定します。 この待機期間は、InstanceCloseDelayDuration に対して 0 以外の値が構成され、構成済みの値をオーバーライドするステートレス サービスのインスタンスに対してのみ有効です。 詳細については、InstanceCloseDelayDuration の を参照してください。

型:UInt32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MaxPercentUnhealthyDeployedApplications

正常性状態のエラーが発生する可能性がある、許容されるデプロイ済みアプリケーションの最大割合を指定します。 クラスター内のノードにデプロイされた異常なアプリケーション インスタンスの割合がこのパラメーターで指定した値を超えた場合、アプリケーションの正常性状態はエラーになります。

型:Byte
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServiceTypeHealthPolicyMap

さまざまなサービスの種類に使用する正常性ポリシーのマップを指定します。 マップをハッシュ テーブルとして次の形式で指定します。 @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"} 例えば：

@{ "ServiceTypeName01" = "5,10,5";"ServiceTypeName02" = "5,5,5" }

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TimeoutSec

操作のタイムアウト期間を秒単位で指定します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UpgradeDomainTimeoutSec

Service Fabric が 1 つのアップグレード ドメインのアップグレードに要する最大時間を秒単位で指定します。 この期間が経過すると、アップグレードは失敗します。

型:UInt32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UpgradeMode

アップグレードの新しい UpgradeMode を指定します。

型:RollingUpgradeMode
指定可能な値:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UpgradeReplicaSetCheckTimeoutSec

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

型:UInt32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UpgradeTimeoutSec

アップグレード全体に対して Service Fabric が要する最大時間を秒単位で指定します。 この期間が経過すると、アップグレードは失敗します。

型:UInt32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

System.Object