Start-ServiceFabricApplicationUpgrade

Modul:

ServiceFabric Module

Upgraduje aplikaci Service Fabric na zadanou ApplicationTypeVersion.

Syntax

UnmonitoredAuto (Výchozí)

Start-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ApplicationTypeVersion] <String>
    [[-ApplicationParameter] <Hashtable>]
    [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
    [[-SortOrder] <UpgradeSortOrder>]
    [-ForceRestart]
    [-ReplicaQuorumTimeoutSec <UInt32>]
    [-RestartProcess]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-UnmonitoredAuto]
    [-Force]
    [-TimeoutSec <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UnmonitoredManual

Start-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ApplicationTypeVersion] <String>
    [[-ApplicationParameter] <Hashtable>]
    [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
    [[-SortOrder] <UpgradeSortOrder>]
    [-ForceRestart]
    [-ReplicaQuorumTimeoutSec <UInt32>]
    [-RestartProcess]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-UnmonitoredManual]
    [-Force]
    [-TimeoutSec <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Monitored

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

Description

Rutina Start-ServiceFabricApplicationUpgrade upgraduje aplikaci Service Fabric. Před použitím této rutiny je nutné zkopírovat aktualizovaný balíček aplikace do úložiště imagí a zaregistrovat aktualizovaný typ aplikace. Pomocí balíčku Copy-ServiceFabricApplicationPackage zkopírujte balíček aplikace do úložiště imagí. K registraci aktualizovaného typu aplikace použijte rutinu Register-ServiceFabricApplicationType .

Tato rutina spustí upgrade v clusteru.

Parametry aplikace nejsou zachovány v rámci upgradu aplikace. Aby bylo možné zachovat aktuální parametry aplikace, měl by uživatel nejprve získat parametry a předat je do volání rozhraní API pro upgrade, jak je znázorněno v příkladu 1 níže.

Další informace o upgradech aplikací Service Fabric najdete v koncepční dokumentaci.

Před provedením jakékoli operace v clusteru Service Fabric vytvořte pomocí rutiny Connect-ServiceFabricCluster připojení ke clusteru.

Příklady

Příklad 1: Získání parametrů aplikace, které mají být předány do volání upgradu

$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

Příklad 2: Upgrade aplikace

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

První příkaz pomocí rutiny Copy-ServiceFabricApplicationPackage zkopíruje aktualizovaný balíček aplikace do úložiště imagí.

Druhý příkaz používá rutinu Register-ServiceFabricApplicationType k registraci aktualizovaného typu aplikace.

Třetí příkaz aktualizuje aplikaci. Příkaz provede nemonitorovaný ruční upgrade, který zahrnuje restartování serveru, který je hostitelem aplikace.

Parametry

-ApplicationName

Určuje identifikátor URI (Uniform Resource Identifier) aplikace Service Fabric. Rutina upgraduje aplikaci, která má zadaný identifikátor URI.

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ApplicationParameter

Určuje lokální změny parametrů aplikace jako páry název/hodnota.

Vlastnosti parametru

Typ:	Hashtable
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	2
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ApplicationTypeVersion

Určuje verzi typu aplikace Service Fabric. Rutina upgraduje aplikaci na verzi, kterou zadáte.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	1
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ConsiderWarningAsError

Určuje, jestli se má událost stavu upozornění považovat za událost chyby během vyhodnocení stavu.

Vlastnosti parametru

Typ:	Boolean
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Monitored

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DefaultServiceTypeHealthPolicy

Určuje zásadu stavu pro výchozí typ služby, který se má použít pro monitorovaný upgrade ve formátu MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Například 5,10,15 označuje následující hodnoty:

• MaxPercentUnhealthyPartitionsPerService = 5
• MaxPercentUnhealthyReplicasPerPartition = 10
• MaxPercentUnhealthyServices = 15

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Monitored

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FailureAction

Určuje akci, která se má provést, pokud se monitorovaný upgrade nezdaří. Přijatelné hodnoty pro tento parametr jsou:

• Vrátit zpět
• Příručka

Vlastnosti parametru

Typ:	UpgradeFailureAction
Default value:	None
Přípustné hodnoty:	Invalid, Rollback, Manual
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Monitored

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Force

Označuje, že tato rutina přeskočí zprávu s upozorněním a vynutí upgrade.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ForceRestart

Označuje, že hostitel služby se restartuje i v případě, že upgrade je změna pouze konfigurace.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	3
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-HealthCheckRetryTimeoutSec

Určuje dobu trvání v sekundách, po které Service Fabric opakuje kontrolu stavu, pokud předchozí kontrola stavu selže.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Monitored

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Monitored

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Monitored

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InstanceCloseDelayDurationSec

Určuje dobu čekání v sekundách, než bude uzavřena bezstavová instance, která je ovlivněna upgradem aplikace, aby bylo možné řádně vyčerpat aktivní požadavky. Tato doba čekání platí pouze pro instance těch bezstavových služeb, které mají nakonfigurovanou nenulovou hodnotu pro InstanceCloseDelayDuration, a přepíše předem nakonfigurovanou hodnotu. Podrobnosti najdete v tématu InstanceCloseDelayDuration (v New-ServiceFabricService).

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MaxPercentUnhealthyDeployedApplications

Určuje maximální procento instancí aplikace nasazených v uzlech v clusteru, které mají stav chyby před chybou stavu aplikace pro cluster.

Vlastnosti parametru

Typ:	Byte
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Monitored

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Monitored

Označuje, že je režim upgradu monitorován. Pokud po dokončení upgradu upgradovací domény rutina splňuje stav upgradovací domény a clusteru vámi definované zásady stavu, Service Fabric upgraduje další upgradovací doménu. Pokud upgradovací doména nebo cluster nesplňují zásady stavu, upgrade se nezdaří a Service Fabric vrátí upgrade pro upgradovací doménu zpět nebo se vrátí do ručního režimu podle zadaných zásad. Jedná se o doporučený režim pro upgrady aplikací v produkčním prostředí.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Monitored

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ReplicaQuorumTimeoutSec

Určuje časový limit v sekundách, který slouží ke kontrole, zda je sada replik usnášeníschopná. Po uplynutí této doby upgrade pokračuje.

Tento parametr je zastaralý. Místo toho zadejte parametr UpgradeReplicaSetCheckTimeoutSec .

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-RestartProcess

Označuje, že hostitel služby se v rámci upgradu restartuje.

Tento parametr je zastaralý. Místo toho zadejte parametr ForceRestart .

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ServiceTypeHealthPolicyMap

Určuje mapu zásad stavu, které se mají použít pro různé typy služeb jako zatřiďovací tabulku v následujícím formátu: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Například:

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

Vlastnosti parametru

Typ:	Hashtable
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Monitored

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SortOrder

Definuje pořadí, ve kterém probíhá upgrade prostřednictvím clusteru.

Možné hodnoty:

• Invalid - Označuje, že toto pořadí řazení není platné. Všechny výčty Service Fabric mají neplatný typ.
• Default - Označuje, že bude použito výchozí pořadí řazení (jak je uvedeno v manifestu clusteru).
• Numeric - Označuje, že bude použito číselné pořadí řazení (názvy UD seřazené jako čísla).
• Lexicographical - Označuje, že bude použito dopředné lexikografické pořadí řazení (názvy UD seřazené jako řetězce).
• ReverseNumeric - Označuje, že bude použito obrácené číselné pořadí řazení (názvy UD seřazené jako čísla).
• ReverseLexicographical- Označuje, že bude použito obrácené lexikografické pořadí řazení (názvy UD seřazené jako řetězce).

Vlastnosti parametru

Typ:	UpgradeSortOrder
Default value:	None
Přípustné hodnoty:	Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	5
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-TimeoutSec

Určuje časový limit operace v sekundách.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-UnmonitoredAuto

Označuje, že režim upgradu není automaticky monitorován. Jakmile Service Fabric upgraduje upgradovací doménu, Service Fabric upgraduje další upgradovací doménu bez ohledu na stav aplikace. Tento režim se nedoporučuje pro produkční prostředí a je užitečný pouze při vývoji aplikace.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

UnmonitoredAuto

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-UnmonitoredManual

Označuje, že režim upgradu není monitorován ručně. Jakmile Service Fabric upgraduje upgradovací doménu, počká, až upgradujete další upgradovací doménu pomocí rutiny Resume-ServiceFabricApplicationUpgrade .

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

UnmonitoredManual

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Monitored

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	4
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Monitored

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Výstupy

System.Object

Související odkazy

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricApplicationUpgrade
• Resume-ServiceFabricApplicationUpgrade
• Copy-ServiceFabricApplicationPackage
• Register-ServiceFabricApplicationType