Update-ServiceFabricApplication

  • リファレンス
モジュール:
ServiceFabric

アプリケーション容量を更新または削除します。

構文

Update-ServiceFabricApplication
      [-ApplicationName] <Uri>
      [-RemoveApplicationCapacity]
      [-MaximumNodes <Int64>]
      [-MinimumNodes <Int64>]
      [-Metrics <String[]>]
      [-TimeoutSec <Int32>]
      [<CommonParameters>]

説明

Update-ServiceFabricApplication コマンドレットは、既に作成されているアプリケーションのアプリケーション容量を更新または削除します。

アプリケーション容量は、アプリケーションの最大/最小ノードと、そのメトリックのノードあたりの容量を定義します。

例

例 1: MaximumNodes とメトリックの更新

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @("CPU,2,12,16")

このコマンドは、最大 6 つのノードを使用するようにアプリケーション ファブリック:/MyApp を更新します。 各ノードの予約負荷は 2 ユニットで、各ノードの CPU メトリックの最大負荷は 12 ユニットです。 合計アプリケーション容量は、CPU メトリックに対して 16 ユニットです。 MinimumNodes の値は変更されません。

例 2: MaximumNodes の更新とメトリックのリセット

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @()

このコマンドは、最大 6 つのノードを使用するように Application Fabric:/MyApp を更新し、すべてのメトリックの容量を削除します。 以前に定義された容量がある場合は、このコマンドの後にクリアされます。 MinimumNodes の値は変更されません。

例 3: すべてのアプリケーション容量パラメーターを更新する

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MinumumNodes 2 -MaximumNodes 6 -Metrics @("CPU,2,12,16")

このコマンドは、最大 6 つのノードを使用するようにアプリケーション ファブリック:/MyApp を更新します。 各ノードの予約負荷は 2 ユニットで、各ノードのメトリック CPU の最大負荷は 12 ユニットです。 合計アプリケーション容量は、CPU メトリックに対して 16 ユニットです。 最小ノードの値は 2 に更新され、Service Fabric はクラスター内の CPU メトリックに対して合計 4 ユニットの容量を予約します。

例 4: すべてのアプリケーション容量パラメーターを削除する

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -RemoveApplicationCapacity

このコマンドは、アプリケーションの容量パラメーターが定義されないように、アプリケーション ファブリック:/MyApp を更新します。 MyApp に以前に容量パラメーターが設定されていた場合、この操作によってそれらのパラメーターがクリアされます。

パラメーター

-ApplicationName

更新するアプリケーションの名前を指定します。

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

-MaximumNodes

アプリケーションを配置するノードの最大数を指定します。 このパラメーターの値は、負以外の整数である必要があります。 既定値は 0 です。これは、クラスター内の任意の数のノードにアプリケーションを配置できることを示します。

このパラメーターを指定しない場合、アプリケーションはアプリケーションに設定されたノードの既存の最大数を使用します。

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

-Metrics

メトリックの配列を指定します。 これらのメトリックは、Service Fabric クラスター Resource Managerによってクラスター内のリソースを管理するために使用されます。 Service Fabric のメトリックとリソース管理の詳細については、「Service Fabric クラスター Resource Manager概要」を参照してください。 各メトリックは、MetricName、NodeReservationCapacity、MaximumNodeCapacity、TotalApplicationCapacity、または MetricName を指定し、パラメーター名 NodeReservationCapacity、MaximumNodeCapacity、TotalApplicationCapacity、TotalApplicationCapacity の後にコロンで区切られたパラメーター値を使用できます。 各パラメーター 名と値の ペアは、最大で 1 回だけ表示できます。

  • MetricName。 メトリックの名前を指定します。
  • NodeReservationCapacity。 このアプリケーションのインスタンスを持つノードで予約されているメトリック負荷の量を指定します。 MinimumNodes が指定されている場合、これらの値の積は、アプリケーションのクラスターに予約されている容量です。
  • MaximumNodeCapacity。 1 つのノードでのこのアプリケーションのインスタンスの最大負荷を指定します。 ノードの容量がこの値より大きい場合でも、Service Fabric はアプリケーションの子レプリカの総負荷をこの値に制限します。
  • TotalApplicationCapacity。 クラスター内のアプリケーションの合計容量を指定します。 Service Fabric は、アプリケーションの子レプリカの負荷の合計をこの値に制限しようとします。

容量の更新中、Service Fabric は次の検証を実行し、失敗した場合はコマンドを失敗します。

  • NodeReservationCapacity は MaximumNodeCapacity を超えてはなりません。
  • MinimumNodes パラメーターと NodeReservationCapacity メトリックの両方が指定されている場合、MinimumNodes と NodeReservationCapacity の積は TotalApplicationCapacity を超えてはなりません。
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumNodes

このアプリケーション用に容量が予約されているクラスター内のノードの数を指定します。これは、アプリケーションがそれらのすべてのノードにレプリカがあることを保証することを意味するものではありません。 このパラメーターの値は、負以外の整数である必要があります。 この既定値は 0 です。つまり、アプリケーション用に容量が予約されていないことを意味します。

MinimumNodes が 0 に設定されている場合、容量は予約されません。

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

-RemoveApplicationCapacity

この操作によって、アプリケーションのアプリケーション容量に関連するすべてのパラメーターがクリアされることを示します。 このパラメーターを指定した場合、アプリケーション容量を更新するための Metrics パラメーターを指定することはできません。

Type:SwitchParameter
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

入力

None

出力

System.Object