Start-ServiceFabricApplicationUpgrade
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