New-ServiceFabricApplication
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 アプリケーションの Uniform Resource Identifier (URI) を指定します。 コマンドレットは、指定した名前の Service Fabric アプリケーションを作成します。
| Type: | Uri |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationParameter
キーと値のペアとしてアプリケーション マニフェストで定義されているアプリケーション パラメーターのオーバーライドを指定します。 コマンドレットは、アプリケーションの種類の Service Fabric アプリケーションを作成し、これらのパラメーターにオーバーライドされた値を使用します。 ここでオーバーライドされるパラメーターは、アプリケーション マニフェストに存在する必要があります。
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeName
Service Fabric アプリケーションの種類の名前を指定します。 コマンドレットは、指定したアプリケーションの種類の Service Fabric アプリケーションを作成します。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeVersion
Service Fabric アプリケーションの種類のバージョンを指定します。 このコマンドレットは、指定したバージョンを持つアプリケーションを作成します。
| Type: | String |
| Position: | 2 |
| 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 の後にパラメーター値を指定し、コロンで区切ってパラメーター名を使用できます。 各パラメーター 名と値の ペアは、最大で 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
Service Fabric がこのアプリケーションの容量を予約するノードの最小数を指定します。これは、アプリケーションがそれらのすべてのノードにレプリカがあることを保証することを意味するものではありません。 このパラメーターの値は負以外の整数である必要があります。 この既定値は 0 です。つまり、アプリケーション用に容量が予約されていないことを意味します。
| Type: | Int64 |
| 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