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-ServiceFabricClusterUpgrade ändrar parametrarna för en beskrivning av klusteruppgraderingen 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 denna cmdlet 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 en åtgärd på 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 0
Det 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 $appHealthPolicyMap
Det här kommandot ändrar klusteruppgraderingsprincipen för klusterhälsa. Den anger programtypens hälsoprincipkarta som innehåller programtypen CriticalAppType, som inte tolererar fel. Resten av programmen utvärderas med maximalt 20 % fel i procent.
Kommandot uppdaterar även den programhälsoprincip 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.
Type: | ApplicationHealthPolicyMap |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationTypeHealthPolicyMap
Anger kartan 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 procentsatsen MaxPercentUnhealthyApplications .
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 fel). Alla andra program kan utvärderas med MaxPercentUnhealthyApplications inställt på 20 % för att tolerera vissa fel av de tusentals programinstanserna.
Programtypens hälsoprincipkarta används endast om klustermanifestet aktiverar hälsoutvärdering av programtyp med hjälp av konfigurationsposten för HealthManager/EnableApplicationTypeHealthEvaluation.
Type: | ApplicationTypeHealthPolicyMap |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConsiderWarningAsError
Anger om en varningshälsorapport ska behandlas som ett fel under hälsoutvärderingen.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailureAction
Anger vilken åtgärd som ska vidtas om den övervakade uppgraderingen misslyckas. De acceptabla värdena för den här parametern är:
- Återställning
- Manuell.
Type: | UpgradeFailureAction |
Accepted values: | Invalid, Rollback, Manual |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Anger att denna cmdlet hoppar över varningsmeddelandet och tvingar uppdateringen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceRestart
Anger om du vill starta om Service Fabric-noden även om endast dynamiska konfigurationer har ändrats.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HealthCheckRetryTimeoutSec
Anger varaktigheten, i sekunder, varefter Service Fabric försöker utföra hälsokontrollen igen om den tidigare hälsokontrollen misslyckas.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HealthCheckStableDurationSec
Anger varaktigheten i sekunder som Service Fabric väntar för att verifiera 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.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceCloseDelayDurationSec
Anger varaktigheten i sekunder, att vänta innan en tillståndslös instans som påverkas av klusteruppgraderingen stängs, så att de aktiva begärandena kan tömmas korrekt. Den här väntetiden gäller endast för instanser av tillståndslösa tjänster som har ett värde som inte är noll konfigurerat för InstanceCloseDelayDuration och åsidosätter det förkonfigurerade värdet. Mer information finns i InstanceCloseDelayDuration .
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxPercentDeltaUnhealthyNodes
Anger den maximala tolererade procentandelen deltanoder med feltillstånd som kan ha aggregerade feltillstånd. Om de aktuella inte felfria noderna inte respekterar procentandelen i förhållande till tillståndet i början av uppgraderingen är klustret inte felfritt.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 felfritt.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 felfritt.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxPercentUpgradeDomainDeltaUnhealthyNodes
Anger den maximala tolererade procentandelen av uppgraderingsdomänens delta-noder som inte är felfria och 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.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NodeTypeHealthPolicyMap
Definierar en karta med maximala procentandelar ej felfria noder för specifika nodtyper.
Mappningen av nodtypens hälsoprincip kan användas under utvärderingen 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 poolen med noder. de är oberoende kontroller.
Type: | NodeTypeHealthPolicyMap |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutSec
Anger tidsgränsen i sekunder för åtgärden.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeMode
Anger den nya UpgradeMode för uppgraderingen.
Type: | RollingUpgradeMode |
Accepted values: | Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeReplicaSetCheckTimeoutSec
Anger den längsta tid 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 ett säkert tillstånd, innan Service Fabric fortsätter med uppgraderingen.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeTimeoutSec
Anger den maximala tid i sekunder som Service Fabric tar för hela uppgraderingen. Efter den här perioden misslyckas uppgraderingen.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
None
Utdata
System.Object