Udostępnij za pośrednictwem

Set-AzServiceFabricManagedClusterApplication

  • Odwołanie
Moduł:
Az.ServiceFabric

Aktualizowanie aplikacji zarządzanej usługi Service Fabric. Dzięki temu można zaktualizować parametry aplikacji i/lub uaktualnić wersję typu aplikacji, która wyzwoli uaktualnienie aplikacji lub inne aktualizacje tylko konfiguracji. Obsługuje tylko aplikacje wdrożone przez usługę ARM.

Składnia

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

Opis

To polecenie cmdlet może służyć do aktualizowania parametrów aplikacji i uaktualniania wersji typu aplikacji wraz z innymi aktualizacjami tylko konfiguracji. Aktualizacja parametru spowoduje zmianę modelu po stronie usługi ARM tylko wtedy, gdy jest używana nowa wersja typu, polecenie wyzwoli uaktualnienie aplikacji. Określona wersja typu powinna zostać już utworzona w klastrze przy użyciu New-AzServiceFabricManagedClusterApplicationTypeVersion.

Przykłady

Przykład 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"}

W tym przykładzie zostanie uruchomione uaktualnienie aplikacji zarządzanej w celu zaktualizowania wersji typu do wersji "v2", która została utworzona przy użyciu New-AzServiceFabricManagedClusterApplicationTypeVersion. Użyte parametry aplikacji powinny być zdefiniowane w manifeście aplikacji.

Przykład 2

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

W tym przykładzie zaktualizowano element FailureAction i ustawiono wartość ForceRestart na false.

Przykład 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

W tym przykładzie zostanie uruchomione uaktualnienie aplikacji w celu zaktualizowania wersji typu do wersji "v2", a także ustawienie niektórych parametrów zasad uaktualniania, które zostaną zastosowane z bieżącego uaktualnienia.

Przykład 4

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

W tym przykładzie zaktualizowano parametry aplikacji, ale te zmiany zostaną wprowadzone dopiero po uaktualnieniu następnej wersji do aplikacji.

Parametry

-ApplicationParameter

Określ parametry aplikacji jako pary klucz/wartość. Te parametry muszą istnieć w manifeście aplikacji.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationTypeVersion

Określanie wersji typu aplikacji

Typ:String
Position:3
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AsJob

Uruchom polecenie cmdlet w tle i zwróć zadanie, aby śledzić postęp.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ClusterName

Określ nazwę klastra.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ConsiderWarningAsError

Wskazuje, czy zdarzenie kondycji ostrzeżenia ma być traktowane jako zdarzenie błędu podczas oceny kondycji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService

Określa maksymalny procent niedotrzymanych partycji na usługę dozwolony przez zasady kondycji domyślnego typu usługi do użycia na potrzeby monitorowanego uaktualnienia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition

Określa maksymalny procent niezatrzymanych replik na usługę dozwolonych przez zasady kondycji domyślnego typu usługi do użycia na potrzeby monitorowanego uaktualnienia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultServiceTypeUnhealthyServicesMaxPercent

Określa maksymalny procent niezatrzymanych usług dozwolonych przez zasady kondycji domyślnego typu usługi do użycia na potrzeby monitorowanego uaktualnienia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FailureAction

Określa akcję, która ma być wykonywana, jeśli monitorowane uaktualnienie zakończy się niepowodzeniem. Dopuszczalne wartości tego parametru to Wycofywanie lub Ręczne.

Typ:FailureAction
Dopuszczalne wartości:Rollback, Manual
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Kontynuuj bez monitów

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ForceRestart

Wskazuje, że host usługi uruchamia się ponownie, nawet jeśli uaktualnienie jest zmianą tylko w konfiguracji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HealthCheckRetryTimeoutSec

Określa czas trwania w sekundach, po którym usługa Service Fabric ponawia próbę sprawdzenia kondycji, jeśli poprzednia kontrola kondycji zakończy się niepowodzeniem.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HealthCheckStableDurationSec

Określa czas trwania w sekundach oczekiwania usługi Service Fabric w celu sprawdzenia, czy aplikacja jest stabilna przed przejściem do następnej domeny uaktualnienia lub ukończeniem uaktualnienia. Ten czas oczekiwania zapobiega niezkrytym zmianom kondycji bezpośrednio po wykonaniu kontroli kondycji.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HealthCheckWaitDurationSec

Określa czas trwania w sekundach oczekiwania usługi Service Fabric przed wykonaniem początkowej kontroli kondycji po zakończeniu uaktualniania w domenie uaktualnienia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Zasób aplikacji zarządzanej.

Typ:PSManagedApplication
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-InstanceCloseDelayDurationSec

Określa czas trwania w sekundach, aby poczekać przed zamknięciem wystąpienia bezstanowego, aby zezwolić na bezproblemowe opróżnianie aktywnych żądań.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określanie nazwy aplikacji

Typ:String
Aliasy:ApplicationName
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RecreateApplication

Określa, czy aplikacja powinna zostać ponownie utworzona podczas aktualizacji. Jeśli parametr value=true, pozostałe parametry zasad uaktualniania są niedozwolone.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określ nazwę grupy zasobów.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceId

Arm ResourceId aplikacji zarządzanej.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ServiceTypeHealthPolicyMap

Określa mapę zasad kondycji, które mają być używane dla różnych typów usług jako tabela skrótów w następującym formacie: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Na przykład: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Tag

Określ tagi jako pary klucz/wartość.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-UnhealthyDeployedApplicationsMaxPercent

Określa maksymalny procent wystąpień aplikacji wdrożonych w węzłach w klastrze, które mają stan kondycji błędu przed wystąpieniem błędu kondycji aplikacji dla klastra jest błędem.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradeDomainTimeoutSec

Określa maksymalny czas (w sekundach), który zajmuje usłudze Service Fabric uaktualnienie pojedynczej domeny uaktualnienia. Po upływie tego okresu uaktualnianie zakończy się niepowodzeniem.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradeMode

Tryb używany do monitorowania kondycji podczas uaktualniania stopniowego. Wartości są monitorowane i NiemonitorowaneAuto.

Typ:ApplicationUpgradeMode
Dopuszczalne wartości:Monitored, UnmonitoredAuto
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradeReplicaSetCheckTimeoutSec

Określa maksymalny czas oczekiwania usługi Service Fabric na ponowne skonfigurowanie usługi w bezpiecznym stanie, jeśli nie jest jeszcze w bezpiecznym stanie, zanim usługa Service Fabric przejdzie do uaktualnienia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradeTimeoutSec

Określa maksymalny czas w sekundach potrzebny na całe uaktualnienie usługi Service Fabric. Po upływie tego okresu uaktualnianie zakończy się niepowodzeniem.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

Dane wyjściowe