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