Update-ServiceFabricClusterUpgrade
Hiermee wijzigt u de upgradebeschrijving van een actieve clusterupgrade.
Syntaxis
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
De Update-ServiceFabricClusterUpgrade cmdlet wijzigt de parameters van een beschrijving van een clusterupgrade terwijl de upgrade nog steeds actief is. Service Fabric detecteert en past de wijzigingen toe op basis van de FabricUpgradeStatusPollInterval waarde, zoals opgegeven in het clustermanifest. Met uitzondering van beleidsregels voor statusevaluatie wordt met deze cmdlet alleen de parameters bijgewerkt die u opgeeft. Niet-opgegeven parameters blijven ongewijzigd. U moet de volgende beleidsregels voor statusevaluatie bijwerken, niet afzonderlijk:
- ConsiderWarningAsError-
- MaxPercentUnhealthyApplications
- MaxPercentUnhealthyNodes
Als u Service Fabric-clusters wilt beheren, start u Windows PowerShell met behulp van de optie Als administrator uitvoeren. Voordat u een bewerking uitvoert op een Service Fabric-cluster, maakt u een verbinding met het cluster met behulp van de cmdlet Connect-ServiceFabricCluster.
Voorbeelden
Voorbeeld 1: Een waarde bijwerken voor een clusterupgrade
PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0Met deze opdracht stelt u de time-outperiode van de replicaset in op 0 voor een clusterupgrade die in behandeling is. De update laat alle andere upgradewaarden alleen staan.
Voorbeeld 2: Statusbeleid bijwerken voor een clusterupgrade
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 $appHealthPolicyMapMet deze opdracht wordt het clusterupgradestatusbeleid gewijzigd. Hiermee geeft u de statusbeleidskaart van het toepassingstype op die het toepassingstype CriticalAppType bevat, waardoor er geen fouten worden getolereerd. De rest van de toepassingen wordt geëvalueerd met 20% maximumpercentage beschadigd.
Met de opdracht wordt ook het toepassingsstatusbeleid bijgewerkt dat wordt gebruikt om infrastructuur te evalueren:/Systeemtoepassing als onderdeel van de evaluatie van de status van de clusterupgrade. Het nieuwe beleid tolereert alle partitiefouten.
Parameters
-ApplicationHealthPolicyMap
Hiermee geeft u een System.Fabric.Health.ApplicationHealthPolicyMap met aangepast statusbeleid voor sommige of alle toepassingen. Als u deze parameter niet opgeeft of als u geen vermelding opneemt in de kaart voor een toepassing, wordt die toepassing geëvalueerd met het toepassingsstatusbeleid dat is gedefinieerd in het toepassingsmanifest als deze bestaat, of het standaardbeleid anders.
| Type: | ApplicationHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ApplicationTypeHealthPolicyMap
Hiermee geeft u de kaart op waarmee het maximumpercentage van beschadigde toepassingen wordt gedefinieerd dat per toepassingstype is toegestaan. Toepassingstypen in deze kaart worden geëvalueerd met behulp van specifieke percentages in plaats van het globale MaxPercentUnhealthyApplications percentage.
Als sommige toepassingen van een type bijvoorbeeld kritiek zijn, kan de clusterbeheerder een vermelding toevoegen aan de kaart voor dat toepassingstype en deze een waarde van 0% toewijzen (dat wil gezegd, geen fouten tolereren). Alle andere toepassingen kunnen worden geëvalueerd met MaxPercentUnhealthyApplications ingesteld op 20% om bepaalde fouten van de duizenden toepassingsexemplaren te tolereren.
De statusbeleidstoewijzing van het toepassingstype wordt alleen gebruikt als het clustermanifest de statusevaluatie van toepassingstypen inschakelt met behulp van de configuratievermelding voor HealthManager/EnableApplicationTypeHealthEvaluation.
| Type: | ApplicationTypeHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Confirm
U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.
| Type: | SwitchParameter |
| Aliassen: | cf |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ConsiderWarningAsError
Geeft aan of een waarschuwingsstatusrapport moet worden behandeld als fout tijdens de statusevaluatie.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-EnableDeltaHealthEvaluation
Geeft aan of deltastatuscontroles moeten worden ingeschakeld tijdens de statusevaluatie in bewaakte upgrades. Als u een waarde van $True opgeeft, maakt Service Fabric een momentopname van de status aan het begin van de upgrade. Nadat elk upgradedomein de upgrade heeft voltooid, vergelijkt de statuscontroles de huidige status van het cluster met de momentopname. Als er sprake is van een verslechtering van de status die niet voldoet aan het maximumaantal toegestane percentages van het huidige statusbeleid voor clusterupgrades, mislukken de statuscontroles.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-FailureAction
Hiermee geeft u de actie op die moet worden uitgevoerd als de bewaakte upgrade mislukt. De acceptabele waarden voor deze parameter zijn:
- Terugdraaien
- Handmatig.
| Type: | UpgradeFailureAction |
| Geaccepteerde waarden: | Invalid, Rollback, Manual |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Force
Geeft aan dat deze cmdlet het waarschuwingsbericht overslaat en de update dwingt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ForceRestart
Geeft aan of het Service Fabric-knooppunt opnieuw moet worden opgestart, zelfs als alleen dynamische configuraties zijn gewijzigd.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-HealthCheckRetryTimeoutSec
Hiermee geeft u de duur op, in seconden, waarna Service Fabric de statuscontrole opnieuw probeert uit te proberen als de vorige statuscontrole mislukt.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-HealthCheckStableDurationSec
Hiermee geeft u de duur, in seconden, dat Service Fabric wacht om te controleren of het cluster stabiel is voordat het doorgaat naar het volgende upgradedomein of de upgrade voltooit. Deze wachttijd voorkomt niet-gedetecteerde wijzigingen van de status direct nadat de statuscontrole is uitgevoerd.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-HealthCheckWaitDurationSec
Hiermee geeft u de duur in seconden op die Service Fabric wacht voordat de eerste statuscontrole wordt uitgevoerd nadat de upgrade op het upgradedomein is voltooid.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-InstanceCloseDelayDurationSec
Hiermee geeft u de duur in seconden op om te wachten voordat een staatloze instantie die wordt beïnvloed door de clusterupgrade wordt gesloten, zodat de actieve aanvragen probleemloos kunnen worden uitgevoerd. Deze wachttijd is alleen van kracht voor de exemplaren van die staatloze services waarvoor een niet-nulwaarde is geconfigureerd voor instanceCloseDelayDuration en wordt de vooraf geconfigureerde waarde overschreven. Zie InstanceCloseDelayDuration- voor meer informatie.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-MaxPercentDeltaUnhealthyNodes
Hiermee geeft u het maximaal getolereerde percentage van beschadigde deltaknooppunten op die geaggregeerde statussen van fout kunnen hebben. Als de huidige beschadigde knooppunten het percentage ten opzichte van de status aan het begin van de upgrade niet respecteren, is het cluster beschadigd.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-MaxPercentUnhealthyApplications
Hiermee geeft u het maximaal getolereerde percentage toepassingen op dat de status van de fout kan aggregeren. Als de upgrade dit percentage overschrijdt, is het cluster beschadigd.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-MaxPercentUnhealthyNodes
Hiermee geeft u het maximaal getolereerde percentage van knooppunten met geaggregeerde statussen van fout. Als een upgrade dit percentage overschrijdt, is het cluster beschadigd.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-MaxPercentUpgradeDomainDeltaUnhealthyNodes
Hiermee geeft u het maximaal getolereerde percentage van de beschadigde knooppunten van het upgradedomein aan die de status van de fout kunnen aggregeren. Als er een upgradedomein is waarbij de huidige beschadigde knooppunten het percentage ten opzichte van de status aan het begin van de upgrade niet respecteren, is het cluster beschadigd.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-NodeTypeHealthPolicyMap
Hiermee definieert u een kaart met maximale percentages beschadigde knooppunten voor specifieke knooppunttypen.
De statusbeleidstoewijzing van het knooppunttype kan worden gebruikt tijdens de evaluatie van de clusterstatus om speciale knooppunttypen te beschrijven. De knooppunttypen die in de kaart zijn opgenomen, worden geëvalueerd op basis van het percentage dat is opgenomen in de kaart, en ook met de globale typen (zie System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). De knooppunten van knooppunttypen die in de kaart zijn opgegeven, worden ook meegeteld voor de globale pool van knooppunten; zij zijn onafhankelijke controles.
| Type: | NodeTypeHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-TimeoutSec
Hiermee geeft u de time-outperiode, in seconden, voor de bewerking.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-UpgradeDomainTimeoutSec
Hiermee geeft u de maximale tijd in seconden op die Service Fabric nodig heeft om één upgradedomein bij te werken. Na deze periode mislukt de upgrade.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-UpgradeMode
Hiermee geeft u de nieuwe UpgradeMode voor de upgrade.
| Type: | RollingUpgradeMode |
| Geaccepteerde waarden: | Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-UpgradeReplicaSetCheckTimeoutSec
Hiermee geeft u de maximale tijd in seconden op dat Service Fabric wacht tot een replica die is ingesteld om opnieuw te configureren in een veilige status, als deze nog niet in een veilige status is, voordat Service Fabric verdergaat met de upgrade.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-UpgradeTimeoutSec
Hiermee geeft u de maximale tijd in seconden op die Service Fabric nodig heeft voor de volledige upgrade. Na deze periode mislukt de upgrade.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-WhatIf
Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
| Type: | SwitchParameter |
| Aliassen: | wi |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Invoerwaarden
None
Uitvoerwaarden
System.Object