New-ServiceFabricApplication

  • Referens
Modul:
ServiceFabric

Skapar ett Service Fabric-program.

Syntax

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

Description

Cmdleten New-ServiceFabricApplication skapar ett Service Fabric-program av en registrerad programtyp. Använd cmdleten Register-ServiceFabricApplicationType för att registrera en programtyp.

Innan du utför någon åtgärd i ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster .

Exempel

Exempel 1: Skapa ett program

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

Det här kommandot skapar ett program av typen PersistentToDoListApp. Programmet är version 1.0. Programtyp och version kommer från programmanifestet i programpaketet som användes när programmet registrerades med hjälp av cmdleten Register-ServiceFabricApplicationType .

Exempel 2: Skapa ett program genom att åsidosätta standardparametervärden i programmanifestet

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

Det här kommandot skapar ett program av typen PersistentToDoListApp och version 1.0 med åsidosatta värden för parametrarna CustomParameter1 och CustomParameter2. Dessa parameternamn måste finnas i programmanifestet för programpaketet som användes när programmet registrerades med hjälp av cmdleten Register-ServiceFabricApplicationType .

Parametrar

-ApplicationName

Anger URI (Uniform Resource Identifier) för ett Service Fabric-program. Cmdleten skapar ett Service Fabric-program med det namn som du anger.

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

-ApplicationParameter

Anger åsidosättningar för programparametrar som definierats i programmanifestet som nyckel/värde-par. Cmdleten skapar ett Service Fabric-program av programtypen och använder de åsidosatta värdena för dessa parametrar. Parametrarna som åsidosätts här måste finnas i programmanifestet.

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

-ApplicationTypeName

Anger namnet på en Service Fabric-programtyp. Cmdleten skapar ett Service Fabric-program av den programtyp som du anger.

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

-ApplicationTypeVersion

Anger versionen av en Service Fabric-programtyp. Cmdleten skapar ett program som har den version som du anger.

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

-MaximumNodes

Anger det maximala antalet noder som ett program ska placeras på. Värdet för den här parametern måste vara ett heltal som inte är negativt. Standardvärdet är 0, vilket indikerar att programmet kan placeras på valfritt antal noder i klustret.

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

-Metrics

Anger en matris med mått. Dessa mått används av Service Fabric-kluster Resource Manager för att hantera resurser i klustret. Mer information om mått och resurshantering i Service Fabric finns i Service Fabric-kluster Resource Manager Introduktion. Varje mått kan följa mönstret MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity eller ange MetricName och använda parameternamnen NodeReservationCapacity, MaximumNodeCapacity eller TotalApplicationCapacity följt av ett parametervärde och avgränsas med ett kolon. Varje parameternamn:värdepar kan visas högst en gång.

  • MetricName. Anger namnet på måttet.
  • NodeReservationCapacity. Anger mängden måttbelastning som är reserverad på noder som har instanser av det här programmet. Om MinimumNodes anges är produkten av dessa värden den kapacitet som är reserverad i klustret för programmet.
  • MaximumNodeCapacity. Anger den maximala belastningen för en instans av det här programmet på en enda nod. Även om nodens kapacitet är större än det här värdet begränsar Service Fabric den totala belastningen för programmets underordnade repliker till det här värdet.
  • TotalApplicationCapacity. Anger den totala kapaciteten för programmet i klustret. Service Fabric försöker begränsa summan av belastningen på programmets underordnade repliker till det här värdet.

När du skapar programmet utför Service Fabric följande valideringar och misslyckas med kommandot om de inte godkänns:

  • NodeReservationCapacity får inte vara mer än MaximumNodeCapacity.

  • Om både parametern MinimumNodes och NodeReservationCapacity har angetts får produkten MinimumNodes och NodeReservationCapacity inte vara mer än TotalApplicationCapacity. Mer information finns i Programmått, belastning och kapacitet

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

-MinimumNodes

Anger det minsta antalet noder där Service Fabric reserverar kapacitet för det här programmet. Det innebär inte att programmet garanteras ha repliker på alla dessa noder. Värdet för den här parametern måste vara ett heltal som inte är negativt. Standardvärdet för detta är noll, vilket innebär att ingen kapacitet är reserverad för programmet.

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

-TimeoutSec

Anger tidsgränsen i sekunder för åtgärden.

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

Indata

None

Utdata

System.Object