Start-ServiceFabricApplicationUpgrade

構文

UnmonitoredAuto (既定)

Start-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ApplicationTypeVersion] <String>
    [[-ApplicationParameter] <Hashtable>]
    [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
    [[-SortOrder] <UpgradeSortOrder>]
    [-ForceRestart]
    [-ReplicaQuorumTimeoutSec <UInt32>]
    [-RestartProcess]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-UnmonitoredAuto]
    [-Force]
    [-TimeoutSec <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UnmonitoredManual

Start-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ApplicationTypeVersion] <String>
    [[-ApplicationParameter] <Hashtable>]
    [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
    [[-SortOrder] <UpgradeSortOrder>]
    [-ForceRestart]
    [-ReplicaQuorumTimeoutSec <UInt32>]
    [-RestartProcess]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-UnmonitoredManual]
    [-Force]
    [-TimeoutSec <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Monitored

Start-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ApplicationTypeVersion] <String>
    [[-ApplicationParameter] <Hashtable>]
    [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
    [[-SortOrder] <UpgradeSortOrder>]
    -FailureAction <UpgradeFailureAction>
    [-ForceRestart]
    [-ReplicaQuorumTimeoutSec <UInt32>]
    [-RestartProcess]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-Monitored]
    [-HealthCheckRetryTimeoutSec <UInt32>]
    [-HealthCheckWaitDurationSec <UInt32>]
    [-HealthCheckStableDurationSec <UInt32>]
    [-UpgradeDomainTimeoutSec <UInt32>]
    [-UpgradeTimeoutSec <UInt32>]
    [-ConsiderWarningAsError <Boolean>]
    [-DefaultServiceTypeHealthPolicy <String>]
    [-MaxPercentUnhealthyDeployedApplications <Byte>]
    [-ServiceTypeHealthPolicyMap <Hashtable>]
    [-Force]
    [-TimeoutSec <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

例

例 1: アップグレード呼び出しに渡すアプリケーション パラメーターを取得する

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}

foreach ($pair in $appParamCollection)
{ $applicationParameterMap.Add($pair.Name, $pair.Value); }

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

例 2: アプリケーションのアップグレード

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\PersistentToDoListServiceV2" -ImageStoreConnectionString "file:C:\ProgramData\ServiceFabric\ImageStore"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListServiceV2"
PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeVersion "2.0" -ForceRestart -UnMonitoredManual

パラメーター

-ApplicationName

Service Fabric アプリケーションの Uniform Resource Identifier (URI) を指定します。 コマンドレットは、指定した URI を持つアプリケーションをアップグレードします。

パラメーターのプロパティ

パラメーター セット

-ApplicationParameter

アプリケーション・パラメーターのオーバーライドを名前と値のペアとして指定します。

パラメーターのプロパティ

パラメーター セット

-ApplicationTypeVersion

Service Fabric アプリケーションの種類のバージョンを指定します。 コマンドレットは、指定したバージョンにアプリケーションをアップグレードします。

パラメーターのプロパティ

パラメーター セット

-Confirm

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

パラメーターのプロパティ

パラメーター セット

-ConsiderWarningAsError

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

パラメーターのプロパティ

パラメーター セット

-DefaultServiceTypeHealthPolicy

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

• サービスあたりの最大異常パーティションの割合 = 5
• パーティションあたりの最大異常レプリカの割合 = 10
• 最大パーセント異常サービス = 15

パラメーターのプロパティ

パラメーター セット

-FailureAction

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

• ロールバック
• マニュアル

パラメーターのプロパティ

パラメーター セット

-Force

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

パラメーターのプロパティ

パラメーター セット

-ForceRestart

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

パラメーターのプロパティ

パラメーター セット

-HealthCheckRetryTimeoutSec

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

パラメーターのプロパティ

パラメーター セット

-HealthCheckStableDurationSec

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

パラメーターのプロパティ

パラメーター セット

-HealthCheckWaitDurationSec

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

パラメーターのプロパティ

パラメーター セット

-InstanceCloseDelayDurationSec

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

