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

Start-ServiceFabricApplicationUpgrade

  • Referencia
Modul:
ServiceFabric

Frissít egy Service Fabric-alkalmazást a megadott ApplicationTypeVersion-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. A frissített alkalmazástípus regisztrálásához használja a Register-ServiceFabricApplicationType parancsmagot.

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

ApplicationParameters nem maradnak meg egy 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, ahogyan az 1. példa alább látható.

A Service Fabric-alkalmazások frissítésével kapcsolatos további információkért tekintse meg fogalmi 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: Az alkalmazásparaméterek lekérése a frissítési hívásba való továbbításhoz

$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) adja meg. A parancsmag frissíti az ön által 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

Megerősíté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 egy figyelmeztető állapoteseményt 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 jelöli:

  • 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:

  • Visszagurítás
  • Kézikönyv
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ásgazda 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álkozza az állapotellenőrzést, ha az előző állapotellenőrzés meghiúsul.

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

-HealthCheckStableDurationSec

Másodpercben megadja azt az időtartamot, amelyet a Service Fabric vár annak ellenőrzéséhez, hogy az alkalmazás stabil-e, mielőtt a következő frissítési tartományra vált, vagy befejezi a frissítést. Ez a várakozási időtartam közvetlenül az állapotellenőrzés elvégzése után megakadályozza az állapot nem észlelt változásait.

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

-HealthCheckWaitDurationSec

Megadja, hogy a Service Fabric másodpercben milyen időtartamot vár, 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

Az alkalmazásfrissítés által érintett állapot nélküli példány bezárásának időtartamát adja meg másodpercben, hogy az aktív kérések kecsesen ü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 szolgáltatáshoz konfigurálva, és felülbírálják az előre konfigurált értéket. Részletekért lásd InstanceCloseDelayDuration (New-ServiceFabricService) című cikket.

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ópontjain üzembe helyezett alkalmazáspéldányok maximális százalékos arányát, amelyek állapotállapota hiba, 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 a fürt nem felel meg az állapotszabályzatoknak, a frissítés meghiúsul, és a Service Fabric visszaállítja a frissítési tartomány frissítését, vagy a megadott házirend alapján 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

Másodpercben megadja az időtúllépési időtartamot 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 a 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 a frissítés részeként újraindul.

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ó állapotházirend térképé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.

A lehetséges értékek a következők:

  • 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 lexikális rendezési sorrendet (sztringek szerint rendezett UD-neveket) használja.
  • ReverseNumeric – Azt jelzi, hogy a fordított numerikus rendezési sorrend (számként rendezett UD-nevek) lesznek használva.
  • ReverseLexicographical– Azt jelzi, hogy a fordított lexikográfiai rendezési sorrend (sztringként rendezett UD-nevek) lesznek használva.
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 figyelt automatikus. 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

Megadja, hogy a Service Fabric másodpercben mennyi időt vesz igénybe egyetlen frissítési tartomány frissítéséhez. Ezen időszak után a frissítés meghiúsul.

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 nincs biztonságos állapotban, 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

Másodpercben megadja, hogy a Service Fabric mennyi időt vesz igénybe a teljes frissítéshez. Ezen időszak után a frissítés meghiúsul.

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

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. 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