Start-ServiceFabricApplicationUpgrade
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 Cmdlet "Start-ServiceFabricApplicationUpgrade " 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 Imagespeicher zu kopieren. Verwenden Sie das Cmdlet "Register-ServiceFabricApplicationType ", um den aktualisierten Anwendungstyp zu registrieren.
Dieses Cmdlet startet das Upgrade im Cluster.
ApplicationParameters bleiben in einem Anwendungsupgrade nicht erhalten. Um aktuelle Anwendungsparameter beizubehalten, sollte der Benutzer zuerst die Parameter abrufen und sie 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 in 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 in 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 , um das aktualisierte Anwendungspaket in den Imagespeicher zu kopieren.
Der zweite Befehl verwendet das Cmdlet Register-ServiceFabricApplicationType , um den aktualisierten Anwendungstyp zu registrieren.
Der dritte Befehl aktualisiert die Anwendung. Der Befehl führt ein nicht überwachtes manuelles Upgrade aus, das einen Neustart des Servers enthält, der die Anwendung hostet.
Parameter
-ApplicationName
Gibt den Uniform Resource Identifier (URI) einer Service Fabric-Anwendung an. Das Cmdlet aktualisiert die Anwendung, die den von Ihnen angegebenen URI enthält.
Typ: | Uri |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ApplicationParameter
Gibt die Außerkraftsetzungen für Anwendungsparameter als Name/Wertpaare 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 von Ihnen angegebene Version.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
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ätsbewertung 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 zeigen 5, 10 und 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 Aktion an, die ausgeführt werden soll, wenn das überwachte Upgrade fehlschlägt. Zulässige Werte für diesen Parameter:
- 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 übersprungen 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 Konfigurationsä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 zurückgibt, 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, dass nicht erkannte Integritätsänderungen direkt nach der Ausführung der Integritätsprüfung ausgeführt werden.
Typ: | UInt32 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-HealthCheckWaitDurationSec
Gibt die Dauer in Sekunden an, auf die Service Fabric wartet, bevor die anfängliche Integritätsprüfung ausgeführt wird, nachdem sie das Upgrade in der Upgradedomäne abgeschlossen hat.
Typ: | UInt32 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-InstanceCloseDelayDurationSec
Gibt die Dauer in Sekunden an, um vor einer zustandslosen Instanz zu warten, die durch das Anwendungsupgrade beeinträchtigt wird, um die aktiven Anforderungen ordnungsgemäß abzulassen. Diese Wartezeitdauer ist nur für die Instanzen dieser zustandslosen Dienste wirksam, die einen nicht Nullwert für die InstanzCloseDelayDuration 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 auf den Knoten im Cluster bereitgestellten Anwendungsinstanzen an, die einen Integritätszustand 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 das Upgrade ü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 des Clusters Ihren definierten Integritätsrichtlinien entspricht. Wenn die Upgradedomäne oder der Cluster die Integritätsrichtlinien nicht erfüllt, schlägt das Upgrade fehl, und Service Fabric setzt das Upgrade für die Upgradedomäne zurück oder stellt den manuellen Modus gemäß der angegebenen Richtlinie wieder her. 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 der Replikatsatz über quorum verfügt. Nach dem Timeout geht das Upgrade fort.
Dieser Parameter wurde 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 wurde veraltet. Geben Sie stattdessen den ForceRestart-Parameter 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"}. 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 über den Cluster fortläuft.
Dabei sind folgende Werte möglich:
-
Invalid
- Gibt an, dass diese Sortierreihenfolge ungültig ist. Alle Service Fabric-Enumerationen verfügen über den ungültigen Typ. -
Default
- Gibt an, dass die Standardsortierreihenfolge (wie im Clustermanifest angegeben) verwendet wird. -
Numeric
- Gibt an, dass numerische Sortierreihenfolge (UD-Namen sortiert als Zahlen) verwendet werden. -
Lexicographical
- Gibt an, dass die Sortierreihenfolge (ud-Namen sortiert als Zeichenfolgen) verwendet werden. -
ReverseNumeric
- Gibt an, dass die umgekehrte numerische Sortierreihenfolge (UD-Namen sortiert als Zahlen) verwendet werden. -
ReverseLexicographical
- Gibt an, dass die 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 in Sekunden für den Vorgang an.
Typ: | Int32 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UnmonitoredAuto
Gibt an, dass das Upgrade automatisch ausgeführt und nicht überwacht wird. Nachdem Service Fabric eine Upgradedomäne aktualisiert hat, aktualisiert Service Fabric die nächste Upgradedomäne unabhängig vom Integritätszustand der Anwendung. Dieser Modus wird für die Produktion nicht empfohlen und ist nur beim Entwickeln einer Anwendung nützlich.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UnmonitoredManual
Gibt an, dass das Upgrade manuell ausgeführt und nicht überwacht wird. Nachdem Service Fabric eine Upgradedomäne aktualisiert hat, wartet die Plattform darauf, dass Sie die nächste Upgradedomäne mit dem Cmdlet Resume-ServiceFabricApplicationUpgrade aktualisieren.
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, in der Service Fabric auf eine Neukonfiguration eines Diensts in einen sicheren Zustand wartet, wenn nicht bereits in einem sicheren Zustand, bevor Service Fabric mit dem Upgrade fortläuft.
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 geschieht, 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