パラメーターのプロパティ

パラメーター セット

-MaxPercentUnhealthyDeployedApplications

クラスターのアプリケーション正常性状態がエラーになるまでの正常性状態がエラーであるクラスター内のノードにデプロイされたアプリケーション インスタンスの最大割合を指定します。

パラメーターのプロパティ

パラメーター セット

-Monitored

アップグレード モードが監視されていることを示します。 コマンドレットがアップグレード ドメインのアップグレードを完了した後、アップグレード ドメインとクラスターの正常性が定義した正常性ポリシーを満たしている場合、Service Fabric は次のアップグレード ドメインをアップグレードします。 アップグレード ドメインまたはクラスターが正常性ポリシーを満たさない場合、アップグレードは失敗し、Service Fabric はアップグレード ドメインのアップグレードをロールバックするか、指定されたポリシーに従って手動モードに戻します。 これは、本番環境でのアプリケーションのアップグレードに推奨されるモードです。

パラメーターのプロパティ

パラメーター セット

-ReplicaQuorumTimeoutSec

レプリカ セットにクォーラムがあるかどうかを確認するためのタイムアウト期間を秒単位で指定します。 タイムアウト期間が経過すると、アップグレードが続行されます。

このパラメーターは非推奨になりました。 代わりに、 UpgradeReplicaSetCheckTimeoutSec パラメータを指定します。

パラメーターのプロパティ

パラメーター セット

-RestartProcess

アップグレードの一環としてサービス ホストが再起動することを示します。

このパラメーターは非推奨になりました。 代わりに ForceRestart パラメータを指定します。

パラメーターのプロパティ

パラメーター セット

-ServiceTypeHealthPolicyMap

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

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

パラメーターのプロパティ

パラメーター セット

-SortOrder

アップグレードがクラスターを通過する順序を定義します。

使用可能な値は次のとおりです。

• Invalid - このソート順序が無効であることを示します。 すべての Service Fabric 列挙型の型が無効です。
• Default - デフォルトのソート順序 (クラスターマニフェストで指定されている) が使用されることを示します。
• Numeric - 順方向の数値ソート順序 (数値としてソートされた UD 名) が使用されることを示します。
• Lexicographical - 順方向の辞書順の並べ替え順序 (文字列としてソートされた UD 名) が使用されることを示します。
• ReverseNumeric - 逆の数値ソート順序 (UD 名を数値としてソート) が使用されることを示します。
• ReverseLexicographical- 逆の辞書式ソート順序 (文字列としてソートされた UD 名) が使用されることを示します。

パラメーターのプロパティ

パラメーター セット

-TimeoutSec

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

パラメーターのプロパティ

パラメーター セット

-UnmonitoredAuto

アップグレード モードが自動的に監視されていないことを示します。 Service Fabric がアップグレード ドメインをアップグレードした後、Service Fabric は、アプリケーションの正常性状態に関係なく、次のアップグレード ドメインをアップグレードします。 このモードは本番環境には推奨されず、アプリケーションの開発中にのみ役立ちます。

パラメーターのプロパティ

パラメーター セット

-UnmonitoredManual

アップグレードモードが監視されていない手動であることを示します。 Service Fabric は、アップグレード ドメインをアップグレードした後、 Resume-ServiceFabricApplicationUpgrade コマンドレットを使用して、次のアップグレード ドメインをアップグレードするのを待機します。

パラメーターのプロパティ

パラメーター セット

-UpgradeDomainTimeoutSec

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

パラメーターのプロパティ

パラメーター セット

-UpgradeReplicaSetCheckTimeoutSec

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

パラメーターのプロパティ

パラメーター セット

-UpgradeTimeoutSec

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

パラメーターのプロパティ

パラメーター セット

-WhatIf

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

パラメーターのプロパティ

パラメーター セット

CommonParameters

入力

None

出力

System.Object

関連リンク

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricApplicationUpgrade
• Resume-ServiceFabricApplicationUpgrade
• Copy-ServiceFabricApplicationPackage
• Register-ServiceFabricApplicationType