Start-ServiceFabricApplicationUpgrade

  • Referenz
Modul:
ServiceFabric

Aktualisiert eine Service Fabric-Anwendung auf die angegebene ApplicationTypeVersion.

Syntax

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Das Start-ServiceFabricApplicationUpgrade Cmdlet aktualisiert eine Service Fabric-Anwendung. Bevor Sie dieses Cmdlet verwenden, müssen Sie das aktualisierte Anwendungspaket in den Imagespeicher kopieren und den aktualisierten Anwendungstyp registrieren. Verwenden Sie die Copy-ServiceFabricApplicationPackage-, um das Anwendungspaket in den Bildspeicher zu kopieren. Verwenden Sie das Cmdlet Register-ServiceFabricApplicationType Cmdlet, um den aktualisierten Anwendungstyp zu registrieren.

Dieses Cmdlet startet das Upgrade auf dem Cluster.

ApplicationParameters- werden nicht über ein Anwendungsupgrade hinweg beibehalten. Um die aktuellen Anwendungsparameter beizubehalten, sollte der Benutzer zuerst die Parameter abrufen und an den Upgrade-API-Aufruf übergeben, wie in Beispiel 1 unten dargestellt.

Weitere Informationen zu Service Fabric-Anwendungsupgrades finden Sie in der konzeptionellen Dokumentation.

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: Abrufen der Anwendungsparameter zum Übergeben an den Upgradeaufruf

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}

foreach ($pair in $appParamCollection)
{ $applicationParameterMap.Add($pair.Name, $pair.Value); }

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

Beispiel 2: Upgrade einer Anwendung

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\PersistentToDoListServiceV2" -ImageStoreConnectionString "file:C:\ProgramData\ServiceFabric\ImageStore"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListServiceV2"
PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeVersion "2.0" -ForceRestart -UnMonitoredManual

Der erste Befehl verwendet das Cmdlet Copy-ServiceFabricApplicationPackage Cmdlet, um das aktualisierte Anwendungspaket in den Imagespeicher zu kopieren.

Der zweite Befehl verwendet das cmdlet Register-ServiceFabricApplicationType Cmdlet, um den aktualisierten Anwendungstyp zu registrieren.

Der dritte Befehl aktualisiert die Anwendung. Der Befehl führt ein nicht überwachtes manuelles Upgrade durch, das einen Neustart des Servers enthält, auf dem die Anwendung gehostet wird.

Parameter

-ApplicationName

Gibt den URI (Uniform Resource Identifier) einer Service Fabric-Anwendung an. Das Cmdlet aktualisiert die Anwendung mit dem von Ihnen angegebenen URI.

Typ:Uri
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplicationParameter

Gibt die Außerkraftsetzungen für Anwendungsparameter als Name/Wert-Paare an.

Typ:Hashtable
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplicationTypeVersion

Gibt die Version eines Service Fabric-Anwendungstyps an. Das Cmdlet aktualisiert die Anwendung auf die angegebene Version.

Typ:String
Position:1
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 Warnungsstatusereignis während der Integritätsauswertung als Fehlerereignis behandelt werden soll.

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

-DefaultServiceTypeHealthPolicy

Gibt die Integritätsrichtlinie für den Standarddiensttyp an, der für das überwachte Upgrade im Format MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices verwendet werden soll. 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:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

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

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

-ForceRestart

Gibt an, dass der Diensthost neu gestartet wird, auch wenn das Upgrade eine konfigurationsgeschützte Änderung ist.

Typ:SwitchParameter
Position:3
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 zur nächsten Upgradedomäne wechseln oder das Upgrade abschließen. 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 (in New-ServiceFabricService).

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

-MaxPercentUnhealthyDeployedApplications

Gibt den maximalen Prozentsatz der Anwendungsinstanzen an, die auf den Knoten im Cluster bereitgestellt werden, die einen Integritätsstatus aufweisen, bevor der Anwendungsstatus für den Cluster fehler ist.

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

-Monitored

Gibt an, dass der Upgrademodus überwacht wird. Nachdem das Cmdlet ein Upgrade für eine Upgradedomäne abgeschlossen hat, aktualisiert Service Fabric die nächste Upgradedomäne, wenn die Integrität der Upgradedomäne und der Cluster den von Ihnen definierten Integritätsrichtlinien entsprechen. Wenn die Upgradedomäne oder der Cluster keine Integritätsrichtlinien erfüllt, schlägt das Upgrade fehl, und Service Fabric setzt das Upgrade für die Upgradedomäne zurück oder setzt den manuellen Modus gemäß der angegebenen Richtlinie zurück. Dies ist der empfohlene Modus für Anwendungsupgrades in einer Produktionsumgebung.

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

-ReplicaQuorumTimeoutSec

Gibt den Timeoutzeitraum in Sekunden an, um zu überprüfen, ob die Replikatmenge über ein Quorum verfügt. Nach dem Timeoutzeitraum wird das Upgrade fortgesetzt.

Dieser Parameter ist veraltet. Geben Sie stattdessen den parameter UpgradeReplicaSetCheckTimeoutSec an.

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

-RestartProcess

Gibt an, dass der Diensthost im Rahmen des Upgrades neu gestartet wird.

Dieser Parameter ist veraltet. Geben Sie stattdessen den parameter ForceRestart an.

Typ:SwitchParameter
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 als Hashtabelle im folgenden Format verwendet werden soll: @ {"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

-SortOrder

Definiert die Reihenfolge, in der ein Upgrade durch den Cluster fortgesetzt wird.

Mögliche Werte sind:

  • Invalid – Gibt an, dass diese Sortierreihenfolge ungültig ist. Alle Service Fabric-Enumerationen weisen den ungültigen Typ auf.
  • Default – Gibt an, dass die Standardsortierreihenfolge (wie im Clustermanifest angegeben) verwendet wird.
  • Numeric – Gibt an, dass numerische Weiterleitungsreihenfolge (UD-Namen, die als Zahlen sortiert sind) verwendet werden.
  • Lexicographical – Gibt an, dass die Weiterleitung lexikographische Sortierreihenfolge (UD-Namen, die als Zeichenfolgen sortiert sind) verwendet werden.
  • ReverseNumeric – Gibt an, dass umgekehrte numerische Sortierreihenfolge (UD-Namen, die als Zahlen sortiert sind) verwendet werden.
  • ReverseLexicographical– Gibt an, dass die umgekehrte lexikographische Sortierreihenfolge (UD-Namen, die als Zeichenfolgen sortiert sind) verwendet werden.
Typ:UpgradeSortOrder
Zulässige Werte:Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:5
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

-UnmonitoredAuto

Gibt an, dass der Upgrademodus nicht automatisch überwacht wird. Nachdem Service Fabric eine Upgradedomäne aktualisiert hat, aktualisiert Service Fabric die nächste Upgradedomäne unabhängig vom Anwendungsstatus. Dieser Modus wird nicht für die Produktion empfohlen und ist nur bei der Entwicklung einer Anwendung nützlich.

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

-UnmonitoredManual

Gibt an, dass der Upgrademodus nicht überwacht wird. Nachdem Service Fabric eine Upgradedomäne aktualisiert hat, wartet sie auf das Upgrade der nächsten Upgradedomäne mithilfe des Cmdlets Resume-ServiceFabricApplicationUpgrade Cmdlet.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
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

-UpgradeReplicaSetCheckTimeoutSec

Gibt die maximale Zeit 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:4
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