Update-AzServiceFabricApplication

Referenz

Modul:: Az.ServiceFabric

Aktualisieren sie eine Dienst fabric-Anwendung. Dadurch können die Anwendungsparameter aktualisiert und/oder die Anwendungstypversion aktualisiert werden, wodurch ein Anwendungsupgrade ausgelöst wird. Unterstützt nur bereitgestellte ARM-Anwendungen.

Syntax

Update-AzServiceFabricApplication
      [-ResourceGroupName] <String>
      [-ClusterName] <String>
      [-Name] <String>
      [[-ApplicationTypeVersion] <String>]
      [-ApplicationParameter <Hashtable>]
      [-MinimumNodeCount <Int64>]
      [-MaximumNodeCount <Int64>]
      [-ForceRestart]
      [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
      [-FailureAction <FailureAction>]
      [-HealthCheckRetryTimeoutSec <Int32>]
      [-HealthCheckWaitDurationSec <Int32>]
      [-HealthCheckStableDurationSec <Int32>]
      [-UpgradeDomainTimeoutSec <Int32>]
      [-UpgradeTimeoutSec <Int32>]
      [-ConsiderWarningAsError]
      [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
      [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
      [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
      [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzServiceFabricApplication
      [[-ApplicationTypeVersion] <String>]
      [-ApplicationParameter <Hashtable>]
      [-MinimumNodeCount <Int64>]
      [-MaximumNodeCount <Int64>]
      [-ForceRestart]
      [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
      [-FailureAction <FailureAction>]
      [-HealthCheckRetryTimeoutSec <Int32>]
      [-HealthCheckWaitDurationSec <Int32>]
      [-HealthCheckStableDurationSec <Int32>]
      [-UpgradeDomainTimeoutSec <Int32>]
      [-UpgradeTimeoutSec <Int32>]
      [-ConsiderWarningAsError]
      [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
      [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
      [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
      [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-ResourceId] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzServiceFabricApplication
      -InputObject <PSApplication>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Dieses Cmdlet kann verwendet werden, um Anwendungsparameter zu aktualisieren und die Anwendungstypversion zu aktualisieren. Durch das Aktualisieren des Parameters wird das Modell nur auf ARM-Seite geändert, nur wenn eine neue Typversion verwendet wird, löst der Befehl ein Anwendungsupgrade aus. Die angegebene Typversion sollte bereits im Cluster mit New-AzServiceFabricApplicationTypeVersionerstellt werden.

Beispiele

Beispiel 1

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
$version = "v2"
$packageUrl = "https://sftestapp.blob.core.windows.net/sftestapp/testAppType_v2.sfpkg"
New-AzServiceFabricApplicationTypeVersion -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -Version $version -PackageUrl $packageUrl -Verbose
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationTypeVersion $version -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"}

In diesem Beispiel wird ein Anwendungsupgrade gestartet, um die Typversion auf "v2" zu aktualisieren, die mit New-AzServiceFabricApplicationTypeVersionerstellt wurde. Die verwendeten Anwendungsparameter sollten im Anwendungsmanifest definiert werden.

Beispiel 2

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -MinimumNodeCount 1 -MaximumNodeCount 4 -Verbose

In diesem Beispiel wird die Minimale und maximale Anzahl von Knoteneinschränkung für die Anwendung aktualisiert.

Beispiel 3

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
$version = "v2"
$packageUrl = "https://sftestapp.blob.core.windows.net/sftestapp/testAppType_v2.sfpkg"
New-AzServiceFabricApplicationTypeVersion -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -Version $version -PackageUrl $packageUrl -Verbose
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationTypeVersion $version -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"} -HealthCheckStableDurationSec 0 -HealthCheckWaitDurationSec 0 -HealthCheckRetryTimeoutSec 0 -UpgradeDomainTimeoutSec 5000 -UpgradeTimeoutSec 7000 -FailureAction Rollback -UpgradeReplicaSetCheckTimeoutSec 300 -ForceRestart

In diesem Beispiel wird ein Anwendungsupgrade gestartet, um die Typversion auf "v2" zu aktualisieren, und legt außerdem einige Upgraderichtlinienparameter fest, die vom aktuellen Upgrade wirksam werden.

Beispiel 4

Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"}

In diesem Beispiel werden die Anwendungsparameter aktualisiert, diese Änderungen werden jedoch erst wirksam, wenn das upgrade der nächsten Version auf die Anwendung erfolgt.

Parameter

-ApplicationParameter

Geben Sie die Anwendungsparameter als Schlüssel-Wert-Paare an. Diese Parameter müssen im Anwendungsmanifest vorhanden sein.

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

-ApplicationTypeVersion

Angeben der Anwendungstypversion

Typ:	String
Position:	3
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ClusterName

Geben Sie den Namen des Clusters an.

Typ:	String
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Confirm

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

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
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:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService

Gibt den maximalen Prozentsatz der nicht bezogenen Partitionen pro Dienst an, die von der Integritätsrichtlinie für den standarddiensttyp zulässig sind, der für das überwachte Upgrade verwendet werden soll.

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

-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition

Gibt den maximalen Prozentsatz der nicht bezogenen Replikate pro Dienst an, die von der Integritätsrichtlinie für den standarddiensttyp zulässig sind, der für das überwachte Upgrade verwendet werden soll.

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

-DefaultServiceTypeUnhealthyServicesMaxPercent

Gibt den maximalen Prozentsatz der Nichthelfdienste an, die von der Integritätsrichtlinie für den Standarddiensttyp zulässig sind, der für das überwachte Upgrade verwendet werden soll.

Typ:	Int32
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 oder Manual.

Typ:	FailureAction
Zulässige Werte:	Rollback, Manual
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:	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:	Int32
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:	Int32
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:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Die Anwendungsressource.

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

-MaximumNodeCount

Gibt die maximale Anzahl von Knoten an, auf denen eine Anwendung platziert werden soll.

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

-MinimumNodeCount

Gibt die minimale Anzahl von Knoten an, bei denen Service Fabric Kapazität für diese Anwendung reserviert.

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

-Name

Angeben des Namens der Anwendung

Typ:	String
Aliase:	ApplicationName
Position:	2
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Geben Sie den Namen der Ressourcengruppe an.

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

-ResourceId

Arm ResourceId der Anwendung.

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

-UnhealthyDeployedApplicationsMaxPercent

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:	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:	Int32
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:	Int32
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:	Int32
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:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

PSApplication

Ausgaben