Freigeben über

Update-ServiceFabricApplicationUpgrade

  • Referenz
Modul:
ServiceFabric

Ändert die Upgradebeschreibung eines aktiven Anwendungsupgrades.

Syntax

Update-ServiceFabricApplicationUpgrade
      [-ApplicationName] <Uri>
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-DefaultServiceTypeHealthPolicy <String>]
      [-MaxPercentUnhealthyDeployedApplications <Byte>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-Force]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Update-ServiceFabricApplicationUpgrade Cmdlet ändert die Parameter einer Anwendungsupgradebeschreibung, während das Upgrade noch aktiv ist. Service Fabric erkennt und wendet Änderungen gemäß dem UpgradeStatusPollInterval 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
  • DefaultServiceTypeHealthPolicy-
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap-

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 Anwendungsupgrade

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

Mit diesem Befehl wird der Timeoutwert des Replikatsatzes auf 0 für ein ausstehendes Upgrade auf fabric:/MyApplication festgelegt. Das Update lässt alle anderen Upgradewerte allein.

Parameter

-ApplicationName

Gibt den URI (Uniform Resource Identifier) einer Service Fabric-Anwendung an. Das Cmdlet aktualisiert die Einstellungen für das Upgrade für die Anwendung mit dem URI, den dieser Parameter angibt.

Typ:Uri
Position:0
Standardwert:None
Erforderlich:True
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

-DefaultServiceTypeHealthPolicy

Gibt die Standardintegritätsrichtlinie für Diensttypen an. Die Integritätsrichtlinie wird für das überwachte Upgrade verwendet. Die Richtlinie folgt dem Format MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices. Beispielsweise gibt 5.10.15 die folgenden Werte an:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Typ:String
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 Diensthost neu gestartet wird, auch wenn das Upgrade eine konfigurationsgeschützte Änderung ist.

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 die Anwendung stabil ist, bevor sie 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 Anwendungsupgrade 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

-MaxPercentUnhealthyDeployedApplications

Gibt den maximalen Prozentsatz der tolerierten bereitgestellten Anwendungen an, die einen Fehlerstatus aufweisen können. Wenn der Prozentsatz der fehlerhaften Anwendungsinstanzen, die auf den Knoten im Cluster bereitgestellt werden, den Wert überschreitet, den dieser Parameter angibt, ist der Integritätsstatus der Anwendung ein Fehler.

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

-ServiceTypeHealthPolicyMap

Gibt die Zuordnung der Integritätsrichtlinie an, die für verschiedene Diensttypen verwendet werden soll. Geben Sie die Zuordnung als Hashtabelle im folgenden Format an: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Zum Beispiel:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Typ:Hashtable
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 Dienst in einen sicheren Zustand umkonfiguriert 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