Megosztás a következőn keresztül:

Start-ServiceFabricApplicationUpgrade

  • Referencia
Modul:
ServiceFabric

Frissíti a Service Fabric-alkalmazást a megadott ApplicationTypeVersion verzióra.

Syntax

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

Description

A Start-ServiceFabricApplicationUpgrade parancsmag frissít egy Service Fabric-alkalmazást. A parancsmag használata előtt át kell másolnia a frissített alkalmazáscsomagot a képtárolóba, és regisztrálnia kell a frissített alkalmazástípust. Az alkalmazáscsomag képtárolóba másolásához használja a Copy-ServiceFabricApplicationPackage parancsot. A Register-ServiceFabricApplicationType parancsmaggal regisztrálja a frissített alkalmazástípust.

Ez a parancsmag elindítja a frissítést a fürtön.

Az alkalmazásparaméterek nem maradnak meg az alkalmazásfrissítés során. Az aktuális alkalmazásparaméterek megőrzése érdekében a felhasználónak először le kell szereznie a paramétereket, majd át kell adnia őket a frissítési API-hívásba, az alábbi 1. példában látható módon.

A Service Fabric-alkalmazások frissítésével kapcsolatos további információkért tekintse meg az elméleti dokumentációt.

Mielőtt bármilyen műveletet végrehajt egy Service Fabric-fürtön, hozzon létre kapcsolatot a fürttel a Connect-ServiceFabricCluster parancsmag használatával.

Példák

1. példa: A frissítési hívásba átadó alkalmazásparaméterek lekérése

$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

2. példa: Alkalmazás frissítése

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

Az első parancs a Copy-ServiceFabricApplicationPackage parancsmaggal másolja a frissített alkalmazáscsomagot a képtárolóba.

A második parancs a Register-ServiceFabricApplicationType parancsmaggal regisztrálja a frissített alkalmazástípust.

A harmadik parancs frissíti az alkalmazást. A parancs nem figyelt manuális frissítést hajt végre, amely magában foglalja az alkalmazást üzemeltető kiszolgáló újraindítását.

Paraméterek

-ApplicationName

Egy Service Fabric-alkalmazás egységes erőforrás-azonosítóját (URI-ját) adja meg. A parancsmag frissíti a megadott URI-t tartalmazó alkalmazást.

Típus:Uri
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ApplicationParameter

Az alkalmazásparaméterek felülbírálásait adja meg név-érték párként.

Típus:Hashtable
Position:2
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ApplicationTypeVersion

A Service Fabric-alkalmazástípus verzióját adja meg. A parancsmag frissíti az alkalmazást a megadott verzióra.

Típus:String
Position:1
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ConsiderWarningAsError

Azt jelzi, hogy a figyelmeztető állapoteseményeket hibaeseményként kell-e kezelni az állapotértékelés során.

Típus:Boolean
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultServiceTypeHealthPolicy

Megadja a figyelt frissítéshez használandó alapértelmezett szolgáltatástípus állapotszabályzatát MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices formátumban. Az 5 10,15 például a következő értékeket jelzi:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-FailureAction

Megadja a figyelt frissítés meghiúsulása esetén végrehajtandó műveletet. A paraméter elfogadható értékei a következők:

  • Visszaállítás
  • Kézi
Típus:UpgradeFailureAction
Elfogadott értékek:Invalid, Rollback, Manual
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Force

Azt jelzi, hogy ez a parancsmag kihagyja a figyelmeztető üzenetet, és kényszeríti a frissítést.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ForceRestart

Azt jelzi, hogy a szolgáltatás gazdagépe akkor is újraindul, ha a frissítés csak konfigurációs módosítás.

Típus:SwitchParameter
Position:3
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-HealthCheckRetryTimeoutSec

Azt az időtartamot adja meg másodpercben, amely után a Service Fabric újrapróbálkozásokat tesz az állapot-ellenőrzésre, ha az előző állapotellenőrzés sikertelen volt.

Típus:UInt32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-HealthCheckStableDurationSec

Azt az időtartamot adja meg másodpercben, amellyel a Service Fabric megvárja annak ellenőrzését, hogy az alkalmazás stabil-e, mielőtt továbblépne a következő frissítési tartományra, vagy befejezi a frissítést. Ez a várakozási időtartam közvetlenül az állapot-ellenőrzés végrehajtása után megakadályozza a nem észlelt állapotváltozásokat.

Típus:UInt32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-HealthCheckWaitDurationSec

Azt az időtartamot adja meg másodpercben, amellyel a Service Fabric megvárja, mielőtt végrehajtja a kezdeti állapot-ellenőrzést, miután befejezte a frissítési tartomány frissítését.

Típus:UInt32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-InstanceCloseDelayDurationSec

