Start-ServiceFabricApplicationUpgrade

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 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.

Type:	Uri
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationParameter

Gibt die Außerkraftsetzungen für Anwendungsparameter als Name/Wertpaare an.

Type:	Hashtable
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationTypeVersion

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConsiderWarningAsError

Gibt an, ob ein Warnungsstatusereignis während der Integritätsbewertung als Fehlerereignis behandelt werden soll.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	UpgradeFailureAction
Accepted values:	Invalid, Rollback, Manual
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceRestart

Gibt an, dass der Diensthost neu gestartet wird, auch wenn das Upgrade eine Konfigurationsänderung ist.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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)

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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" }

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UpgradeSortOrder
Accepted values:	Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:	5
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

Gibt den Timeoutzeitraum in Sekunden für den Vorgang an.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

None

Ausgaben

System.Object

Ähnliche Themen

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricApplicationUpgrade
• Resume-ServiceFabricApplicationUpgrade
• Copy-ServiceFabricApplicationPackage
• Register-ServiceFabricApplicationType