Update-ServiceFabricService
Service Fabric サービスを更新します。
構文
Update-ServiceFabricService
[-Stateless]
[-ServiceName] <Uri>
[-InstanceCount <Int32>]
[-MinInstanceCount <Int32>]
[-MinInstancePercentage <Int32>]
[-InstanceLifecycleDescription <InstanceLifecycleDescription>]
[-Force]
[-PlacementConstraints <String>]
[-Metric <String[]>]
[-Correlation <String[]>]
[-PlacementPolicy <String[]>]
[-DefaultMoveCost <String>]
[-PartitionNamesToAdd <String[]>]
[-PartitionNamesToRemove <String[]>]
[-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
[-InstanceCloseDelayDuration <TimeSpan>]
[-InstanceRestartWaitDuration <TimeSpan>]
[-ServiceDnsName <String>]
[-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
[-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-ServiceFabricService
[-Stateful]
[-ServiceName] <Uri>
[-TargetReplicaSetSize <Int32>]
[-MinReplicaSetSize <Int32>]
[-ReplicaRestartWaitDuration <TimeSpan>]
[-QuorumLossWaitDuration <TimeSpan>]
[-StandByReplicaKeepDuration <TimeSpan>]
[-ServicePlacementTimeLimit <TimeSpan>]
[-DropSourceReplicaOnMove <Boolean>]
[-ReplicaLifecycleDescription <ReplicaLifecycleDescription>]
[-Force]
[-PlacementConstraints <String>]
[-Metric <String[]>]
[-Correlation <String[]>]
[-PlacementPolicy <String[]>]
[-DefaultMoveCost <String>]
[-PartitionNamesToAdd <String[]>]
[-PartitionNamesToRemove <String[]>]
[-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
[-ServiceDnsName <String>]
[-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
[-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Update-ServiceFabricService コマンドレットは、実行中の Service Fabric サービスのプロパティを更新します。 更新できるプロパティのセットは、サービスの作成時に指定されたプロパティのサブセットです (使用またはNew-ServiceFabricServiceFromTemplate
使用New-ServiceFabricService
)。
Get-ServiceFabricServiceDescription を使用して、サービスの現在のプロパティを取得できます。
実行中のサービスのプロパティの更新は、 Start-ServiceFabricApplicationUpgrade を使用したサービスのアップグレードとは異なる点に注意してください。サービス (アプリケーション) のアップグレードは、アプリケーションを一度に 1 つのバージョンから別のバージョンに 1 つのアップグレード ドメインに移動する、実行時間の長いバックグラウンド タスクです。 詳細については、「 Service Fabric アプリケーションのアップグレード 」を参照してください。
Service Fabric クラスターで操作を実行する前に、 Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。
例
例 1: ステートフル サービスを更新する
PS C:\> Update-ServiceFabricService -Stateful fabric:/myapp/test -MinReplicaSetSize 3 -TargetReplicaSetSize 5
このコマンドは、実行中の Fabric Service の MinReplicaSetSize と TargetReplicaSetSize を 3 (3) と 5 (5) に更新します。
例 2: ステートレス サービスを更新する
PS C:\> Update-ServiceFabricService -Stateless fabric:/myapp/test -InstanceCount -1
このコマンドは、実行中の Fabric Service のインスタンス数を -1 に更新します。
例 3: 配置の制約を更新する
PS C:\> Update-ServiceabricService -Stateless -ServiceName fabric:/myapp/test -PlacementConstraints "NodeName!=NodeBar"
このコマンドは、配置の制約を更新します。
例 4: 既定の読み込みメトリックを更新する
PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -Metric @("CPU,High,10")
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Metric @("CPU,High,10,1")
最初のコマンドは、ステートレス サービスの既定の読み込みメトリックを更新します。
2 番目のコマンドは、ステートフル サービスの既定の読み込みメトリックを更新します。
例 5: 配置ポリシーを更新する
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -PlacementPolicy @("InvalidDomain,fd:/dc2/rack2")
このコマンドは、配置ポリシーを更新します。
例 6: サービスの関連付けの更新
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Correlation @("fabric:/app/test2,AlignedAffinity")
このコマンドは、サービスの関連付けを更新します。
例 7: サービス DNS 名を更新する
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -ServiceDnsName stateful.dns
PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -ServiceDnsName stateless.dns
このコマンドは、サービスのサービス DNS 名を更新します。 注: 更新された DNS 名が既にクラスターで照会されているか、更新中のサービスに DNS 名が既に含まれている場合は、キャッシュを無効にするために、更新後に DNS サービスを再起動する必要があります。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Correlation
このサービスの相関制約の更新された配列を指定します。 サービスの関連付けの詳細については、 Service Fabric でのサービス アフィニティの構成と使用に関するページを参照してください。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultMoveCost
レプリカの作成時に、更新された既定の移動コストを指定します。 このパラメーターの有効値は、次のとおりです。
- ゼロ
- 低
- Medium
- 高
移動コストの詳細については、「クラスター Resource Managerの選択に影響を与えるサービス移動コスト」を参照してください。
型: | String |
指定可能な値: | Zero, Low, Medium, High, VeryHigh |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DropSourceReplicaOnMove
新しいセカンダリ レプリカがビルドを完了する前に、ソースのセカンダリ レプリカを削除できるようにします。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InstanceCloseDelayDuration
アプリケーションのアップグレードの影響を受けるステートレス インスタンスが閉じられるまで待機し、アクティブな要求が正常にドレインできるようにする時間を秒単位で指定します。 この待機期間は、InstanceCloseDelayDuration に対してゼロ以外の値が構成され、事前に構成された値をオーバーライドするステートレス サービスのインスタンスに対してのみ有効です。 詳細については 、InstanceCloseDelayDuration を参照してください。 ステートフル サービスには、このパラメーターを指定しないでください。
型: | TimeSpan |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InstanceCount
Service Fabric ステートレス サービスの更新されたインスタンス数を指定します。 ステートフル サービスには、このパラメーターを指定しないでください。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InstanceLifecycleDescription
このサービスに属するインスタンスのライフサイクルの説明。 このセクションの一部の構成が指定されていない場合、既定値は同じ名前のクラスター パラメーターから取得されます (存在する場合)。
型: | InstanceLifecycleDescription |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InstanceRestartWaitDuration
ステートレス インスタンスがダウンすると、このタイマーが開始されます。 有効期限が切れると、Service Fabric はクラスター内の任意のノードに新しいインスタンスを作成します。 この構成は、インスタンスが短時間で復旧する可能性が高い状況で、新しいインスタンスの不要な作成を減らすことです。 たとえば、アップグレード中などです。 既定値は 0 です。これは、ステートレス インスタンスがダウンすると、Service Fabric がすぐに置換のビルドを開始することを示します。
型: | TimeSpan |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Metric
サービスが報告するメトリックの更新された配列を指定します。 メトリックの詳細については、「メトリック を使用した Service Fabric でのリソースの消費と読み込みの管理」を参照してください。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MinInstanceCount
ステートレス サービス パーティションのインスタンスの更新された最小数を指定します。 詳細については、 MinInstanceCount (in New-ServiceFabricService
) を参照してください。 ステートフル サービスには、このパラメーターを指定しないでください。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MinInstancePercentage
ステートレス サービス パーティションの InstanceCount の更新された最小パーセンテージを指定します。 詳細については、 MinInstancePercentage (in New-ServiceFabricService
) を参照してください。 ステートフル サービスには、このパラメーターを指定しないでください。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MinReplicaSetSize
Service Fabric ステートフル サービスの更新された最小レプリカ セット サイズを指定します。 この値は、このサービスの TargetReplicaSetSize より小さくする必要があります。 詳細については、「 StatefulServiceDescription.MinReplicaSetSize」を参照してください。
ステートレス サービスには、このパラメーターを指定しないでください。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PartitionNamesToAdd
{{Fill PartitionNamesToAdd Description}}
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PartitionNamesToRemove
{{Fill PartitionNamesToRemove Description}}
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PlacementConstraints
サービスの更新された配置の制約を指定します。 配置の制約の詳細については、「 配置の制約とノードのプロパティ」を参照してください。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PlacementPolicy
サービスの配置ポリシーの更新された配列を指定します。 PlacementPolicy の詳細については、 Service Fabric サービスの配置ポリシーに関するページを参照してください。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-QuorumLossWaitDuration
Service Fabric がサービス パーティションのデータ損失を宣言する前に待機する更新期間を TimeSpan オブジェクトとして指定します。
TimeSpan オブジェクトを取得するには、New-TimeSpan コマンドレットを使用します。
詳細を表示するには「Get-Help New-TimeSpan
」を入力します。
QuorumLossWaitDuration パラメーターの詳細については、「 StatefulServiceDescription.QuorumLossWaitDuration」を参照してください。
型: | TimeSpan |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ReplicaLifecycleDescription
このサービスに属するレプリカのライフサイクルの説明。 このセクションの一部の構成が指定されていない場合、既定値は同じ名前のクラスター パラメーターから取得されます (存在する場合)。
型: | ReplicaLifecycleDescription |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ReplicaRestartWaitDuration
更新された間隔を TimeSpan オブジェクトとして指定します。Service Fabric はレプリカの再起動を待機してから、置換レプリカを作成します。 TimeSpan オブジェクトを取得するには、New-TimeSpan コマンドレットを使用します。
QuorumLossWaitDuration の詳細については、「 StatefulServiceDescription.ReplicaRestartWaitDuration」を参照してください。
型: | TimeSpan |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ScalingPolicies
{{Fill ScalingPolicies Description}}
型: | System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ServiceDnsName
サービスの更新された DNS 名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ServiceName
プロパティを更新する必要がある Service Fabric サービスの URI を指定します。
型: | Uri |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ServicePlacementTimeLimit
サービス配置の時間制限を設定します。
型: | TimeSpan |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-StandByReplicaKeepDuration
更新されたスタンバイ レプリカの継続時間を TimeSpan オブジェクトとして指定します。
QuorumLossWaitDuration の詳細については、「 StatefulServiceDescription.StandByReplicaKeepDuration」を参照してください。
型: | TimeSpan |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Stateful
サービスが Service Fabric ステートフル サービスであることを示します。
型: | SwitchParameter |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Stateless
サービスが Service Fabric ステートレス サービスであることを示します。
型: | SwitchParameter |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TagsRequiredToPlace
サービスの配置に必要なタグを宣言します。 サービスの配置に動的に影響を与える場合に便利です。 詳細については、「 Service Fabric 動的ノード タグ」を参照してください。
型: | System.Collections.Generic.List`1[System.String] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TagsRequiredToRun
サービスの配置と実行に必要なタグを宣言します。 サービスの配置と実行に動的に影響を与える場合に便利です。 詳細については、「Service Fabric 動的ノード タグ」を参照してください。
型: | System.Collections.Generic.List`1[System.String] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TargetReplicaSetSize
Service Fabric ステートフル サービスの更新されたターゲット レプリカ セット サイズを指定します。 詳細については、「 StatefulServiceDescription.TargetReplicaSetSize」を参照してください。
ステートレス サービスには、このパラメーターを指定しないでください。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TimeoutSec
操作のタイムアウト期間を秒単位で指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
System.Uri
出力
System.Object