Start-ServiceFabricApplicationUpgrade
Aggiorna un'applicazione di Service Fabric a ApplicationTypeVersion specificata.
Sintassi
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>]
Descrizione
Il cmdlet Start-ServiceFabricApplicationUpgrade aggiorna un'applicazione di Service Fabric. Prima di usare questo cmdlet è necessario copiare il pacchetto dell'applicazione aggiornato nell'archivio immagini e registrare il tipo di applicazione aggiornato. Usare Copy-ServiceFabricApplicationPackage per copiare il pacchetto dell'applicazione nell'archivio immagini. Usare il cmdlet Register-ServiceFabricApplicationType per registrare il tipo di applicazione aggiornato.
Questo cmdlet avvia l'aggiornamento nel cluster.
ApplicationParameters non vengono mantenuti in un aggiornamento dell'applicazione. Per mantenere i parametri dell'applicazione correnti, l'utente deve ottenere prima i parametri e passarli alla chiamata API di aggiornamento, come illustrato nell'esempio 1 seguente.
Per altre informazioni sugli aggiornamenti delle applicazioni di Service Fabric, vedere la documentazione concettuale.
Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster .
Esempio
Esempio 1: ottenere i parametri dell'applicazione da passare alla chiamata di aggiornamento
$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
Esempio 2: Aggiornare un'applicazione
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
Il primo comando usa il cmdlet Copy-ServiceFabricApplicationPackage per copiare il pacchetto dell'applicazione aggiornato nell'archivio immagini.
Il secondo comando usa il cmdlet Register-ServiceFabricApplicationType per registrare il tipo di applicazione aggiornato.
Il terzo comando aggiorna l'applicazione. Il comando esegue un aggiornamento manuale non monitorato, che include un riavvio del server che ospita l'applicazione.
Parametri
-ApplicationName
Specifica l'URI (Uniform Resource Identifier) di un'applicazione di Service Fabric. Il cmdlet aggiorna l'applicazione con l'URI specificato.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationParameter
Specifica gli overridi per i parametri dell'applicazione come coppie nome/valore.
Type: | Hashtable |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationTypeVersion
Specifica la versione di un tipo di applicazione di Service Fabric. Il cmdlet aggiorna l'applicazione alla versione specificata.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma dell'utente prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConsiderWarningAsError
Indica se considerare un evento di integrità degli avvisi come evento di errore durante la valutazione dell'integrità.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultServiceTypeHealthPolicy
Specifica i criteri di integrità per il tipo di servizio predefinito da usare per l'aggiornamento monitorato nei formati, MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. 5,10,15, ad esempio, indica i valori seguenti:
- MaxPercentUnhealthyPartitionsPerService = 5
- MaxPercentUnhealthyReplicasPerPartition = 10
- MaxPercentUnhealthyServices = 15
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailureAction
Specifica l'azione da eseguire se l'aggiornamento monitorato ha esito negativo. I valori validi per questo parametro sono:
- Rollback
- Manuale
Type: | UpgradeFailureAction |
Accepted values: | Invalid, Rollback, Manual |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Indica che questo cmdlet ignora il messaggio di avviso e forza l'aggiornamento.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceRestart
Indica che l'host del servizio viene riavviato anche se l'aggiornamento è una modifica di sola configurazione.
Type: | SwitchParameter |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HealthCheckRetryTimeoutSec
Specifica la durata, in secondi, dopo la quale Service Fabric esegue il tentativo di verifica dell'integrità se il controllo di integrità precedente ha esito negativo.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HealthCheckStableDurationSec
Specifica la durata, in secondi, che Service Fabric attende per verificare che l'applicazione sia stabile prima di passare al dominio di aggiornamento successivo o completare l'aggiornamento. Questa durata di attesa impedisce modifiche non rilevate dell'integrità subito dopo l'esecuzione del controllo integrità.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HealthCheckWaitDurationSec
Specifica la durata, in secondi, che Service Fabric attende prima di eseguire il controllo di integrità iniziale al termine dell'aggiornamento nel dominio di aggiornamento.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceCloseDelayDurationSec
Specifica la durata in secondi, per attendere prima che un'istanza senza stato interessata dall'aggiornamento dell'applicazione venga chiusa, per consentire alle richieste attive di svuotare in modo corretto. Questa durata di attesa è valida solo per le istanze di tali servizi senza stato che hanno un valore diverso da zero configurato per InstanceCloseDelayDuration e eseguirà l'override del valore preconfigurato. Per informazioni dettagliate, vedere InstanceCloseDelayDuration (in New-ServiceFabricService
).
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxPercentUnhealthyDeployedApplications
Specifica la percentuale massima delle istanze dell'applicazione distribuite nei nodi del cluster che hanno uno stato di integrità di errore prima che lo stato di integrità dell'applicazione per il cluster sia errore.
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Monitored
Indica che la modalità di aggiornamento viene monitorata. Al termine dell'aggiornamento per un dominio di aggiornamento del cmdlet, se l'integrità del dominio di aggiornamento e il cluster soddisfano i criteri di integrità definiti, Service Fabric consente di aggiornare il dominio di aggiornamento successivo. Se il dominio di aggiornamento o il cluster non riescono a soddisfare i criteri di integrità, l'aggiornamento non riesce, quindi la risorsa Service Fabric esegue il rollback dell'aggiornamento per il dominio di aggiornamento o viene ripristinata la modalità manuale per i criteri specificati. Si tratta della modalità consigliata per gli aggiornamenti dell'applicazione in un ambiente di produzione.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReplicaQuorumTimeoutSec
Specifica il periodo di timeout, in secondi, per verificare se il set di repliche ha il quorum. Dopo il periodo di timeout, l'aggiornamento procede.
Questo parametro è stato deprecato. Specificare invece il parametro UpgradeReplicaSetCheckTimeoutSec .
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RestartProcess
Indica che l'host del servizio viene riavviato come parte dell'aggiornamento.
Questo parametro è stato deprecato. Specificare invece il parametro ForceRestart .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceTypeHealthPolicyMap
Specifica la mappa dei criteri di integrità da usare per diversi tipi di servizio come tabella hash nel formato seguente: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Ad esempio:
@{ "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
Definisce l'ordine in cui un aggiornamento procede attraverso il cluster.
I valori possibili sono:
Invalid
- Indica che questo ordine di ordinamento non è valido. Tutte le enumerazioni di Service Fabric hanno il tipo non valido.Default
- Indica che verrà usato l'ordinamento predefinito (come specificato nel manifesto del cluster).Numeric
- Indica che verrà usato l'ordinamento numerico in avanti (nomi dell'utente ordinati come numeri).Lexicographical
- Indica che verrà usato l'ordine di ordinamento lexicografico (nomi dell'utente ordinati come stringhe).ReverseNumeric
- Indica che verrà usato l'ordinamento numerico inverso (nomi dell'utente ordinati come numeri).ReverseLexicographical
- Indica che verrà usato l'ordine di ordinamento lessicografico inverso (nomi dell'utente ordinati come stringhe).
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
Specifica il periodo di timeout, in secondi, per l'operazione.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnmonitoredAuto
Indica che la modalità di aggiornamento non viene monitorata automaticamente. Dopo che la risorsa Service Fabric effettua un aggiornamento su un dominio di aggiornamento, Service Fabric consente di aggiornare il dominio di aggiornamento successivo, qualunque sia lo stato di integrità dell'applicazione. Questa modalità non è consigliabile per la produzione ed è utile solo durante lo sviluppo di un'applicazione.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnmonitoredManual
Indica che la modalità di aggiornamento non viene monitorata manualmente. Dopo che la risorsa Service Fabric effettua un aggiornamento su un dominio di aggiornamento, rimane in attesa per poter aggiornare il dominio di aggiornamento successivo con il cmdletResume-ServiceFabricApplicationUpgrade.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeDomainTimeoutSec
Specifica il tempo massimo, in secondi, che Service Fabric richiede per aggiornare un singolo dominio di aggiornamento. Dopo questo periodo, l'aggiornamento ha esito negativo.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeReplicaSetCheckTimeoutSec
Specifica il tempo massimo in cui Service Fabric attende la riconfigurazione di un servizio in uno stato sicuro, se non già in uno stato sicuro, prima che Service Fabric proceda con l'aggiornamento.
Type: | UInt32 |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeTimeoutSec
Specifica il tempo massimo, in secondi, che Service Fabric richiede per l'intero aggiornamento. Dopo questo periodo, l'aggiornamento ha esito negativo.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
None
Output
System.Object