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 actief is. Service Fabric detecteert en past wijzigingen toe op basis van de waarde UpgradeStatusPollInterval , 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
  • 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. Met de cmdlet worden de instellingen voor de upgrade bijgewerkt voor de toepassing met de URI die met deze parameter wordt opgegeven.

Type:Uri
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u 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 aanvaardbare waarden voor deze parameter zijn:

  • Terugdraaiactie
  • 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 een configuratiewijziging is.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-HealthCheckStableDurationSec

Hiermee geeft u de duur, in seconden, dat Service Fabric wacht om te controleren of de toepassing stabiel is voordat het verdergaat met het volgende upgradedomein of voltooit de upgrade. 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, 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
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 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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaxPercentUnhealthyDeployedApplications

Hiermee geeft u het maximumpercentage van getolereerde geïmplementeerde toepassingen op die een status van fout kunnen hebben. Als het percentage beschadigde toepassingsexemplaren dat is geïmplementeerd op de knooppunten in het cluster de waarde overschrijdt die met 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 dat moet worden gebruikt 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 op.

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 te upgraden. 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 doorgaat 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 neemt 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

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. 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