New-ServiceFabricApplication

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

Service Fabric アプリケーションを作成します。

構文

New-ServiceFabricApplication
   [-ApplicationName] <Uri>
   [-ApplicationTypeName] <String>
   [-ApplicationTypeVersion] <String>
   [-ApplicationParameter <Hashtable>]
   [-MaximumNodes <Int64>]
   [-MinimumNodes <Int64>]
   [-Metrics <String[]>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

説明

New-ServiceFabricApplication コマンドレットは、登録されたアプリケーションの種類の Service Fabric アプリケーションを作成します。 アプリケーションの種類を登録するには、Register-ServiceFabricApplicationType コマンドレットを使用します。

Service Fabric クラスターで操作を実行する前に、Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。

例

例 1: アプリケーションを作成する

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"

このコマンドは、PersistentToDoListApp 型のアプリケーションを作成します。 アプリケーションはバージョン 1.0 です。 アプリケーションの種類とバージョンは、Register-ServiceFabricApplicationType コマンドレットを使用してアプリケーションを登録するときに使用されたアプリケーション パッケージのアプリケーション マニフェストから取得されます。

例 2: アプリケーション マニフェストの既定のパラメーター値をオーバーライドしてアプリケーションを作成する

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}

このコマンドは、CustomParameter1 パラメーターと CustomParameter2 パラメーターのオーバーライドされた値を使用して、PersistentToDoListApp 型とバージョン 1.0 型のアプリケーションを作成します。 これらのパラメーター名は、Register-ServiceFabricApplicationType コマンドレットを使用してアプリケーションを登録するときに使用されたアプリケーション パッケージのアプリケーション マニフェストに存在する必要があります。

パラメーター

-ApplicationName

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

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

-ApplicationParameter

キーと値のペアとしてアプリケーション マニフェストで定義されているアプリケーション パラメーターのオーバーライドを指定します。 コマンドレットは、アプリケーションの種類の Service Fabric アプリケーションを作成し、これらのパラメーターにオーバーライドされた値を使用します。 ここでオーバーライドされるパラメーターは、アプリケーション マニフェストに存在する必要があります。

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

-ApplicationTypeName

Service Fabric アプリケーションの種類の名前を指定します。 このコマンドレットは、指定したアプリケーションの種類の Service Fabric アプリケーションを作成します。

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

-ApplicationTypeVersion

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

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

-MaximumNodes

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

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

-Metrics

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

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

アプリケーションの作成時に、Service Fabric は次の検証を実行し、成功しなかった場合はコマンドを失敗させます。

  • NodeReservationCapacity は MaximumNodeCapacity を超えてはなりません。

  • MinimumNodes パラメーターと NodeReservationCapacity メトリックの両方が指定されている場合、MinimumNodes と NodeReservationCapacity の積は TotalApplicationCapacity を超えてはなりません。 詳細については、「アプリケーション メトリック、負荷、容量 を する」を参照してください。

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

-MinimumNodes

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

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

-TimeoutSec

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

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

入力

None

出力

System.Object