Share via

Start-ServiceFabricApplicationUpgrade

  • Referentie
Module:
ServiceFabric

Hiermee wordt een Service Fabric-toepassing bijgewerkt naar de opgegeven ApplicationTypeVersion.

Syntax

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

De cmdlet Start-ServiceFabricApplicationUpgrade werkt een Service Fabric-toepassing bij. Voordat u deze cmdlet gebruikt, moet u het bijgewerkte toepassingspakket naar het installatiekopiearchief kopiëren en het bijgewerkte toepassingstype registreren. Gebruik copy-ServiceFabricApplicationPackage om het toepassingspakket te kopiëren naar het installatiekopiearchief. Gebruik de cmdlet Register-ServiceFabricApplicationType om het bijgewerkte toepassingstype te registreren.

Met deze cmdlet wordt de upgrade gestart op het cluster.

ApplicationParameters blijven niet behouden tijdens een toepassingsupgrade. Als u de huidige toepassingsparameters wilt behouden, moet de gebruiker eerst de parameters ophalen en deze doorgeven aan de API-aanroep van de upgrade, zoals wordt weergegeven in voorbeeld 1 hieronder.

Zie de conceptuele documentatie voor meer informatie over upgrades van Service Fabric-toepassingen.

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: de toepassingsparameters ophalen die moeten worden doorgegeven aan de upgrade-aanroep

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}

foreach ($pair in $appParamCollection)
{ $applicationParameterMap.Add($pair.Name, $pair.Value); }

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

Voorbeeld 2: Een toepassing upgraden

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\PersistentToDoListServiceV2" -ImageStoreConnectionString "file:C:\ProgramData\ServiceFabric\ImageStore"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListServiceV2"
PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeVersion "2.0" -ForceRestart -UnMonitoredManual

De eerste opdracht maakt gebruik van de cmdlet Copy-ServiceFabricApplicationPackage om het bijgewerkte toepassingspakket naar het installatiekopiearchief te kopiëren.

De tweede opdracht maakt gebruik van de cmdlet Register-ServiceFabricApplicationType om het bijgewerkte toepassingstype te registreren.

Met de derde opdracht wordt de toepassing bijgewerkt. De opdracht voert een niet-bewaakte handmatige upgrade uit, waaronder het opnieuw opstarten van de server waarop de toepassing wordt gehost.

Parameters

-ApplicationName

Hiermee geeft u de URI (Uniform Resource Identifier) van een Service Fabric-toepassing op. Met de cmdlet wordt de toepassing bijgewerkt met de URI die u opgeeft.

Type:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationParameter

Hiermee geeft u de onderdrukkingen voor toepassingsparameters op als naam/waardeparen.

Type:Hashtable
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeVersion

Hiermee geeft u de versie van een Service Fabric-toepassingstype op. Met de cmdlet wordt de toepassing bijgewerkt naar de versie die u opgeeft.

Type:String
Position:1
Default value:None
Required:True
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

Hiermee wordt aangegeven of een waarschuwingsstatus gebeurtenis moet worden behandeld als een fout gebeurtenis tijdens de statusevaluatie.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultServiceTypeHealthPolicy

Hiermee geeft u het statusbeleid voor het standaardservicetype dat moet worden gebruikt voor de bewaakte upgrade in 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
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:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Geeft aan dat deze cmdlet het waarschuwingsbericht overslaat en de upgrade dwingt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceRestart

Geeft aan dat de servicehost opnieuw wordt opgestart, zelfs als de upgrade alleen een configuratiewijziging is.

Type:SwitchParameter
Position:3
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 op dat Service Fabric wacht om te controleren of de toepassing stabiel is voordat u 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 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 (in New-ServiceFabricService) voor meer informatie.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyDeployedApplications

Hiermee geeft u het maximumpercentage op van de toepassingsexemplaren die zijn geïmplementeerd op de knooppunten in het cluster die een status van de fout hebben voordat de status van de toepassing voor het cluster fout is.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Monitored

Geeft aan dat de upgrademodus wordt bewaakt. Nadat de cmdlet een upgrade voor een upgradedomein heeft voltooid, als de status van het upgradedomein en het cluster voldoen aan het statusbeleid dat u definieert, upgradet Service Fabric het volgende upgradedomein. Als het upgradedomein of cluster niet voldoet aan het statusbeleid, mislukt de upgrade en wordt de upgrade voor het upgradedomein teruggedraaid of wordt de handmatige modus teruggezet volgens het opgegeven beleid. Dit is de aanbevolen modus voor toepassingsupgrades in een productieomgeving.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReplicaQuorumTimeoutSec

Hiermee geeft u de time-outperiode in seconden op om te controleren of de replicaset quorum heeft. Na de time-outperiode gaat de upgrade verder.

Deze parameter is afgeschaft. Geef in plaats daarvan de parameter UpgradeReplicaSetCheckTimeoutSec op.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestartProcess

Geeft aan dat de servicehost opnieuw wordt opgestart als onderdeel van de upgrade.

Deze parameter is afgeschaft. Geef in plaats daarvan de parameter ForceRestart op.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceTypeHealthPolicyMap

Hiermee geeft u de kaart van het statusbeleid dat moet worden gebruikt voor verschillende servicetypen 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SortOrder

Hiermee definieert u de volgorde waarin een upgrade via het cluster wordt uitgevoerd.

Mogelijke waarden zijn:

  • Invalid - Geeft aan dat deze sorteervolgorde ongeldig is. Alle Service Fabric-inventarisaties hebben het ongeldige type.
  • Default - Geeft aan dat de standaardsorteervolgorde (zoals opgegeven in het clustermanifest) wordt gebruikt.
  • Numeric - Geeft aan dat numerieke sorteervolgorde (UD-namen gesorteerd als getallen) worden gebruikt.
  • Lexicographical - Geeft aan dat doorstuur lexicografische sorteervolgorde (UD-namen gesorteerd als tekenreeksen) worden gebruikt.
  • ReverseNumeric - Geeft aan dat omgekeerde numerieke sorteervolgorde (UD-namen gesorteerd als getallen) worden gebruikt.
  • ReverseLexicographical- Geeft aan dat omgekeerde lexicografische sorteervolgorde (UD-namen gesorteerd als tekenreeksen) worden gebruikt.
Type:UpgradeSortOrder
Accepted values:Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:5
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

-UnmonitoredAuto

Geeft aan dat de upgrademodus automatisch niet wordt bewaakt. Nadat Service Fabric een upgradedomein heeft bijgewerkt, wordt het volgende upgradedomein bijgewerkt, ongeacht de status van de toepassing. Deze modus wordt niet aanbevolen voor productie en is alleen nuttig tijdens de ontwikkeling van een toepassing.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UnmonitoredManual

Geeft aan dat de upgrademodus niet-bewaakt handmatig is. Nadat Service Fabric een upgradedomein heeft bijgewerkt, wacht het totdat u het volgende upgradedomein bijwerkt met behulp van de cmdlet Resume-ServiceFabricApplicationUpgrade .

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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

-UpgradeReplicaSetCheckTimeoutSec

Hiermee geeft u de maximale tijd op waarop 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:4
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