Update-ServiceFabricClusterUpgrade

リファレンス

モジュール:: ServiceFabric

アクティブなクラスターアップグレードのアップグレードの説明を変更します。

構文

Update-ServiceFabricClusterUpgrade
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-MaxPercentUnhealthyApplications <Byte>]
      [-MaxPercentUnhealthyNodes <Byte>]
      [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
      [-EnableDeltaHealthEvaluation <Boolean>]
      [-MaxPercentDeltaUnhealthyNodes <Byte>]
      [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
      [-Force]
      [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

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

ConsiderWarningAsError
MaxPercentUnhealthyApplications の
MaxPercentUnhealthyNodes の

Service Fabric クラスターを管理するには、[管理者として実行] オプションを使用して Windows PowerShell を起動します。 Service Fabric クラスターで操作を実行する前に、Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。

例

例 1: クラスターアップグレードの値を更新する

PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0

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

例 2: クラスターアップグレードの正常性ポリシーを更新する

PS C:\> $svcType = New-Object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
PS C:\> $svcType.MaxPercentUnhealthyPartitionsPerService = 100
PS C:\> $systemAppPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
PS C:\> $systemAppPolicy.DefaultServiceTypeHealthPolicy = $svcType
PS C:\> $appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
PS C:\> $appHealthPolicyMap.Add("fabric:/System", $systemAppPolicy)

PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)

PS C:\> Update-ServiceFabricClusterUpgrade -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -Force -MaxPercentUnhealthyApplications 20 -ApplicationHealthPolicyMap $appHealthPolicyMap

このコマンドは、クラスターアップグレードクラスターの正常性ポリシーを変更します。エラーを許容しないアプリケーションの種類 CriticalAppType を含むアプリケーションの種類の正常性ポリシーマップを指定します。残りのアプリケーションは、20% 最大異常率を使用して評価されます。

このコマンドは、クラスターアップグレード正常性評価の一環として fabric:/System アプリケーションを評価するために使用されるアプリケーション正常性ポリシーも更新します。新しいポリシーでは、すべてのパーティションエラーが許容されます。

パラメーター

-ApplicationHealthPolicyMap

一部またはすべてのアプリケーションのカスタム正常性ポリシーを含む System.Fabric.Health.ApplicationHealthPolicyMap を指定します。このパラメーターを指定しない場合、またはアプリケーションのマップにエントリを含まない場合、そのアプリケーションは、アプリケーションマニフェストに定義されているアプリケーション正常性ポリシー (存在する場合) または既定のポリシーで評価されます。

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

-ApplicationTypeHealthPolicyMap

アプリケーションの種類ごとに許可される異常なアプリケーションの最大割合を定義するマップを指定します。このマップ内のアプリケーションの種類は、グローバル MaxPercentUnhealthyApplications percentage ではなく、特定の割合を使用して評価されます。

たとえば、種類の一部のアプリケーションが重要な場合、クラスター管理者は、そのアプリケーションの種類のマップにエントリを追加し、0% の値を割り当てることができます (つまり、エラーは許容されません)。他のすべてのアプリケーションは、MaxPercentUnhealthyApplications 20% に設定して評価し、数千のアプリケーションインスタンスからいくつかの障害を許容できます。

アプリケーションの種類の正常性ポリシーマップは、クラスターマニフェストで、HealthManager/EnableApplicationTypeHealthEvaluationの構成エントリを使用してアプリケーションの種類の正常性評価を有効にする場合にのみ使用されます。

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

-Confirm

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

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

-ConsiderWarningAsError

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

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

-EnableDeltaHealthEvaluation

監視対象のアップグレードで正常性評価中に差分正常性チェックを有効にするかどうかを示します。 $Trueの値を指定すると、Service Fabric はアップグレードの開始時に正常性のスナップショットを取得します。各アップグレードドメインがアップグレードを完了すると、正常性チェックによってクラスターの現在の状態がスナップショットと比較されます。現在のクラスターアップグレード正常性ポリシーの最大許可パーセンテージを考慮しない正常性の低下がある場合、正常性チェックは失敗します。

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

-FailureAction

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

ロールバック
手動。

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

-Force

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

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

-ForceRestart

動的構成のみが変更された場合でも、Service Fabric ノードを再起動するかどうかを示します。

型:	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

-MaxPercentDeltaUnhealthyNodes

エラーの正常性状態を集計できる差分異常ノードの最大許容パーセンテージを指定します。現在の異常なノードがアップグレードの開始時の状態に対する割合を考慮しない場合、クラスターは異常です。

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

-MaxPercentUnhealthyApplications

エラーの正常性状態を集計できるアプリケーションの最大許容パーセンテージを指定します。アップグレードがこの割合を超えると、クラスターは異常になります。

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

-MaxPercentUnhealthyNodes

エラーの正常性状態を集計できるノードの最大許容パーセンテージを指定します。アップグレードがこの割合を超えると、クラスターは異常になります。

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

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

エラーの正常性状態を集計できるアップグレードドメイン差分異常ノードの最大許容パーセンテージを指定します。現在の異常なノードがアップグレードの開始時の状態に対する割合を考慮しないアップグレードドメインがある場合、クラスターは異常です。

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

-NodeTypeHealthPolicyMap

特定のノードタイプの異常なノードの最大パーセンテージを持つマップを定義します。

ノードタイプの正常性ポリシーマップは、クラスターの正常性評価中に特殊なノードの種類を記述するために使用できます。マップに含まれるノードの種類は、マップに含まれる割合に対して評価され、グローバルも使用されます (System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes を参照)。マップで指定されたノードタイプのノードも、ノードのグローバルプールに対してカウントされます。これらは独立したチェックです。

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

型:	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

次の方法で共有

Update-ServiceFabricClusterUpgrade

構文

説明

例

例 1: クラスターアップグレードの値を更新する

例 2: クラスターアップグレードの正常性ポリシーを更新する

パラメーター

-ApplicationHealthPolicyMap

-ApplicationTypeHealthPolicyMap

-Confirm

-ConsiderWarningAsError

-EnableDeltaHealthEvaluation

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-InstanceCloseDelayDurationSec

-MaxPercentDeltaUnhealthyNodes

-MaxPercentUnhealthyApplications

-MaxPercentUnhealthyNodes

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

-NodeTypeHealthPolicyMap

-TimeoutSec

-UpgradeDomainTimeoutSec

-UpgradeMode

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

入力

出力

その他のリソース

次の方法で共有

Update-ServiceFabricClusterUpgrade

構文

説明

例

例 1: クラスターアップグレードの値を更新する

例 2: クラスターアップグレードの正常性ポリシーを更新する

パラメーター

-ApplicationHealthPolicyMap

-ApplicationTypeHealthPolicyMap

-Confirm

-ConsiderWarningAsError

-EnableDeltaHealthEvaluation

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-InstanceCloseDelayDurationSec

-MaxPercentDeltaUnhealthyNodes

-MaxPercentUnhealthyApplications

-MaxPercentUnhealthyNodes

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

-NodeTypeHealthPolicyMap

-TimeoutSec

-UpgradeDomainTimeoutSec

-UpgradeMode

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

入力

出力

関連リンク

その他のリソース