Dela via

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 Register-ServiceFabricApplicationType cmdlet.

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 Register-ServiceFabricApplicationType cmdlet.

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.

Typ:Uri
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationParameter

Anger åsidosättningarna för programpar 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. De parametrar som åsidosätts här måste finnas i programmanifestet.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationTypeName

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

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationTypeVersion

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

Typ:String
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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 anger att programmet kan placeras på valfritt antal noder i klustret.

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Metrics

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

  • MetricName. Anger måttets namn.
  • NodeReservationCapacity. Anger mängden måttbelastning som är reserverad för 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 belastningarna för 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 Måttet NodeReservationCapacity anges får produkten av MinimumNodes och NodeReservationCapacity inte vara mer än TotalApplicationCapacity. Mer information finns i Application Metrics, Load and Capacity

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimeoutSec

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

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

System.Object