Freigeben über

Update-ServiceFabricApplication

  • Referenz
Modul:
ServiceFabric

Aktualisiert oder entfernt die Anwendungskapazität.

Syntax

Update-ServiceFabricApplication
      [-ApplicationName] <Uri>
      [-RemoveApplicationCapacity]
      [-MaximumNodes <Int64>]
      [-MinimumNodes <Int64>]
      [-Metrics <String[]>]
      [-TimeoutSec <Int32>]
      [<CommonParameters>]

Beschreibung

Die Update-ServiceFabricApplication Cmdlet-Updates oder entfernt die Anwendungskapazität für eine Anwendung, die bereits erstellt wurde.

Die Anwendungskapazität definiert die maximalen/minimalen Knoten für eine Anwendung sowie die Kapazität pro Knoten für die zugehörigen Metriken.

Beispiele

Beispiel 1: Aktualisieren von MaximumNodes und Metriken

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @("CPU,2,12,16")

Mit diesem Befehl wird die Anwendungs fabric:/MyApp aktualisiert, 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 auf jedem Knoten. Die Gesamtkapazität der Anwendung 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 so, dass maximal sechs Knoten verwendet werden, und die Kapazitäten für alle Metriken werden entfernt. 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")

Mit diesem Befehl wird die Anwendungs fabric:/MyApp aktualisiert, um maximal sechs Knoten zu verwenden. Jeder Knoten verfügt über eine reservierte Last von zwei Einheiten und eine maximale Last von 12 Einheiten für die Metrik CPU auf jedem Knoten. Die Gesamtkapazität der Anwendung beträgt 16 Einheiten für die CPU-Metrik. Der Wert für minimale Knoten 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

Mit diesem Befehl wird die Anwendungs fabric:/MyApp aktualisiert, sodass keine Anwendungskapazitätsparameter definiert sind. Wenn MyApp zuvor Kapazitätsparameter festgelegt hat, 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 vom Service Fabric Cluster Resource Manager zum Verwalten von Ressourcen im Cluster verwendet. Weitere Informationen zu Metriken und Ressourcenverwaltung in Service Fabric finden Sie in Service Fabric Cluster Resource Manager Einführung. Jede Metrik kann dem Muster MetricName,NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity folgen oder MetricName angeben und Parameternamen NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity gefolgt von einem Parameterwert angeben, der durch einen Doppelpunkt getrennt ist. Jeder Parameter name: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 wird, ist das Produkt dieser Werte die im Cluster für die Anwendung reservierte Kapazität.
  • 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, schränkt Service Fabric die Gesamtlast der untergeordneten Replikate der Anwendung auf diesen Wert ein.
  • 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 durch und schlägt den Befehl fehl, wenn sie nicht bestehen:

  • NodeReservationCapacity darf nicht mehr sein als MaximumNodeCapacity.
  • Wenn sowohl die MinimumNodes Parameter als auch die NodeReservationCapacity-Metrik angegeben werden, 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, für die kapazität für diese Anwendung reserviert ist, 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 diesen Wert 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 parameter Metrics 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 für den Vorgang in Sekunden an.

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

Eingaben

None

Ausgaben

System.Object