Update-ServiceFabricApplication
Aktualisierungen oder entfernt die Anwendungskapazität.
Syntax
Update-ServiceFabricApplication
[-ApplicationName] <Uri>
[-RemoveApplicationCapacity]
[-MaximumNodes <Int64>]
[-MinimumNodes <Int64>]
[-Metrics <String[]>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Update-ServiceFabricApplication aktualisiert oder entfernt die Anwendungskapazität für eine bereits erstellte Anwendung.
Die Anwendungskapazität definiert die maximalen/minimalen Knoten für eine Anwendung sowie die Kapazität pro Knoten für seine Metriken.
Beispiele
Beispiel 1: Aktualisieren von MaximumNodes und Metriken
PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @("CPU,2,12,16")
Dieser Befehl aktualisiert die Anwendungs fabric:/MyApp, um maximal sechs Knoten zu verwenden. Jeder Knoten verfügt über eine reservierte Last von zwei Einheiten und eine maximale Auslastung von 12 Einheiten für die CPU-Metrik für jeden Knoten. Die Gesamtanwendungskapazität beträgt 16 Einheiten für die CPU-Metrik. Der Wert für MinimumNodes bleibt unverändert.
Beispiel 2: Aktualisieren von MaximumNodes und Zurücksetzen von Metriken
PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @()
Dieser Befehl aktualisiert die Anwendungs fabric:/MyApp, um maximal sechs Knoten zu verwenden, und entfernt Kapazitäten für alle Metriken. Wenn zuvor definierte Kapazitäten vorhanden sind, werden sie nach diesem Befehl gelöscht. Der Wert für MinimumNodes ist unverändert.
Beispiel 3: Aktualisieren aller Anwendungskapazitätsparameter
PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MinumumNodes 2 -MaximumNodes 6 -Metrics @("CPU,2,12,16")
Dieser Befehl aktualisiert die Anwendungs fabric:/MyApp, um maximal sechs Knoten zu verwenden. Jeder Knoten verfügt über eine reservierte Last von zwei Einheiten und eine maximale Auslastung von 12 Einheiten für die Metrik-CPU auf jedem Knoten. Die Gesamtanwendungskapazität beträgt 16 Einheiten für die CPU-Metrik. Der Wert für mindestknoten wird auf 2 aktualisiert, sodass Service Fabric eine Gesamtkapazität von vier Einheiten für die CPU-Metrik im Cluster reserviert.
Beispiel 4: Entfernen aller Anwendungskapazitätsparameter
PS C:\> Update-ServiceFabricApplication fabric:/MyApp -RemoveApplicationCapacity
Dieser Befehl aktualisiert die Anwendungs fabric:/MyApp, sodass keine Anwendungskapazitätsparameter definiert sind. Wenn MyApp zuvor Kapazitätsparameter festgelegt hatte, löscht dieser Vorgang sie.
Parameter
-ApplicationName
Gibt den Namen der zu aktualisierenden Anwendung an.
Typ: | Uri |
Position: | 0 |
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.
Wenn Sie diesen Parameter nicht angeben, verwendet die Anwendung die vorhandene maximale Anzahl von Knoten, die für die Anwendung festgelegt sind.
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 oder MetricName folgen und Parameternamen NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity gefolgt von einem Parameterwert angeben, der durch einen Doppelpunkt getrennt ist. 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.
Während der Aktualisierung der Kapazität 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.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-MinimumNodes
Gibt die Anzahl der Knoten in einem Cluster an, auf dem die Kapazität für diese Anwendung reserviert ist, bedeutet dies nicht, dass die Anwendung garantiert Replikate auf allen diesen Knoten aufweist. 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.
Wenn MinimumNodes auf 0 festgelegt ist, ist keine Kapazität reserviert.
Typ: | Int64 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveApplicationCapacity
Gibt an, dass dieser Vorgang alle Parameter im Zusammenhang mit der Anwendungskapazität für die Anwendung löscht. Wenn Sie diesen Parameter angeben, können Sie den Metrikparameter nicht angeben, um die Anwendungskapazität zu aktualisieren.
Typ: | SwitchParameter |
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