Freigeben über

Update-ServiceFabricApplication

  • Referenz
Modul:
ServiceFabric

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