New-ServiceFabricApplication

Erstellt eine Service Fabric-Anwendung.

Syntax

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

Beschreibung

Das Cmdlet New-ServiceFabricApplication erstellt eine Service Fabric-Anwendung eines registrierten Anwendungstyps. Verwenden Sie das Cmdlet Register-ServiceFabricApplicationType , um einen Anwendungstyp zu registrieren.

Bevor Sie einen Vorgang in einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Erstellen einer Anwendung

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

Dieser Befehl erstellt eine Anwendung des Typs PersistentToDoListApp. Die Anwendung ist Version 1.0. Der Anwendungstyp und die Version stammen aus dem Anwendungsmanifest im Anwendungspaket, das beim Registrieren der Anwendung mithilfe des Cmdlets Register-ServiceFabricApplicationType verwendet wurde.

Beispiel 2: Erstellen einer Anwendung durch Außerkraftsetzen von Standardwerten im Anwendungsmanifest

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

Dieser Befehl erstellt eine Anwendung des Typs PersistentToDoListApp und Version 1.0 mit überschriebenen Werten für Parameter CustomParameter1 und CustomParameter2. Diese Parameternamen müssen im Anwendungsmanifest des Anwendungspakets vorhanden sein, das beim Registrieren der Anwendung mithilfe des Cmdlets Register-ServiceFabricApplicationType verwendet wurde.

Parameter

-ApplicationName

Gibt den URI (Uniform Resource Identifier) einer Service Fabric-Anwendung an. Das Cmdlet erstellt eine Service Fabric-Anwendung mit dem namen, den Sie angeben.

Typ:Uri
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplicationParameter

Gibt die Außerkraftsetzungen für Anwendungsparameter an, die im Anwendungsmanifest als Schlüssel-/Wertpaare definiert sind. Das Cmdlet erstellt eine Service Fabric-Anwendung des Anwendungstyps und verwendet die überschriebenen Werte für diese Parameter. Die hier überschriebenen Parameter müssen im Anwendungsmanifest vorhanden sein.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplicationTypeName

Gibt den Namen eines Service Fabric-Anwendungstyps an. Das Cmdlet erstellt eine Service Fabric-Anwendung des von Ihnen angegebenen Anwendungstyps.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplicationTypeVersion

Gibt die Version eines Service Fabric-Anwendungstyps an. Das Cmdlet erstellt eine Anwendung mit der von Ihnen angegebenen Version.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaximumNodes

Gibt die maximale Anzahl von Knoten an, auf denen eine Anwendung platziert werden soll. Der Wert dieses Parameters muss eine nicht negative ganze Zahl sein. Der Standardwert ist 0, der angibt, dass die Anwendung auf einer beliebigen Anzahl von Knoten im Cluster platziert werden kann.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Metrics

Gibt ein Array von Metriken an. Diese Metriken werden von Service Fabric Cluster Resource Manager verwendet, um Ressourcen im Cluster zu verwalten. Weitere Informationen zu Metriken und Ressourcenverwaltung in Service Fabric finden Sie unter Service Fabric Cluster Resource Manager Einführung. Jede Metrik kann dem Muster MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity folgen oder MetricName angeben und Parameternamen NodeReservationCapacity, MaximumNodeCapacity oder TotalApplicationCapacity gefolgt von einem Parameterwert angeben und durch einen Doppelpunkt getrennt werden. Jedes Parametername:Value-Paar kann höchstens einmal angezeigt werden.

  • MetricName. Gibt den Namen der Metrik an.
  • NodeReservationCapacity. Gibt die Menge der Metriklast an, die für Knoten reserviert ist, die Instanzen dieser Anwendung aufweisen. Wenn MinimumNodes angegeben ist, ist das Produkt dieser Werte die Kapazität im Cluster für die Anwendung reserviert.
  • MaximumNodeCapacity. Gibt die maximale Last für eine Instanz dieser Anwendung auf einem einzelnen Knoten an. Auch wenn die Kapazität des Knotens größer als dieser Wert ist, beschränkt Service Fabric die Gesamtlast der untergeordneten Replikate der Anwendung auf diesen Wert.
  • TotalApplicationCapacity. Gibt die Gesamtkapazität für die Anwendung im Cluster an. Service Fabric versucht, die Summe der Lasten der untergeordneten Replikate der Anwendung auf diesen Wert zu beschränken.

Beim Erstellen der Anwendung führt Service Fabric die folgenden Überprüfungen aus und schlägt den Befehl fehl, wenn sie nicht übergeben werden:

  • NodeReservationCapacity darf nicht mehr als MaximumNodeCapacity sein.

  • Wenn sowohl der Parameter MinimumNodes als auch die NodeReservationCapacity-Metrik angegeben sind, darf das Produkt von MinimumNodes und NodeReservationCapacity nicht mehr als TotalApplicationCapacity sein. Weitere Informationen finden Sie unter Anwendungsmetriken, Last und Kapazität

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MinimumNodes

Gibt die Mindestanzahl von Knoten an, bei denen Service Fabric kapazität für diese Anwendung reserviert, bedeutet dies nicht, dass die Anwendung garantiert Replikate auf allen diesen Knoten hat. Der Wert dieses Parameters muss eine nicht negative ganze Zahl sein. Der Standardwert für dies ist null, was bedeutet, dass keine Kapazität für die Anwendung reserviert ist.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutzeitraum in Sekunden für den Vorgang an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object