Udostępnij za pośrednictwem

Update-ServiceFabricApplicationUpgrade

  • Odwołanie
Moduł:
ServiceFabric

Modyfikuje opis uaktualnienia aktywnego uaktualnienia aplikacji.

Składnia

Update-ServiceFabricApplicationUpgrade
      [-ApplicationName] <Uri>
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-DefaultServiceTypeHealthPolicy <String>]
      [-MaxPercentUnhealthyDeployedApplications <Byte>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-Force]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Update-ServiceFabricApplicationUpgrade modyfikuje parametry opisu uaktualnienia aplikacji, gdy uaktualnienie jest nadal aktywne. Usługa Service Fabric wykrywa i stosuje zmiany zgodnie z wartością UpgradeStatusPollInterval, jak określono w manifeście klastra. Z wyjątkiem zasad oceny kondycji to polecenie cmdlet aktualizuje tylko określone parametry. Nieokreślone parametry pozostają niezmienione. Należy zaktualizować razem następujące zasady oceny kondycji, a nie osobno:

  • ConsiderWarningAsError
  • DefaultServiceTypeHealthPolicy
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap

Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric ustanów połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster.

Przykłady

Przykład 1. Aktualizowanie wartości uaktualnienia aplikacji

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

To polecenie ustawia wartość limitu czasu sprawdzania zestawu replik na wartość 0 dla oczekującego uaktualnienia w sieci szkieletowej:/MyApplication. Aktualizacja pozostawia wszystkie inne wartości uaktualnienia.

Parametry

-ApplicationName

Określa identyfikator URI (Uniform Resource Identifier) aplikacji usługi Service Fabric. Polecenie cmdlet aktualizuje ustawienia uaktualnienia dla aplikacji, która ma identyfikator URI określony przez ten parametr.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-ConsiderWarningAsError

Wskazuje, czy raport kondycji ostrzeżenia ma być traktowany jako błąd podczas oceny kondycji.

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

-DefaultServiceTypeHealthPolicy

Określa domyślne zasady kondycji dla typów usług. Zasady kondycji są używane na potrzeby monitorowanego uaktualnienia. Zasady są zgodne z formatem MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices. Na przykład 5 10 15 wskazuje następujące wartości:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Typ:String
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
  • Ręcznie
Typ:UpgradeFailureAction
Dopuszczalne wartości:Invalid, Rollback, Manual
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wskazuje, że to polecenie cmdlet pomija komunikat ostrzegawczy i wymusza aktualizację.

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

-ForceRestart

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

Typ:Boolean
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:UInt32
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, zanim przejdzie do następnej domeny uaktualnienia lub ukończy uaktualnienie. Ten czas oczekiwania zapobiega niezkrytym zmianom kondycji bezpośrednio po wykonaniu kontroli kondycji.

Typ:UInt32
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:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InstanceCloseDelayDurationSec

Określa czas trwania w sekundach, aby poczekać przed zamknięciem wystąpienia bezstanowego, które ma wpływ na uaktualnienie aplikacji, aby umożliwić aktywne żądania w sposób bezproblemowy opróżniania. Ten czas oczekiwania jest skuteczny tylko dla wystąpień tych usług bezstanowych, które mają niezerową wartość skonfigurowaną dla klasy InstanceCloseDelayDuration i zastąpią wstępnie skonfigurowaną wartość. Aby uzyskać szczegółowe informacje, zobacz InstanceCloseDelayDuration.

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

-MaxPercentUnhealthyDeployedApplications

Określa maksymalny procent tolerowanych wdrożonych aplikacji, które mogą mieć stan kondycji błędu. Jeśli wartość procentowa wystąpień aplikacji w złej kondycji wdrożonych w węzłach w klastrze przekracza wartość określaną przez ten parametr, stan kondycji aplikacji to błąd.

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

-ServiceTypeHealthPolicyMap

Określa mapę zasad kondycji do użycia dla różnych typów usług. Określ mapę jako tabelę 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

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

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:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradeMode

Określa nowy UpgradeMode uaktualnienia.

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

-UpgradeReplicaSetCheckTimeoutSec

Określa maksymalny czas (w sekundach), który usługa Service Fabric czeka 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:UInt32
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:UInt32
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ść:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Dane wyjściowe

System.Object