Megadja az időtartamot másodpercben, hogy megvárja az alkalmazásfrissítés által érintett állapot nélküli példány bezárását, hogy az aktív kérések szabályosan üríthessenek. Ez a várakozási időtartam csak azon állapot nélküli szolgáltatások példányai esetében érvényes, amelyek nem nulla értékűek az InstanceCloseDelayDuration számára, és felülbírálják az előre konfigurált értéket. A részleteket az InstanceCloseDelayDuration (in) című témakörben New-ServiceFabricServicetalálja.

Típus:UInt32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaxPercentUnhealthyDeployedApplications

Meghatározza a fürt azon csomópontjaira telepített alkalmazáspéldányok maximális százalékos arányát, amelyek hibás állapotban vannak, mielőtt a fürt alkalmazásállapota hiba lenne.

Típus:Byte
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Monitored

Azt jelzi, hogy a frissítési mód figyelve van. Miután a parancsmag befejezte egy frissítési tartomány frissítését, ha a frissítési tartomány és a fürt állapota megfelel a megadott állapotszabályzatoknak, a Service Fabric frissíti a következő frissítési tartományt. Ha a frissítési tartomány vagy fürt nem felel meg az állapotszabályzatoknak, a frissítés sikertelen lesz, és a Service Fabric visszaállítja a frissítési tartomány frissítését, vagy a megadott szabályzatnak megfelelően visszaállítja a manuális üzemmódot. Ez az ajánlott mód az éles környezetben történő alkalmazásfrissítésekhez.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ReplicaQuorumTimeoutSec

Megadja az időtúllépési időtartamot másodpercben annak ellenőrzéséhez, hogy a replikakészlet rendelkezik-e kvórumjelekkel. Az időtúllépési időszak után a frissítés folytatódik.

Ez a paraméter elavult. Ehelyett adja meg az UpgradeReplicaSetCheckTimeoutSec paramétert.

Típus:UInt32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-RestartProcess

Azt jelzi, hogy a szolgáltatás gazdagépe újraindul a frissítés részeként.

Ez a paraméter elavult. Ehelyett adja meg a ForceRestart paramétert.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ServiceTypeHealthPolicyMap

A különböző szolgáltatástípusokhoz használandó állapotszabályzat leképezését adja meg kivonattáblaként a következő formátumban: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Például:

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

Típus:Hashtable
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SortOrder

Meghatározza, hogy a frissítés milyen sorrendben haladjon végig a fürtön.

Lehetséges értékek:

  • Invalid – Azt jelzi, hogy ez a rendezési sorrend érvénytelen. Minden Service Fabric-enumerálás érvénytelen típussal rendelkezik.
  • Default – Azt jelzi, hogy a rendszer az alapértelmezett rendezési sorrendet használja (a fürtjegyzékben megadottak szerint).
  • Numeric – Azt jelzi, hogy a program numerikus rendezési sorrendet (számként rendezett UD-neveket) használ.
  • Lexicographical – Azt jelzi, hogy a függvény a lexikográfiai rendezési sorrendet (sztringekként rendezett UD-neveket) fogja használni.
  • ReverseNumeric – Azt jelzi, hogy a rendszer fordított numerikus rendezési sorrendet (számként rendezett UD-neveket) használ.
  • ReverseLexicographical- Azt jelzi, hogy a rendszer fordított lexikográfiai rendezési sorrendet (sztringekként rendezett UD-neveket) használ.
Típus:UpgradeSortOrder
Elfogadott értékek:Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:5
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-TimeoutSec

A művelet időtúllépési időtartamát adja meg másodpercben.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-UnmonitoredAuto

Azt jelzi, hogy a frissítési mód nem figyel automatikusan. Miután a Service Fabric frissített egy frissítési tartományt, a Service Fabric az alkalmazás állapotától függetlenül frissíti a következő frissítési tartományt. Ez a mód éles környezetben nem ajánlott, és csak egy alkalmazás fejlesztése során hasznos.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-UnmonitoredManual

Azt jelzi, hogy a frissítési mód nem figyelt manuális. Miután a Service Fabric frissített egy frissítési tartományt, megvárja a következő frissítési tartomány frissítését a Resume-ServiceFabricApplicationUpgrade parancsmag használatával.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-UpgradeDomainTimeoutSec

Meghatározza, hogy a Service Fabric legfeljebb másodpercben frissíthet egyetlen frissítési tartományt. Ezt követően a frissítés sikertelen lesz.

Típus:UInt32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-UpgradeReplicaSetCheckTimeoutSec

Azt a maximális időt adja meg, amíg a Service Fabric megvárja, amíg egy szolgáltatás biztonságos állapotba kerül, ha még nem biztonságos állapotban van, mielőtt a Service Fabric folytatja a frissítést.

Típus:UInt32
Position:4
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-UpgradeTimeoutSec

A Service Fabric által a teljes frissítéshez szükséges maximális időt adja meg másodpercben. Ezt követően a frissítés sikertelen lesz.

Típus:UInt32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

None

Kimenetek

System.Object