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
Výstupy
Azure PowerShell