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 pakietu 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.

Parametry 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ładzie 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 w celu skopiowania zaktualizowanego pakietu 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, które obejmuje 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.

Type:	Uri
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationParameter

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

Type:	Hashtable
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationTypeVersion

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConsiderWarningAsError

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultServiceTypeHealthPolicy

Określa zasady kondycji domyślnego typu usługi do użycia dla monitorowanego uaktualnienia w formacie MaxPercent W złej kondycjiPartitionsPerservice, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Na przykład 5 10 15 wskazuje następujące wartości:

MaxPercent W złej kondycjiPartitionsPerService = 5
MaxPercent W złej kondycjiReplicasPerPartition = 10
MaxPercentUnhealthyServices = 15

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FailureAction

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

Wycofywanie
Ręcznie

Type:	UpgradeFailureAction
Accepted values:	Invalid, Rollback, Manual
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceRestart

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

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 uniemożliwia niezakryte zmiany kondycji bezpośrednio po wykonaniu kontroli kondycji.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceCloseDelayDurationSec

Określa czas trwania w sekundach, aby poczekać przed zamknięciem wystąpienia bezstanowego, na które ma wpływ uaktualnienie aplikacji, aby umożliwić bezproblemowe opróżnianie aktywnych żądań. Ten czas oczekiwania jest skuteczny tylko dla wystąpień tych usług bezstanowych, które mają wartość niezerową skonfigurowaną dla klasy InstanceCloseDelayDuration i zastąpią wstępnie skonfigurowaną wartość. Aby uzyskać szczegółowe informacje, zobacz InstanceCloseDelayDuration (in New-ServiceFabricService) .

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 uaktualni następną domenę uaktualnienia. Jeśli domena lub klaster uaktualniania nie spełnia zasad kondycji, uaktualnienie zakończy się niepowodzeniem, a usługa Service Fabric wycofa uaktualnienie domeny uaktualnienia lub przywróci tryb ręczny zgodnie z określonymi zasadami. Jest to zalecany tryb uaktualniania aplikacji w środowisku produkcyjnym.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RestartProcess

Wskazuje, że host usługi jest uruchamiany ponownie w ramach uaktualnienia.

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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"}. Przykład:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SortOrder

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

Możliwe wartości:

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 zostanie użyta kolejność sortowania liczbowego (nazwy ud posortowane jako liczby).
Lexicographical — Wskazuje, że zostanie użyta kolejność sortowania leksykograficznego (nazwy ud posortowane jako ciągi).
ReverseNumeric — Wskazuje, że zostanie użyta odwrotna kolejność sortowania liczbowego (nazwy ud posortowane jako liczby).
ReverseLexicographical— Wskazuje, że zostanie użyta odwrotna kolejność sortowania leksykograficznego (nazwy ud posortowane jako ciągi).

Type:	UpgradeSortOrder
Accepted values:	Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:	5
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnmonitoredAuto

Wskazuje, że tryb uaktualniania jest niemonitorowany automatycznie. Po uaktualnieniu domeny uaktualnienia 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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-UpgradeDomainTimeoutSec

Określa maksymalny czas w sekundach potrzebny do uaktualnienia pojedynczej domeny uaktualnienia przez usługę Service Fabric. Po upływie tego okresu uaktualnienie zakończy się niepowodzeniem.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpgradeReplicaSetCheckTimeoutSec

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

Type:	UInt32
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpgradeTimeoutSec

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

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Dane wejściowe

None

Dane wyjściowe

System.Object