Set-AzServiceFabricManagedClusterApplication

Referenz

Modul:: Az.ServiceFabric

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

Syntax

Set-AzServiceFabricManagedClusterApplication
   [-ResourceGroupName] <String>
   [-ClusterName] <String>
   [-Name] <String>
   [[-ApplicationTypeVersion] <String>]
   [-ApplicationParameter <Hashtable>]
   [-ForceRestart]
   [-RecreateApplication]
   [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
   [-InstanceCloseDelayDurationSec <Int32>]
   [-UpgradeMode <ApplicationUpgradeMode>]
   [-FailureAction <FailureAction>]
   [-HealthCheckRetryTimeoutSec <Int32>]
   [-HealthCheckWaitDurationSec <Int32>]
   [-HealthCheckStableDurationSec <Int32>]
   [-UpgradeDomainTimeoutSec <Int32>]
   [-UpgradeTimeoutSec <Int32>]
   [-ConsiderWarningAsError]
   [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
   [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
   [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
   [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
   [-ServiceTypeHealthPolicyMap <Hashtable>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzServiceFabricManagedClusterApplication
   [[-ApplicationTypeVersion] <String>]
   [-ApplicationParameter <Hashtable>]
   [-ForceRestart]
   [-RecreateApplication]
   [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
   [-InstanceCloseDelayDurationSec <Int32>]
   [-UpgradeMode <ApplicationUpgradeMode>]
   [-FailureAction <FailureAction>]
   [-HealthCheckRetryTimeoutSec <Int32>]
   [-HealthCheckWaitDurationSec <Int32>]
   [-HealthCheckStableDurationSec <Int32>]
   [-UpgradeDomainTimeoutSec <Int32>]
   [-UpgradeTimeoutSec <Int32>]
   [-ConsiderWarningAsError]
   [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
   [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
   [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
   [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
   [-ServiceTypeHealthPolicyMap <Hashtable>]
   [-Tag <Hashtable>]
   -ResourceId <String>
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzServiceFabricManagedClusterApplication
   [[-ApplicationTypeVersion] <String>]
   [-ApplicationParameter <Hashtable>]
   [-ForceRestart]
   [-RecreateApplication]
   [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
   [-InstanceCloseDelayDurationSec <Int32>]
   [-UpgradeMode <ApplicationUpgradeMode>]
   [-FailureAction <FailureAction>]
   [-HealthCheckRetryTimeoutSec <Int32>]
   [-HealthCheckWaitDurationSec <Int32>]
   [-HealthCheckStableDurationSec <Int32>]
   [-UpgradeDomainTimeoutSec <Int32>]
   [-UpgradeTimeoutSec <Int32>]
   [-ConsiderWarningAsError]
   [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
   [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
   [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
   [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
   [-ServiceTypeHealthPolicyMap <Hashtable>]
   [-Tag <Hashtable>]
   -InputObject <PSManagedApplication>
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Dieses Cmdlet kann verwendet werden, um Anwendungsparameter zu aktualisieren und die Anwendungstypversion zusammen mit anderen Konfigurationsupdates 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-AzServiceFabricManagedClusterApplicationTypeVersionerstellt werden.

Beispiele

Beispiel 1

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

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

Beispiel 2

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
Set-AzServiceFabricManagedClusterApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -FailureAction Rollback -ForceRestart:$false -Verbose

In diesem Beispiel wird "FailureAction" aktualisiert und "ForceRestart" auf "false" festgelegt.

Beispiel 3

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
$version = "v2"
$packageUrl = "https://sftestapp.blob.core.windows.net/sftestapp/testAppType_v2.sfpkg"
New-AzServiceFabricManagedClusterApplicationTypeVersion -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -Version $version -PackageUrl $packageUrl -Verbose
Set-AzServiceFabricManagedClusterApplication -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

Set-AzServiceFabricManagedClusterApplication -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

-AsJob

Führen Sie das Cmdlet im Hintergrund aus, und geben Sie einen Auftrag zurück, um den Fortschritt nachzuverfolgen.

Typ:	SwitchParameter
Position:	Named
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

-Force

Fortfahren ohne Eingabeaufforderungen

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:	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 verwaltete Anwendungsressource.

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

-InstanceCloseDelayDurationSec

Gibt die Dauer in Sekunden an, um zu warten, bevor eine zustandslose Instanz geschlossen wird, damit die aktiven Anforderungen ordnungsgemäß abgelassen werden können.

Typ:	Int32
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

-RecreateApplication

Bestimmt, ob die Anwendung beim Update neu erstellt werden soll. If value=true, the rest of the upgrade policy parameters are not allowed.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
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 verwalteten Anwendung.

Typ:	String
Position:	Named
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

-Tag

Geben Sie die Tags als Schlüssel-Wert-Paare an.

Typ:	Hashtable
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
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

-UpgradeMode

Der Modus, der zum Überwachen des Zustands während eines rollierenden Upgrades verwendet wird. Die Werte werden überwacht, und "UnmonitoredAuto".

Typ:	ApplicationUpgradeMode
Zulässige Werte:	Monitored, UnmonitoredAuto
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

Hashtable

PSManagedApplication

Ausgaben