Udostępnij za pośrednictwem

Start-ServiceFabricApplicationUpgrade

  • Odwołanie
Moduł:
ServiceFabric

Uaktualnia aplikację usługi Service Fabric do określonej klasy ApplicationTypeVersion.

Składnia

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Opis

Polecenie cmdlet Start-ServiceFabricApplicationUpgrade uaktualnia aplikację usługi Service Fabric. Przed użyciem tego polecenia cmdlet należy skopiować zaktualizowany pakiet aplikacji do magazynu obrazów i zarejestrować zaktualizowany typ aplikacji. Użyj Copy-ServiceFabricApplicationPackage, aby skopiować pakiet aplikacji do magazynu obrazów. Użyj polecenia cmdlet Register-ServiceFabricApplicationType, aby zarejestrować zaktualizowany typ aplikacji.

To polecenie cmdlet uruchamia uaktualnienie w klastrze.

ApplicationParameters nie są zachowywane w ramach uaktualnienia aplikacji. Aby zachować bieżące parametry aplikacji, użytkownik powinien najpierw pobrać parametry i przekazać je do wywołania interfejsu API uaktualniania, jak pokazano w przykład 1 poniżej.

Aby uzyskać więcej informacji na temat uaktualnień aplikacji usługi Service Fabric, zobacz dokumentację koncepcyjną .

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. Pobieranie parametrów aplikacji w celu przekazania do wywołania uaktualnienia

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}

foreach ($pair in $appParamCollection)
{ $applicationParameterMap.Add($pair.Name, $pair.Value); }

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

Przykład 2. Uaktualnianie aplikacji

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\PersistentToDoListServiceV2" -ImageStoreConnectionString "file:C:\ProgramData\ServiceFabric\ImageStore"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListServiceV2"
PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeVersion "2.0" -ForceRestart -UnMonitoredManual

Pierwsze polecenie używa polecenia cmdlet Copy-ServiceFabricApplicationPackage, aby skopiować zaktualizowany pakiet aplikacji do magazynu obrazów.

Drugie polecenie używa polecenia cmdlet Register-ServiceFabricApplicationType w celu zarejestrowania zaktualizowanego typu aplikacji.

Trzecie polecenie uaktualnia aplikację. Polecenie wykonuje niemonitorowane ręczne uaktualnianie, w tym ponowne uruchomienie serwera, który hostuje aplikację.

Parametry

-ApplicationName

Określa identyfikator URI (Uniform Resource Identifier) aplikacji usługi Service Fabric. Polecenie cmdlet uaktualnia aplikację z określonym identyfikatorem URI.

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

-ApplicationParameter

Określa przesłonięcia parametrów aplikacji jako pary nazwa/wartość.

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

-ApplicationTypeVersion

Określa wersję typu aplikacji usługi Service Fabric. Polecenie cmdlet uaktualnia aplikację do określonej wersji.

Typ:String
Position:1
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 zdarzenie kondycji ostrzeżenia ma być traktowane jako zdarzenie błędu 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 zasady kondycji domyślnego typu usługi do użycia dla monitorowanego uaktualnienia w formacie MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, 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:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

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

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:3
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 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: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 (w New-ServiceFabricService).

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

-Monitored

Wskazuje, że tryb uaktualniania jest monitorowany. Po zakończeniu uaktualniania domeny uaktualnienia przez polecenie cmdlet, jeśli kondycja domeny uaktualnienia i klastra spełniają zdefiniowane zasady kondycji, usługa Service Fabric uaktualnia następną domenę uaktualnienia. Jeśli domena uaktualnienia lub klaster nie spełniają zasad kondycji, uaktualnienie zakończy się niepowodzeniem, a usługa Service Fabric wycofa uaktualnienie domeny uaktualnienia lub powróci do trybu ręcznego zgodnie z określonymi zasadami. Jest to tryb zalecany dla uaktualnień aplikacji w środowisku produkcyjnym.

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

-ReplicaQuorumTimeoutSec

Określa limit czasu w sekundach, aby sprawdzić, czy zestaw replik ma kworum. Po upływie limitu czasu uaktualnianie będzie kontynuowane.

Ten parametr został przestarzały. Określ zamiast tego parametr UpgradeReplicaSetCheckTimeoutSec.

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

-RestartProcess

Wskazuje, że host usługi zostanie uruchomiony ponownie w ramach uaktualnienia.

Ten parametr został przestarzały. Określ zamiast tego parametr ForceRestart.

Typ:SwitchParameter
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 jako tabeli skrótów w następującym formacie: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartitions,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

-SortOrder

Definiuje kolejność, w której uaktualnienie jest kontynuowane przez klaster.

Możliwe wartości to:

  • Invalid — wskazuje, że ta kolejność sortowania jest nieprawidłowa. Wszystkie wyliczenia usługi Service Fabric mają nieprawidłowy typ.
  • Default — wskazuje, że zostanie użyta domyślna kolejność sortowania (określona w manifeście klastra).
  • Numeric — wskazuje, że będzie używana kolejność sortowania liczbowego (nazwy zdefiniowane przez użytkownika posortowane jako liczby).
  • Lexicographical — wskazuje, że będzie używana kolejność sortowania leksykograficznego (nazwy ud posortowane jako ciągi).
  • ReverseNumeric — wskazuje, że będzie używana odwrotna kolejność sortowania liczbowego (nazwy zdefiniowane przez użytkownika posortowane jako liczby).
  • ReverseLexicographical— wskazuje, że będzie używana odwrotna kolejność sortowania leksykograficznego (nazwy ud posortowane jako ciągi).
Typ:UpgradeSortOrder
Dopuszczalne wartości:Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:5
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

-UnmonitoredAuto

Wskazuje, że tryb uaktualniania jest niemonitorowany automatycznie. Po uaktualnieniu domeny uaktualnienia usługi Service Fabric usługa Service Fabric uaktualnia następną domenę uaktualnienia niezależnie od stanu kondycji aplikacji. Ten tryb nie jest zalecany w środowisku produkcyjnym i jest przydatny tylko podczas tworzenia aplikacji.

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

-UnmonitoredManual

Wskazuje, że tryb uaktualniania jest niemonitorowany ręcznie. Po uaktualnieniu domeny uaktualnienia usługi Service Fabric czeka na uaktualnienie następnej domeny uaktualnienia przy użyciu polecenia cmdlet Resume-ServiceFabricApplicationUpgrade.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
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

-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:UInt32
Position:4
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