Update-ServiceFabricClusterUpgrade
Hiermee wijzigt u de beschrijving van de upgrade van een actieve clusterupgrade.
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
De cmdlet Update-ServiceFabricClusterUpgrade wijzigt de parameters van een beschrijving van een clusterupgrade terwijl de upgrade nog actief is. Service Fabric detecteert en past de wijzigingen toe op basis van de waarde FabricUpgradeStatusPollInterval , zoals opgegeven in het clustermanifest. Met uitzondering van beleidsregels voor statusevaluatie worden met deze cmdlet alleen de parameters bijgewerkt die u opgeeft. Niet-opgegeven parameters blijven ongewijzigd. U moet het volgende beleid voor statusevaluatie bijwerken, niet afzonderlijk:
- ConsiderWarningAsError
- MaxPercentUnhealthyApplications
- MaxPercentUnhealthyNodes
Als u Service Fabric-clusters wilt beheren, start u Windows PowerShell met behulp van de optie Uitvoeren als administrator. 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 0
Met 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 $appHealthPolicyMap
Met deze opdracht wijzigt u het clusterupgradebeleid voor clusterupgrades. Hiermee geeft u het statusbeleidsoverzicht van het toepassingstype op dat het toepassingstype CriticalAppType bevat, wat geen fouten tolereert. De rest van de toepassingen wordt geëvalueerd met 20% maximumpercentage beschadigd.
Met de opdracht wordt ook het statusbeleid voor toepassingen 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 op die aangepaste statusbeleidsregels voor sommige of alle toepassingen bevat. Als u deze parameter niet opgeeft of als u geen vermelding in de kaart voor een toepassing opneemt, 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 specifieke percentages in plaats van het globale Percentage MaxPercentUnhealthyApplications .
Als sommige toepassingen van een type bijvoorbeeld kritiek zijn, kan de clusterbeheerder een vermelding toevoegen aan de toewijzing voor dat toepassingstype en deze toewijzen aan een waarde van 0% (dat wil gezegd: geen fouten tolereren). Alle andere toepassingen kunnen worden geëvalueerd met MaxPercentUnhealthyApplications ingesteld op 20% om bepaalde fouten uit de duizenden toepassingsexemplaren te tolereren.
De statusbeleidstoewijzing van het toepassingstype wordt alleen gebruikt als het clustermanifest statusevaluatie van toepassingstypen inschakelt met behulp van de configuratievermelding voor HealthManager/EnableApplicationTypeHealthEvaluation.
Type: | ApplicationTypeHealthPolicyMap |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConsiderWarningAsError
Geeft aan of een waarschuwingsstatusrapport moet worden behandeld als fout tijdens de statusevaluatie.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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, vergelijken de statuscontroles de huidige status van het cluster met de momentopname. Als er statusvermindering is die niet voldoet aan het maximum aantal toegestane percentages van het huidige statusbeleid voor clusterupgrades, mislukken de statuscontroles.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailureAction
Hiermee geeft u de actie op die moet worden uitgevoerd als de bewaakte upgrade mislukt. De aanvaardbare waarden voor deze parameter zijn:
- Terugdraaiactie
- Handmatig.
Type: | UpgradeFailureAction |
Accepted values: | Invalid, Rollback, Manual |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Geeft aan dat deze cmdlet het waarschuwingsbericht overslaat en de update dwingt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HealthCheckRetryTimeoutSec
Hiermee geeft u de duur, in seconden, waarna Service Fabric de statuscontrole opnieuw probeert uit te proberen als de vorige statuscontrole mislukt.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HealthCheckStableDurationSec
Hiermee geeft u de duur, in seconden, dat Service Fabric wacht om te controleren of het cluster stabiel is voordat het naar het volgende upgradedomein gaat 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HealthCheckWaitDurationSec
Hiermee geeft u de duur, in seconden, dat Service Fabric wacht voordat de eerste statuscontrole wordt uitgevoerd nadat de upgrade op het upgradedomein is voltooid.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 verwijderd. Deze wachttijd is alleen van kracht voor de exemplaren van deze staatloze services die een niet-nulwaarde hebben geconfigureerd voor instanceCloseDelayDuration en overschrijft de vooraf geconfigureerde waarde. Zie InstanceCloseDelayDuration voor meer informatie.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxPercentDeltaUnhealthyNodes
Hiermee geeft u het maximaal getolereerde percentage van beschadigde deltaknooppunten op die geaggregeerde statussen van fouten 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxPercentUnhealthyNodes
Hiermee geeft u het maximaal getolereerde percentage van knooppunten met geaggregeerde statussen van fouten. Als een upgrade dit percentage overschrijdt, is het cluster beschadigd.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxPercentUpgradeDomainDeltaUnhealthyNodes
Hiermee geeft u het maximaal getolereerde percentage van upgradedomein delta beschadigde knooppunten 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NodeTypeHealthPolicyMap
Hiermee definieert u een kaart met maximale percentages beschadigde knooppunten voor specifieke knooppunttypen.
De beleidstoewijzing van het knooppunttype kan worden gebruikt tijdens de evaluatie van de clusterstatus om speciale knooppunttypen te beschrijven. De knooppunttypen die zijn opgenomen in de kaart, worden geëvalueerd op basis van het percentage dat is opgenomen in de kaart, en ook met de globale (zie System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). De knooppunten van knooppunttypen die in de kaart zijn opgegeven, worden ook meegeteld bij de globale pool van knooppunten; ze zijn onafhankelijke controles.
Type: | NodeTypeHealthPolicyMap |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutSec
Hiermee geeft u de time-outperiode, in seconden, voor de bewerking op.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeDomainTimeoutSec
Hiermee geeft u de maximale tijd in seconden op die Service Fabric nodig heeft om één upgradedomein te upgraden. Na deze periode mislukt de upgrade.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeMode
Hiermee geeft u de nieuwe UpgradeMode voor de upgrade.
Type: | RollingUpgradeMode |
Accepted values: | Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeReplicaSetCheckTimeoutSec
Hiermee geeft u de maximale tijd in seconden op dat Service Fabric wacht totdat 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 doorgaat met de upgrade.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeTimeoutSec
Hiermee geeft u de maximale tijd in seconden op die Service Fabric neemt voor de volledige upgrade. Na deze periode mislukt de upgrade.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
None
Uitvoerwaarden
System.Object