Update-ServiceFabricService

モジュール:

ServiceFabric

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-ServiceFabricService または New-ServiceFabricServiceFromTemplateを使用して) サービスの作成時に指定されたプロパティのサブセットです。 Get-ServiceFabricServiceDescription使用して、サービスの現在のプロパティを取得できます。

実行中のサービスのプロパティの更新は、Start-ServiceFabricApplicationUpgradeを使用してサービスをアップグレードする場合とは異なります。サービス (つまりアプリケーション) のアップグレードは、アプリケーションを一度に 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 と 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

レプリカの作成時に、更新された既定の移動コストを指定します。 このパラメーターに使用できる値は次のとおりです。

• ゼロ
• 低い
• 中程度
• 高い

移動コストの詳細については、クラスター リソース マネージャーの選択に影響を与えるサービス移動コストの を参照してください。

型:	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 に対して 0 以外の値が構成され、構成済みの値をオーバーライドするステートレス サービスのインスタンスに対してのみ有効です。 詳細については、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 (New-ServiceFabricService) を参照してください。 ステートフル サービスには、このパラメーターを指定しないでください。

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

-MinInstancePercentage

ステートレス サービス パーティションの InstanceCount の更新された最小割合を指定します。 詳細については、minInstancePercentage () の を参照してください。 ステートフル サービスには、このパラメーターを指定しないでください。

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

更新された期間を、TimeSpan オブジェクトとして指定します。Service Fabric は、サービス パーティションのデータ損失を宣言する前に待機します。

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

関連リンク

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricService
• New-ServiceFabricService
• Remove-ServiceFabricService
• Resolve-ServiceFabricService