Freigeben über

Update-ServiceFabricClusterUpgrade

  • Referenz
Modul:
ServiceFabric

Ändert die Upgradebeschreibung eines aktiven Clusterupgrades.

Syntax

Update-ServiceFabricClusterUpgrade
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-MaxPercentUnhealthyApplications <Byte>]
      [-MaxPercentUnhealthyNodes <Byte>]
      [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
      [-EnableDeltaHealthEvaluation <Boolean>]
      [-MaxPercentDeltaUnhealthyNodes <Byte>]
      [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
      [-Force]
      [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das cmdlet Update-ServiceFabricClusterUpgrade ändert die Parameter einer Clusterupgradebeschreibung, während das Upgrade noch aktiv ist. Service Fabric erkennt und wendet die Änderungen gemäß dem FabricUpgradeStatusPollInterval Wert an, wie im Clustermanifest angegeben. Mit Ausnahme von Integritätsauswertungsrichtlinien aktualisiert dieses Cmdlet nur die parameter, die Sie angeben. Nicht angegebene Parameter bleiben unberührt. Sie müssen die folgenden Richtlinien für die Integritätsauswertung zusammen aktualisieren, nicht einzeln:

  • ConsiderWarningAsError
  • MaxPercentUnhealthyApplications
  • MaxPercentUnhealthyNodes

Um Service Fabric-Cluster zu verwalten, starten Sie Windows PowerShell mithilfe der Option "Als Administrator ausführen". Bevor Sie einen Vorgang auf einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Aktualisieren eines Werts für ein Clusterupgrade

PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0

Mit diesem Befehl wird für ein ausstehendes Clusterupgrade der Replikatsatz-Timeoutzeitraum auf 0 festgelegt. Das Update lässt alle anderen Upgradewerte allein.

Beispiel 2: Aktualisieren der Integritätsrichtlinie für ein Clusterupgrade

PS C:\> $svcType = New-Object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
PS C:\> $svcType.MaxPercentUnhealthyPartitionsPerService = 100
PS C:\> $systemAppPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
PS C:\> $systemAppPolicy.DefaultServiceTypeHealthPolicy = $svcType
PS C:\> $appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
PS C:\> $appHealthPolicyMap.Add("fabric:/System", $systemAppPolicy)

PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)

PS C:\> Update-ServiceFabricClusterUpgrade -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -Force -MaxPercentUnhealthyApplications 20 -ApplicationHealthPolicyMap $appHealthPolicyMap

Mit diesem Befehl wird die Clusterintegritätsrichtlinie für Clusterupgrade geändert. Sie gibt die Zuordnung der Anwendungstypintegritätsrichtlinie an, die den Anwendungstyp CriticalAppType enthält, der keine Fehler toleriert. Die restlichen Anwendungen werden mit 20% maximal fehlerhaften Prozent ausgewertet.

Der Befehl aktualisiert auch die Anwendungsintegritätsrichtlinie, die zum Auswerten von Fabric:/Systemanwendung als Teil der Clusterupgradeintegritätsbewertung verwendet wird. Die neuen Richtlinien tolerieren alle Partitionsfehler.

Parameter

-ApplicationHealthPolicyMap

Gibt eine System.Fabric.Health.ApplicationHealthPolicyMap an, die benutzerdefinierte Integritätsrichtlinien für einige oder alle Anwendungen enthält. Wenn Sie diesen Parameter nicht angeben oder keinen Eintrag in die Zuordnung für eine Anwendung einschließen, wird diese Anwendung mit der im Anwendungsmanifest definierten Anwendungsintegritätsrichtlinie ausgewertet, sofern vorhanden, oder die Standardrichtlinie.

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

-ApplicationTypeHealthPolicyMap

Gibt die Zuordnung an, die den maximalen Prozentsatz von fehlerhaften Anwendungen definiert, die pro Anwendungstyp zulässig sind. Anwendungstypen in dieser Zuordnung werden mithilfe bestimmter Prozentsätze und nicht mit dem globalen MaxPercentUnhealthyApplications Prozentsatz ausgewertet.

Wenn beispielsweise einige Anwendungen eines Typs kritisch sind, kann der Clusteradministrator der Zuordnung für diesen Anwendungstyp einen Eintrag hinzufügen und ihm den Wert 0% zuweisen (d. h. keine Fehler tolerieren). Alle anderen Anwendungen können mit MaxPercentUnhealthyApplications ausgewertet werden, auf 20% festgelegt sind, um einige Fehler aus den Tausenden von Anwendungsinstanzen zu tolerieren.

Die Zuordnung der Anwendungstypintegritätsrichtlinien wird nur verwendet, wenn das Clustermanifest die Bewertung des Anwendungstyps mithilfe des Konfigurationseintrags für HealthManager/EnableApplicationTypeHealthEvaluationermöglicht.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConsiderWarningAsError

Gibt an, ob ein Warnungsstatusbericht während der Integritätsauswertung als Fehler behandelt werden soll.

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

-EnableDeltaHealthEvaluation

Gibt an, ob Delta-Integritätsprüfungen während der Integritätsauswertung in überwachten Upgrades aktiviert werden sollen. Wenn Sie einen Wert von $True angeben, nimmt Service Fabric am Anfang des Upgrades eine Momentaufnahme des Status an. Nachdem jede Upgradedomäne das Upgrade abgeschlossen hat, vergleichen die Integritätsprüfungen den aktuellen Status des Clusters mit der Momentaufnahme. Wenn es eine Integritätsverschlechterung gibt, die die maximal zulässigen Prozentsätze aus der aktuellen Integritätsrichtlinie für Clusterupgrades nicht berücksichtigt, schlagen die Integritätsprüfungen fehl.

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

-FailureAction

Gibt die auszuführende Aktion an, wenn das überwachte Upgrade fehlschlägt. Die zulässigen Werte für diesen Parameter sind:

  • Rollback
  • Manuell.
Typ:UpgradeFailureAction
Zulässige Werte:Invalid, Rollback, Manual
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Gibt an, dass dieses Cmdlet die Warnmeldung überspringt und das Update erzwingt.

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

-ForceRestart

Gibt an, ob der Service Fabric-Knoten neu gestartet werden soll, auch wenn sich nur dynamische Konfigurationen geändert haben.

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

-HealthCheckRetryTimeoutSec

Gibt die Dauer in Sekunden an, nach der Service Fabric die Integritätsprüfung erneut überprüft, wenn die vorherige Integritätsprüfung fehlschlägt.

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

-HealthCheckStableDurationSec

Gibt die Dauer in Sekunden an, die Service Fabric wartet, um zu überprüfen, ob der Cluster stabil ist, bevor er mit der nächsten Upgradedomäne fortsetzt oder das Upgrade abgeschlossen. Diese Wartezeit verhindert nicht erkannte Integritätsänderungen direkt nach der Ausführung der Integritätsprüfung.

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

-HealthCheckWaitDurationSec

Gibt die Dauer in Sekunden an, die Service Fabric wartet, bevor die anfängliche Integritätsprüfung ausgeführt wird, nachdem das Upgrade für die Upgradedomäne abgeschlossen wurde.

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

-InstanceCloseDelayDurationSec

Gibt die Dauer in Sekunden an, um zu warten, bevor eine zustandslose Instanz, die durch das Clusterupgrade beeinträchtigt wird, geschlossen wird, damit die aktiven Anforderungen ordnungsgemäß abgelassen werden können. Diese Wartezeit ist nur für die Instanzen dieser zustandslosen Dienste wirksam, die einen Wert ungleich Null für instanceCloseDelayDuration konfiguriert haben und den vorkonfigurierten Wert außer Kraft setzen. Weitere Informationen finden Sie unter InstanceCloseDelayDuration.

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

-MaxPercentDeltaUnhealthyNodes

Gibt den maximal tolerierten Prozentsatz der fehlerhaften Delta-Knoten an, die aggregierte Integritätszustände aufweisen können. Wenn die aktuellen fehlerhaften Knoten den Prozentsatz relativ zum Zustand am Anfang des Upgrades nicht respektieren, ist der Cluster nicht fehlerhaft.

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

-MaxPercentUnhealthyApplications

Gibt den maximal tolerierten Prozentsatz der Anwendungen an, die den aggregierten Integritätsstatus des Fehlers aufweisen können. Wenn das Upgrade diesen Prozentsatz überschreitet, ist der Cluster fehlerhaft.

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

-MaxPercentUnhealthyNodes

Gibt den maximal tolerierten Prozentsatz der Knoten an, die aggregierte Integritätszustände aufweisen können. Wenn ein Upgrade diesen Prozentsatz überschreitet, ist der Cluster fehlerhaft.

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

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Gibt den maximal tolerierten Prozentsatz der fehlerhaften Upgradedomänen-Delta-Knoten an, die einen aggregierten Integritätsstatus aufweisen können. Wenn es eine Upgradedomäne gibt, in der die aktuellen fehlerhaften Knoten den Prozentsatz relativ zum Status am Anfang des Upgrades nicht berücksichtigen, ist der Cluster nicht fehlerhaft.

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

-NodeTypeHealthPolicyMap

Definiert eine Zuordnung mit maximalen Prozentsätzen für fehlerhafte Knoten für bestimmte Knotentypen.

Die Knotentyp-Integritätsrichtlinienzuordnung kann während der Clusterintegritätsbewertung verwendet werden, um spezielle Knotentypen zu beschreiben. Die knotentypen, die in der Karte enthalten sind, werden anhand des prozentsatzes ausgewertet, der in der Karte enthalten ist, und auch mit der globalen (siehe System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Die Knoten von Knotentypen, die in der Karte angegeben sind, werden auch für den globalen Knotenpool gezählt; sie sind unabhängige Prüfungen.

Typ:NodeTypeHealthPolicyMap
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

-UpgradeDomainTimeoutSec

Gibt die maximale Zeit in Sekunden an, die Service Fabric benötigt, um eine einzelne Upgradedomäne zu aktualisieren. Nach diesem Zeitraum schlägt das Upgrade fehl.

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

-UpgradeMode

Gibt die neue UpgradeMode- für das Upgrade an.

Typ:RollingUpgradeMode
Zulässige Werte:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UpgradeReplicaSetCheckTimeoutSec

Gibt die maximale Zeit in Sekunden an, die Service Fabric wartet, bis ein Replikatsatz in einen sicheren Zustand neu konfiguriert wird, wenn es sich nicht bereits in einem sicheren Zustand befindet, bevor Service Fabric mit dem Upgrade fortfährt.

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

-UpgradeTimeoutSec

Gibt die maximale Zeit in Sekunden an, die Service Fabric für das gesamte Upgrade benötigt. Nach diesem Zeitraum schlägt das Upgrade fehl.

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

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object