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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Correlation

このサービスの相関制約の更新された配列を指定します。 サービスの関連付けの詳細については、 Service Fabric でのサービス アフィニティの構成と使用に関するページを参照してください。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultMoveCost

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

• ゼロ
• 低
• Medium
• 高

移動コストの詳細については、「クラスター Resource Managerの選択に影響を与えるサービス移動コスト」を参照してください。

Type:	String
Accepted values:	Zero, Low, Medium, High, VeryHigh
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DropSourceReplicaOnMove

新しいセカンダリ レプリカがビルドを完了する前に、ソースのセカンダリ レプリカを削除できるようにします。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceCloseDelayDuration

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

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceCount

Service Fabric ステートレス サービスの更新されたインスタンス数を指定します。 ステートフル サービスには、このパラメーターを指定しないでください。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceLifecycleDescription

このサービスに属するインスタンスのライフサイクルの説明。 このセクションの一部の構成が指定されていない場合、既定値は同じ名前のクラスター パラメーターから取得されます (存在する場合)。

Type:	InstanceLifecycleDescription
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceRestartWaitDuration

ステートレス インスタンスがダウンすると、このタイマーが開始されます。 有効期限が切れると、Service Fabric はクラスター内の任意のノードに新しいインスタンスを作成します。 この構成は、インスタンスが短時間で復旧する可能性が高い状況で、新しいインスタンスの不要な作成を減らすことです。 たとえば、アップグレード中などです。 既定値は 0 です。これは、ステートレス インスタンスがダウンすると、Service Fabric がすぐに置換のビルドを開始することを示します。

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Metric

サービスが報告するメトリックの更新された配列を指定します。 メトリックの詳細については、「メトリック を使用した Service Fabric でのリソースの消費と読み込みの管理」を参照してください。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinInstanceCount

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinInstancePercentage

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinReplicaSetSize

Service Fabric ステートフル サービスの更新された最小レプリカ セット サイズを指定します。 この値は、このサービスの TargetReplicaSetSize より小さくする必要があります。 詳細については、「 StatefulServiceDescription.MinReplicaSetSize」を参照してください。

ステートレス サービスには、このパラメーターを指定しないでください。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlacementConstraints

サービスの更新された配置の制約を指定します。 配置の制約の詳細については、「 配置の制約とノードのプロパティ」を参照してください。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlacementPolicy

サービスの配置ポリシーの更新された配列を指定します。 PlacementPolicy の詳細については、 Service Fabric サービスの配置ポリシーに関するページを参照してください。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-QuorumLossWaitDuration

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

TimeSpan オブジェクトを取得するには、New-TimeSpan コマンドレットを使用します。 詳細を表示するには「Get-Help New-TimeSpan」を入力します。

QuorumLossWaitDuration パラメーターの詳細については、「 StatefulServiceDescription.QuorumLossWaitDuration」を参照してください。

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplicaLifecycleDescription

このサービスに属するレプリカのライフサイクルの説明。 このセクションの一部の構成が指定されていない場合、既定値は同じ名前のクラスター パラメーターから取得されます (存在する場合)。

Type:	ReplicaLifecycleDescription
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplicaRestartWaitDuration

更新された間隔を TimeSpan オブジェクトとして指定します。Service Fabric はレプリカの再起動を待機してから、置換レプリカを作成します。 TimeSpan オブジェクトを取得するには、New-TimeSpan コマンドレットを使用します。

QuorumLossWaitDuration の詳細については、「 StatefulServiceDescription.ReplicaRestartWaitDuration」を参照してください。

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Type:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceDnsName

サービスの更新された DNS 名を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceName

プロパティを更新する必要がある Service Fabric サービスの URI を指定します。

Type:	Uri
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ServicePlacementTimeLimit

サービス配置の時間制限を設定します。

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StandByReplicaKeepDuration

更新されたスタンバイ レプリカの継続時間を TimeSpan オブジェクトとして指定します。

QuorumLossWaitDuration の詳細については、「 StatefulServiceDescription.StandByReplicaKeepDuration」を参照してください。

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Stateful

サービスが Service Fabric ステートフル サービスであることを示します。

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Stateless

サービスが Service Fabric ステートレス サービスであることを示します。

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TagsRequiredToPlace

サービスの配置に必要なタグを宣言します。 サービスの配置に動的に影響を与える場合に便利です。 詳細については、「 Service Fabric 動的ノード タグ」を参照してください。

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TagsRequiredToRun

サービスの配置と実行に必要なタグを宣言します。 サービスの配置と実行に動的に影響を与える場合に便利です。 詳細については、「Service Fabric 動的ノード タグ」を参照してください。

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetReplicaSetSize

Service Fabric ステートフル サービスの更新されたターゲット レプリカ セット サイズを指定します。 詳細については、「 StatefulServiceDescription.TargetReplicaSetSize」を参照してください。

ステートレス サービスには、このパラメーターを指定しないでください。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

System.Uri

出力

System.Object

関連リンク

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