Update-ServiceFabricClusterUpgrade
Ändrar uppgraderingsbeskrivningen för en aktiv klusteruppgradering.
Syntax
Update-ServiceFabricClusterUpgrade
[-ForceRestart <Boolean>]
[-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
[-UpgradeMode <RollingUpgradeMode>]
[-FailureAction <UpgradeFailureAction>]
[-HealthCheckRetryTimeoutSec <UInt32>]
[-HealthCheckWaitDurationSec <UInt32>]
[-HealthCheckStableDurationSec <UInt32>]
[-UpgradeDomainTimeoutSec <UInt32>]
[-UpgradeTimeoutSec <UInt32>]
[-ConsiderWarningAsError <Boolean>]
[-MaxPercentUnhealthyApplications <Byte>]
[-MaxPercentUnhealthyNodes <Byte>]
[-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
[-EnableDeltaHealthEvaluation <Boolean>]
[-MaxPercentDeltaUnhealthyNodes <Byte>]
[-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
[-Force]
[-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
[-InstanceCloseDelayDurationSec <UInt32>]
[-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Cmdleten Update-ServiceFabricClusterUpgrad e ändrar parametrarna för en beskrivning av klusteruppgradering medan uppgraderingen fortfarande är aktiv. Service Fabric identifierar och tillämpar ändringarna enligt värdet FabricUpgradeStatusPollInterval enligt vad som anges i klustermanifestet. Förutom hälsoutvärderingsprinciper uppdaterar den här cmdleten endast de parametrar som du anger. Ospecificerade parametrar påverkas inte. Du måste uppdatera följande hälsoutvärderingsprinciper tillsammans, inte individuellt:
- ConsiderWarningAsError
- MaxPercentUnhealthyApplications
- MaxPercentUnhealthyNodes
Om du vill hantera Service Fabric-kluster startar du Windows PowerShell med alternativet Kör som administratör. Innan du utför någon åtgärd i ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster.
Exempel
Exempel 1: Uppdatera ett värde för en klusteruppgradering
PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0Det här kommandot anger tidsgränsen för replikuppsättningen till 0 för en väntande klusteruppgradering. Uppdateringen lämnar alla andra uppgraderingsvärden ensamma.
Exempel 2: Uppdatera hälsoprincipen för en klusteruppgradering
PS C:\> $svcType = New-Object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
PS C:\> $svcType.MaxPercentUnhealthyPartitionsPerService = 100
PS C:\> $systemAppPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
PS C:\> $systemAppPolicy.DefaultServiceTypeHealthPolicy = $svcType
PS C:\> $appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
PS C:\> $appHealthPolicyMap.Add("fabric:/System", $systemAppPolicy)
PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)
PS C:\> Update-ServiceFabricClusterUpgrade -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -Force -MaxPercentUnhealthyApplications 20 -ApplicationHealthPolicyMap $appHealthPolicyMapDet här kommandot ändrar klusteruppgraderingsklustrets hälsoprincip. Den anger den hälsoprincipkarta för programtyp som innehåller programtypen CriticalAppType, som inte tolererar några fel. Resten av programmen utvärderas med hjälp av 20% maximalt antal procent som inte är felfria.
Kommandot uppdaterar även programhälsoprincipen som används för att utvärdera infrastrukturresurser:/Systemprogram som en del av hälsoutvärderingen av klusteruppgradering. De nya principerna tolererar alla partitionsfel.
Parametrar
-ApplicationHealthPolicyMap
Anger en System.Fabric.Health.ApplicationHealthPolicyMap som innehåller anpassade hälsoprinciper för vissa eller alla program. Om du inte anger den här parametern, eller om du inte inkluderar en post i kartan för ett program, utvärderas programmet med den programhälsoprincip som definierats i programmanifestet om den finns eller standardprincipen på annat sätt.
| Typ: | ApplicationHealthPolicyMap |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ApplicationTypeHealthPolicyMap
Anger den karta som definierar den maximala procentandelen program med feltillstånd som tillåts per programtyp. Programtyper i den här kartan utvärderas med hjälp av specifika procentandelar i stället för den globala MaxPercentUnhealthyApplications procent.
Om vissa program av en typ till exempel är kritiska kan klusteradministratören lägga till en post på kartan för den programtypen och tilldela den värdet 0% (det vill säga tolerera inte några fel). Alla andra program kan utvärderas med MaxPercentUnhealthyApplications inställt på 20% för att tolerera vissa fel av de tusentals programinstanserna.
Mappningen av hälsoprincip för programtyp används endast om klustermanifestet aktiverar hälsoutvärdering av programtyp med hjälp av konfigurationsposten för HealthManager/EnableApplicationTypeHealthEvaluation.
| Typ: | ApplicationTypeHealthPolicyMap |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
| Typ: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ConsiderWarningAsError
Anger om en varningshälsorapport ska behandlas som ett fel under hälsoutvärderingen.
| Typ: | Boolean |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-EnableDeltaHealthEvaluation
Anger om deltahälsokontroller ska aktiveras under hälsoutvärderingen i övervakade uppgraderingar. Om du anger värdet $True tar Service Fabric en ögonblicksbild av hälsotillståndet i början av uppgraderingen. När varje uppgraderingsdomän har slutfört uppgraderingen jämför hälsokontrollerna klustrets aktuella tillstånd med ögonblicksbilden. Om det finns en hälsoförsämring som inte respekterar högsta tillåtna procentsatser från den aktuella hälsoprincipen för klusteruppgradering misslyckas hälsokontrollerna.
| Typ: | Boolean |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-FailureAction
Anger vilken åtgärd som ska vidtas om den övervakade uppgraderingen misslyckas. De godtagbara värdena för den här parametern är:
- Ångring
- Handbok.
| Typ: | UpgradeFailureAction |
| Godkända värden: | Invalid, Rollback, Manual |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Force
Anger att den här cmdleten hoppar över varningsmeddelandet och tvingar uppdateringen.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ForceRestart
Anger om service fabric-noden ska startas om även om endast dynamiska konfigurationer har ändrats.
| Typ: | Boolean |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-HealthCheckRetryTimeoutSec
Anger varaktigheten, i sekunder, varefter Service Fabric försöker utföra hälsokontrollen igen om den tidigare hälsokontrollen misslyckas.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-HealthCheckStableDurationSec
Anger varaktigheten i sekunder som Service Fabric väntar för att kontrollera att klustret är stabilt innan det fortsätter till nästa uppgraderingsdomän eller slutför uppgraderingen. Den här väntetiden förhindrar oupptäckta hälsoändringar direkt efter att hälsokontrollen har utförts.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-HealthCheckWaitDurationSec
Anger varaktigheten, i sekunder, som Service Fabric väntar innan den utför den första hälsokontrollen när uppgraderingen har slutförts på uppgraderingsdomänen.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-InstanceCloseDelayDurationSec
Anger varaktigheten i sekunder, att vänta innan en tillståndslös instans som påverkas av klusteruppgradering stängs, så att aktiva begäranden kan tömmas korrekt. Den här väntetiden gäller endast för instanser av de tillståndslösa tjänster som har ett värde som inte är noll och som har konfigurerats för InstanceCloseDelayDuration och som åsidosätter det förkonfigurerade värdet. Mer information finns i InstanceCloseDelayDuration.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-MaxPercentDeltaUnhealthyNodes
Anger den maximala tillåtna procentandelen av deltafelnoder som kan ha aggregerade hälsotillstånd för fel. Om de aktuella inte felfria noderna inte respekterar procentandelen i förhållande till tillståndet i början av uppgraderingen är klustret inte felfri.
| Typ: | Byte |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-MaxPercentUnhealthyApplications
Anger den maximala tillåtna procentandelen program som kan ha aggregerat hälsotillstånd för fel. Om uppgraderingen överskrider den här procentandelen är klustret inte felfri.
| Typ: | Byte |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-MaxPercentUnhealthyNodes
Anger den maximala tillåtna procentandelen noder som kan ha aggregerade feltillstånd. Om en uppgradering överskrider den här procentandelen är klustret inte felfri.
| Typ: | Byte |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-MaxPercentUpgradeDomainDeltaUnhealthyNodes
Anger den maximala tillåtna procentandelen av uppgraderingsdomänens deltafelnoder som kan ha aggregerat hälsotillstånd för fel. Om det finns en uppgraderingsdomän där de aktuella inte felfria noderna inte respekterar procentandelen i förhållande till tillståndet i början av uppgraderingen är klustret inte felfritt.
| Typ: | Byte |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-NodeTypeHealthPolicyMap
Definierar en karta med maximala procentuella noder som inte är felfria för specifika nodtyper.
Mappningen av nodtypens hälsoprincip kan användas under utvärdering av klusterhälsa för att beskriva särskilda nodtyper. Nodtyperna som ingår i kartan utvärderas mot procentandelen som ingår i kartan och även med den globala (se System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Noderna för nodtyper som anges i kartan räknas också mot den globala nodpoolen. de är oberoende kontroller.
| Typ: | NodeTypeHealthPolicyMap |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-TimeoutSec
Anger tidsgränsen i sekunder för åtgärden.
| Typ: | Int32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UpgradeDomainTimeoutSec
Anger den maximala tid i sekunder som Service Fabric tar att uppgradera en enda uppgraderingsdomän. Efter den här perioden misslyckas uppgraderingen.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UpgradeMode
Anger den nya UpgradeMode för uppgraderingen.
| Typ: | RollingUpgradeMode |
| Godkända värden: | Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UpgradeReplicaSetCheckTimeoutSec
Anger den maximala tiden i sekunder som Service Fabric väntar på att en replik ska konfigureras om till ett säkert tillstånd, om den inte redan är i säkert tillstånd, innan Service Fabric fortsätter med uppgraderingen.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UpgradeTimeoutSec
Anger den maximala tid i sekunder som Service Fabric tar för hela uppgraderingen. Efter den här perioden misslyckas uppgraderingen.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-WhatIf
Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.
| Typ: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
Indata
None
Utdata
System.Object