New-ServiceFabricApplication

  • 參考
模組:
ServiceFabric

建立 Service Fabric 應用程式。

Syntax

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

Description

New-ServiceFabricApplication Cmdlet 會建立已註冊應用程式類型的 Service Fabric 應用程式。 使用 Register-ServiceFabricApplicationType Cmdlet 來註冊應用程式類型。

在 Service Fabric 叢集上執行任何作業之前，請先使用 Connect-ServiceFabricCluster Cmdlet 建立叢集的連線。

範例

範例 1：建立應用程式

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

此命令會建立 PersistentToDoListApp 類型的應用程式。 應用程式為 1.0 版。 應用程式類型和版本來自應用程式套件中的應用程式資訊清單，使用 Register-ServiceFabricApplicationType Cmdlet 註冊應用程式時所使用的應用程式資訊清單。

範例 2：在應用程式資訊清單中覆寫預設參數值來建立應用程式

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

此命令會建立 PersistentToDoListApp 類型和 1.0 版的應用程式，並覆寫 CustomParameter1 和 CustomParameter2 參數的值。 這些參數名稱必須存在於使用 Register-ServiceFabricApplicationType Cmdlet 註冊應用程式時所使用之應用程式封裝的應用程式資訊清單中。

參數

-ApplicationName

指定 Service Fabric 應用程式的統一資源識別項 (URI) 。 Cmdlet 會使用您指定的名稱來建立 Service Fabric 應用程式。

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

-ApplicationParameter

指定應用程式資訊清單中定義為索引鍵/值組之應用程式參數的覆寫。 Cmdlet 會建立應用程式類型的 Service Fabric 應用程式，並使用這些參數的覆寫值。 在此覆寫的參數必須存在於應用程式資訊清單中。

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

-ApplicationTypeName

指定 Service Fabric 應用程式類型的名稱。 Cmdlet 會建立您指定之應用程式類型的 Service Fabric 應用程式。

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

-ApplicationTypeVersion

指定 Service Fabric 應用程式類型的版本。 Cmdlet 會建立具有您所指定版本的應用程式。

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 ，後面接著參數值，並以冒號分隔。 每個參數 名稱：值 組最多可以出現一次。

  • MetricName。 指定計量的名稱。
  • NodeReservationCapacity。 指定在具有此應用程式實例的節點上保留的計量負載量。 如果指定 MinimumNodes ，這些值的乘積就是應用程式叢集中保留的容量。
  • MaximumNodeCapacity。 指定單一節點上此應用程式實例的最大負載。 即使節點的容量大於此值，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 將為此應用程式保留容量的節點數目下限，這並不表示應用程式保證在所有這些節點上都有複本。 此參數的值必須是非負整數。 這個 的預設值為零，這表示不會保留任何容量給應用程式。

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