Delen via

Update-ServiceFabricApplicationUpgrade

  • Referentie
Module:
ServiceFabric

Hiermee wijzigt u de upgradebeschrijving van een actieve toepassingsupgrade.

Syntaxis

Update-ServiceFabricApplicationUpgrade
      [-ApplicationName] <Uri>
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-DefaultServiceTypeHealthPolicy <String>]
      [-MaxPercentUnhealthyDeployedApplications <Byte>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-Force]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De cmdlet Update-ServiceFabricApplicationUpgrade wijzigt de parameters van een beschrijving van een toepassingsupgrade terwijl de upgrade nog steeds actief is. Service Fabric detecteert en past wijzigingen toe op basis van de UpgradeStatusPollInterval 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-
  • DefaultServiceTypeHealthPolicy-
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap

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 toepassingsupgrade

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

Met deze opdracht stelt u de time-outwaarde van de replicaset in op 0 voor een upgrade in behandeling op infrastructuur:/MyApplication. De update laat alle andere upgradewaarden alleen staan.

Parameters

-ApplicationName

Hiermee geeft u de URI (Uniform Resource Identifier) van een Service Fabric-toepassing op. De cmdlet werkt de instellingen voor de upgrade bij voor de toepassing met de URI die door deze parameter wordt opgegeven.

Type:Uri
Position:0
Default value:None
Vereist:True
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

-DefaultServiceTypeHealthPolicy

Hiermee geeft u het standaardstatusbeleid voor servicetypen. Statusbeleid wordt gebruikt voor de bewaakte upgrade. Het beleid volgt de indeling MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Bijvoorbeeld: 5.10.15 geeft de volgende waarden aan:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Type:String
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 de servicehost opnieuw wordt opgestart, zelfs als de upgrade alleen een configuratiewijziging is.

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 op, in seconden, dat Service Fabric wacht om te controleren of de toepassing stabiel is voordat deze 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 upgrade van de toepassing wordt gesloten, zodat de actieve aanvragen probleemloos kunnen leeglopen. 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

-MaxPercentUnhealthyDeployedApplications

Hiermee geeft u het maximumpercentage van getolereerde geïmplementeerde toepassingen op die een status van een fout kunnen hebben. Als het percentage beschadigde toepassingsexemplaren dat is geïmplementeerd op de knooppunten in het cluster de waarde overschrijdt die door deze parameter wordt opgegeven, is de status van de toepassing een fout.

Type:Byte
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServiceTypeHealthPolicyMap

Hiermee geeft u de kaart van het statusbeleid te gebruiken voor verschillende servicetypen. Geef de kaart op als een hash-tabel in de volgende indeling: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Bijvoorbeeld:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Type:Hashtable
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 totdat een service opnieuw wordt geconfigureerd 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