Set-AzServiceFabricManagedClusterApplication

Referentie

Module:: Az.ServiceFabric

Een beheerde Service Fabric-toepassing bijwerken. Hiermee kunt u de toepassingsparameters bijwerken en/of de versie van het toepassingstype bijwerken, waardoor een toepassingsupgrade of andere configuratie-updates alleen worden geactiveerd. Ondersteunt alleen door ARM geïmplementeerde toepassingen.

Syntaxis

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

Description

Deze cmdlet kan worden gebruikt om toepassingsparameters bij te werken en de versie van het toepassingstype bij te werken, samen met andere updates voor alleen configuratie. Als u de parameter bijwerkt, wordt alleen het model aan de ARM-zijde gewijzigd, alleen wanneer een nieuwe typeversie wordt gebruikt, wordt met de opdracht een toepassingsupgrade geactiveerd. De opgegeven typeversie moet al in het cluster worden gemaakt met behulp van New-AzServiceFabricManagedClusterApplicationTypeVersion.

Voorbeelden

Voorbeeld 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 dit voorbeeld wordt een upgrade van een beheerde toepassing gestart om de typeversie bij te werken naar 'v2' die is gemaakt met New-AzServiceFabricManagedClusterApplicationTypeVersion. De gebruikte toepassingsparameters moeten worden gedefinieerd in het toepassingsmanifest.

Voorbeeld 2

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

In dit voorbeeld wordt de FailureAction bijgewerkt en wordt ForceRestart ingesteld op false.

Voorbeeld 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 dit voorbeeld wordt een toepassingsupgrade gestart om de typeversie bij te werken naar 'v2' en worden ook enkele upgradebeleidsparameters ingesteld die van kracht worden na de huidige upgrade.

Voorbeeld 4

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

In dit voorbeeld worden de toepassingsparameters bijgewerkt, maar deze wijzigingen worden pas van kracht totdat de volgende versie-upgrade naar de toepassing wordt uitgevoerd.

Parameters

-ApplicationParameter

Geef de toepassingsparameters op als sleutel-waardeparen. Deze parameters moeten aanwezig zijn in het toepassingsmanifest.

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ApplicationTypeVersion

Geef de versie van het toepassingstype op

Type:	String
Position:	3
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AsJob

Voer de cmdlet op de achtergrond uit en retourneer een taak om de voortgang bij te houden.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ClusterName

Geef de naam van het cluster op.

Type:	String
Position:	1
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ConsiderWarningAsError

Hiermee wordt aangegeven of een waarschuwingsstatus gebeurtenis moet worden behandeld als een fout tijdens de statusevaluatie.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService

Hiermee geeft u het maximumpercentage van unhelthy partities per service toegestaan door het statusbeleid voor het standaardservicetype dat moet worden gebruikt voor de bewaakte upgrade.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition

Hiermee geeft u het maximumpercentage van de onthelthy replica's per service toegestaan door het statusbeleid voor het standaardservicetype dat moet worden gebruikt voor de bewaakte upgrade.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultServiceTypeUnhealthyServicesMaxPercent

Hiermee geeft u het maximumpercentage van de onthelthy-services op die zijn toegestaan door het statusbeleid voor het standaardservicetype dat moet worden gebruikt voor de bewaakte upgrade.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-FailureAction

Hiermee geeft u de actie op die moet worden uitgevoerd als de bewaakte upgrade mislukt. De acceptabele waarden voor deze parameter zijn Terugdraaien of Handmatig.

Type:	FailureAction
Geaccepteerde waarden:	Rollback, Manual
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Force

Doorgaan zonder prompts

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ForceRestart

Geeft aan dat de servicehost opnieuw wordt opgestart, zelfs als de upgrade alleen een configuratiewijziging is.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-HealthCheckRetryTimeoutSec

Hiermee geeft u de duur op, in seconden, waarna Service Fabric de statuscontrole opnieuw probeert uit te proberen als de vorige statuscontrole mislukt.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-HealthCheckStableDurationSec

Hiermee geeft u de duur op, in seconden, dat Service Fabric wacht om te controleren of de toepassing stabiel is voordat u naar het volgende upgradedomein gaat of de upgrade voltooit. Deze wachttijd voorkomt niet-gedetecteerde wijzigingen van de status direct nadat de statuscontrole is uitgevoerd.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-HealthCheckWaitDurationSec

Hiermee geeft u de duur in seconden op die Service Fabric wacht voordat de eerste statuscontrole wordt uitgevoerd nadat de upgrade op het upgradedomein is voltooid.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-InputObject

De resource van de beheerde toepassing.

Type:	PSManagedApplication
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-InstanceCloseDelayDurationSec

Hiermee geeft u de duur in seconden op, om te wachten voordat een staatloze instantie wordt gesloten, zodat de actieve aanvragen probleemloos kunnen worden uitgevoerd.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Name

Geef de naam van de toepassing op

Type:	String
Aliassen:	ApplicationName
Position:	2
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RecreateApplication

Bepaalt of de toepassing opnieuw moet worden gemaakt bij de update. Als value=true, zijn de rest van de upgradebeleidsparameters niet toegestaan.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ResourceGroupName

Geef de naam van de resourcegroep op.

Type:	String
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ResourceId

Arm ResourceId van de beheerde toepassing.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ServiceTypeHealthPolicyMap

Hiermee geeft u de kaart van het statusbeleid te gebruiken voor verschillende servicetypen als een hash-tabel in de volgende indeling: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Bijvoorbeeld: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Tag

Geef de tags op als sleutel-waardeparen.

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-UnhealthyDeployedApplicationsMaxPercent

Hiermee geeft u het maximumpercentage op van de toepassingsexemplaren die zijn geïmplementeerd op de knooppunten in het cluster met een status van een fout voordat de status van de toepassing voor het cluster een fout is.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UpgradeDomainTimeoutSec

Hiermee geeft u de maximale tijd in seconden op die Service Fabric nodig heeft om één upgradedomein bij te werken. Na deze periode mislukt de upgrade.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UpgradeMode

De modus die wordt gebruikt om de status tijdens een rolling upgrade te bewaken. De waarden worden bewaakt en UnmonitoredAuto.

Type:	ApplicationUpgradeMode
Geaccepteerde waarden:	Monitored, UnmonitoredAuto
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UpgradeReplicaSetCheckTimeoutSec

Hiermee geeft u de maximale tijd op waarop Service Fabric wacht totdat een service opnieuw wordt geconfigureerd in een veilige status, als deze nog niet in een veilige status is, voordat Service Fabric verdergaat met de upgrade.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UpgradeTimeoutSec

Hiermee geeft u de maximale tijd in seconden op die Service Fabric nodig heeft voor de volledige upgrade. Na deze periode mislukt de upgrade.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

String

Hashtable

PSManagedApplication

Uitvoerwaarden