Dela via

Update-ServiceFabricApplicationUpgrade

  • Referens
Modul:
ServiceFabric

Ändrar uppgraderingsbeskrivningen för en aktiv programuppgradering.

Syntax

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

Cmdleten Update-ServiceFabricApplicationUpgrade ändrar parametrarna för en programuppgraderingsbeskrivning medan uppgraderingen fortfarande är aktiv. Service Fabric identifierar och tillämpar ändringar enligt upgradeStatusPollInterval-värdet , 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
  • DefaultServiceTypeHealthPolicy
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap

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 programuppgradering

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

Det här kommandot anger timeout-värdet för replikuppsättningen till 0 för en väntande uppgradering av infrastrukturresurser:/MyApplication. Uppdateringen lämnar alla andra uppgraderingsvärden ensamma.

Parametrar

-ApplicationName

Anger URI (Uniform Resource Identifier) för ett Service Fabric-program. Cmdleten uppdaterar inställningarna för uppgraderingen för det program som har den URI som den här parametern anger.

Typ:Uri
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConsiderWarningAsError

Anger om en varningshälsorapport ska behandlas som ett fel under hälsoutvärderingen.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultServiceTypeHealthPolicy

Anger standardhälsoprincipen för tjänsttyper. Hälsoprincipen används för den övervakade uppgraderingen. Principen följer formatet MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices. Till exempel anger 5,10,15 följande värden:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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
Typ:UpgradeFailureAction
Godkända värden:Invalid, Rollback, Manual
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Anger att denna cmdlet hoppar över varningsmeddelandet och tvingar uppdateringen.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ForceRestart

Anger om tjänstvärden startas om även om uppgraderingen är en konfigurationsändring.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-HealthCheckRetryTimeoutSec

Anger varaktigheten, i sekunder, varefter Service Fabric försöker utföra hälsokontrollen igen om den tidigare hälsokontrollen misslyckas.

Typ:UInt32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-HealthCheckStableDurationSec

Anger varaktigheten i sekunder som Service Fabric väntar för att verifiera att programmet ä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.

Typ:UInt32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:UInt32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InstanceCloseDelayDurationSec

Anger varaktigheten i sekunder, att vänta innan en tillståndslös instans som påverkas av programuppgraderingen 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 .

Typ:UInt32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxPercentUnhealthyDeployedApplications

Anger den maximala procentandelen av tolererade distribuerade program som kan ha ett feltillstånd. Om procentandelen programinstanser med feltillstånd som distribueras på noderna i klustret överskrider det värde som anges i den här parametern är programmets hälsotillstånd ett fel.

Typ:Byte
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServiceTypeHealthPolicyMap

Anger kartan över hälsoprincipen som ska användas för olika tjänsttyper. Ange kartan som en hash-tabell i följande format: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Till exempel:

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

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimeoutSec

Anger tidsgränsen i sekunder för åtgärden.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:UInt32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UpgradeMode

Anger den nya UpgradeMode för uppgraderingen.

Typ:RollingUpgradeMode
Godkända värden:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UpgradeReplicaSetCheckTimeoutSec

Anger den maximala tiden i sekunder som Service Fabric väntar på att en tjänst ska konfigureras om till ett säkert tillstånd, om det inte redan är i ett säkert tillstånd, innan Service Fabric fortsätter med uppgraderingen.

Typ:UInt32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UpgradeTimeoutSec

Anger den maximala tid i sekunder som Service Fabric tar för hela uppgraderingen. Efter den här perioden misslyckas uppgraderingen.

Typ:UInt32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

System.Object