Sdílet prostřednictvím


Set-AzServiceFabricManagedClusterApplication

Aktualizace spravované aplikace Service Fabric To umožňuje aktualizovat parametry aplikace nebo upgradovat verzi typu aplikace, která aktivuje upgrade aplikace nebo jiné aktualizace pouze konfigurace. Podporuje pouze nasazené aplikace ARM.

Syntaxe

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

Tuto rutinu lze použít k aktualizaci parametrů aplikace a upgradu verze typu aplikace spolu s dalšími aktualizacemi pouze konfigurace. Aktualizace parametru změní pouze model na straně ARM, pouze když se použije nová verze typu, příkaz aktivuje upgrade aplikace. Zadaná verze typu by již měla být vytvořena v clusteru pomocí New-AzServiceFabricManagedClusterApplicationTypeVersion.

Příklady

Příklad 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"}

Tento příklad spustí upgrade spravované aplikace a aktualizuje verzi typu na verzi v2, která byla vytvořena pomocí New-AzServiceFabricManagedClusterApplicationTypeVersion. Použité parametry aplikace by měly být definovány v manifestu aplikace.

Příklad 2

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

Tento příklad aktualizuje FailureAction a nastaví ForceRestart na false.

Příklad 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

Tento příklad spustí upgrade aplikace, aby aktualizoval verzi typu na verzi v2, a také nastaví některé parametry zásad upgradu, které se projeví od aktuálního upgradu.

Příklad 4

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

Tento příklad aktualizuje parametry aplikace, ale tyto změny se projeví až do dalšího upgradu verze na aplikaci.

Parametry

-ApplicationParameter

Zadejte parametry aplikace jako páry klíč/hodnota. Tyto parametry musí existovat v manifestu aplikace.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationTypeVersion

Zadejte verzi typu aplikace.

Typ:String
Position:3
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AsJob

Spusťte rutinu na pozadí a vraťte úlohu pro sledování průběhu.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ClusterName

Zadejte název clusteru.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ConsiderWarningAsError

Určuje, jestli se má událost stavu upozornění považovat za událost chyby během vyhodnocení stavu.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService

Určuje maximální procento nehelthy oddílů na službu povoleno zásadou stavu pro výchozí typ služby, který se má použít pro monitorovaný upgrade.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition

Určuje maximální procentonech

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultServiceTypeUnhealthyServicesMaxPercent

Určuje maximální procento nehelthy služeb povolených zásadami stavu pro výchozí typ služby, které se mají použít pro monitorovaný upgrade.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FailureAction

Určuje akci, která se má provést, pokud se monitorovaný upgrade nezdaří. Přijatelné hodnoty pro tento parametr jsou Vrácení zpět nebo Ruční.

Typ:FailureAction
Přípustné hodnoty:Rollback, Manual
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Pokračovat bez výzev

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ForceRestart

Označuje, že hostitel služby se restartuje i v případě, že upgrade je změna pouze konfigurace.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HealthCheckRetryTimeoutSec

Určuje dobu trvání v sekundách, po které Service Fabric opakuje kontrolu stavu, pokud předchozí kontrola stavu selže.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HealthCheckStableDurationSec

Určuje dobu trvání v sekundách, po kterou Service Fabric čeká, aby ověřila, že je aplikace stabilní před přechodem na další doménu upgradu nebo dokončením upgradu. Tato doba čekání zabraňuje nedetekovaným změnám stavu hned po provedení kontroly stavu.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HealthCheckWaitDurationSec

Určuje dobu trvání v sekundách, po které Service Fabric čeká, než provede počáteční kontrolu stavu po dokončení upgradu v doméně upgradu.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Prostředek spravované aplikace.

Typ:PSManagedApplication
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-InstanceCloseDelayDurationSec

Určuje dobu trvání v sekundách, která se má čekat před uzavřením bezstavové instance, aby aktivní žádosti mohly řádně vyprázdnit.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Zadejte název aplikace.

Typ:String
Aliasy:ApplicationName
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RecreateApplication

Určuje, zda má být aplikace znovu vytvořena při aktualizaci. Pokud hodnota=true, zbývající parametry zásad upgradu nejsou povolené.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Zadejte název skupiny prostředků.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceId

Arm ResourceId spravované aplikace.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ServiceTypeHealthPolicyMap

Určuje mapu zásad stavu, která se má použít pro různé typy služeb jako tabulku hash v následujícím formátu: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Například: @{ "ServiceTypeName01" = "5,10;5"; "ServiceTypeName02" = "5,5,5" }

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tag

Zadejte značky jako páry klíč/hodnota.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UnhealthyDeployedApplicationsMaxPercent

Určuje maximální procento instancí aplikace nasazených v uzlech v clusteru, které mají stav chyby před chybou stavu aplikace pro cluster.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UpgradeDomainTimeoutSec

Určuje maximální dobu v sekundách, kterou Service Fabric trvá upgrade jedné upgradové domény. Po uplynutí této doby upgrade selže.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UpgradeMode

Režim používaný ke sledování stavu během postupného upgradu. Hodnoty jsou monitorovány a UnmonitoredAuto.

Typ:ApplicationUpgradeMode
Přípustné hodnoty:Monitored, UnmonitoredAuto
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UpgradeReplicaSetCheckTimeoutSec

Určuje maximální dobu, po kterou Service Fabric čeká, než se služba překonfiguruje do bezpečného stavu, pokud ještě není v bezpečném stavu, před upgradem Service Fabric.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UpgradeTimeoutSec

Určuje maximální dobu v sekundách, kterou Service Fabric trvá pro celý upgrade. Po uplynutí této doby upgrade selže.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Hashtable

PSManagedApplication

Výstupy

PSManagedApplication