Start-ServiceFabricApplicationUpgrade

Módulo:

ServiceFabric

Actualiza una aplicación de Service Fabric a ApplicationTypeVersion especificada.

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

El cmdlet Start-ServiceFabricApplicationUpgrade actualiza una aplicación de Service Fabric. Antes de usar este cmdlet, debe copiar el paquete de aplicación actualizado en el almacén de imágenes y registrar el tipo de aplicación actualizado. Use Copy-ServiceFabricApplicationPackage para copiar el paquete de aplicación en el almacén de imágenes. Use el cmdlet Register-ServiceFabricApplicationType para registrar el tipo de aplicación actualizado.

Este cmdlet inicia la actualización en el clúster.

ApplicationParameters no se conservan en una actualización de la aplicación. Para conservar los parámetros actuales de la aplicación, el usuario debe obtener primero los parámetros y pasarlos a la llamada API de actualización, como se muestra en el ejemplo 1 siguiente.

Para más información sobre las actualizaciones de aplicaciones de Service Fabric, consulte la documentación conceptual.

Antes de realizar cualquier operación en un clúster de Service Fabric, establezca una conexión con el clúster mediante el cmdlet Connect-ServiceFabricCluster .

Ejemplos

Ejemplo 1: Obtención de los parámetros de la aplicación para pasar a la llamada de actualización

$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

Ejemplo 2: Actualización de una aplicación

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

El primer comando usa el cmdlet Copy-ServiceFabricApplicationPackage para copiar el paquete de aplicación actualizado en el almacén de imágenes.

El segundo comando usa el cmdlet Register-ServiceFabricApplicationType para registrar el tipo de aplicación actualizado.

El tercer comando actualiza la aplicación. El comando realiza una actualización manual no supervisada, que incluye un reinicio del servidor que hospeda la aplicación.

Parámetros

-ApplicationName

Especifica el identificador uniforme de recursos (URI) de una aplicación de Service Fabric. El cmdlet actualiza la aplicación que tiene el URI que especifique.

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

-ApplicationParameter

Especifica las invalidaciones para los parámetros de aplicación como pares nombre-valor.

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

-ApplicationTypeVersion

Especifica la versión de un tipo de aplicación de Service Fabric. El cmdlet actualiza la aplicación a la versión que especifique.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-ConsiderWarningAsError

Indica si se debe tratar un evento de mantenimiento de advertencia como un evento de error durante la evaluación de estado.

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

-DefaultServiceTypeHealthPolicy

Especifica la directiva de mantenimiento del tipo de servicio predeterminado que se usará para la actualización supervisada con el formato MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Por ejemplo, 5,10,15 indica los valores siguientes:

• MaxPercentUnhealthyPartitionsPerService = 5
• MaxPercentUnhealthyReplicasPerPartition = 10
• MaxPercentUnhealthyServices = 15

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

-FailureAction

Especifica la acción que se debe realizar si se produce un error en la actualización supervisada. Los valores permitidos para este parámetro son los siguientes:

• Reversión
• Manual

Type:	UpgradeFailureAction
Accepted values:	Invalid, Rollback, Manual
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Indica que este cmdlet omite el mensaje de advertencia y fuerza la actualización.

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

-ForceRestart

Indica que el host de servicio se reinicia incluso si la actualización es un cambio de solo configuración.

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

-HealthCheckRetryTimeoutSec

Especifica la duración, en segundos, después de la cual Service Fabric reintenta la comprobación de estado si se produce un error en la comprobación de estado anterior.

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

-HealthCheckStableDurationSec

Especifica la duración, en segundos, que Service Fabric espera para comprobar que la aplicación es estable antes de pasar al siguiente dominio de actualización o completar la actualización. Esta duración de espera evita cambios de mantenimiento no detectados justo después de realizar la comprobación de estado.

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

-HealthCheckWaitDurationSec

Especifica la duración, en segundos, que Service Fabric espera antes de realizar la comprobación de estado inicial después de finalizar la actualización en el dominio de actualización.

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

-InstanceCloseDelayDurationSec

Especifica la duración en segundos, para esperar antes de que se cierre una instancia sin estado que se vea afectada por la actualización de la aplicación, para permitir que las solicitudes activas se agoten correctamente. Esta duración de espera solo es efectiva para las instancias de esos servicios sin estado que tienen un valor distinto de cero configurado para InstanceCloseDelayDuration y reemplazará el valor preconfigurado. Consulte InstanceCloseDelayDuration (en New-ServiceFabricService) para obtener más información.

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

-MaxPercentUnhealthyDeployedApplications

Especifica el porcentaje máximo de las instancias de aplicación implementadas en los nodos del clúster que tienen un estado de mantenimiento de error antes de que el estado de mantenimiento de la aplicación para el clúster sea un error.

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

-Monitored

Indica que se supervisa el modo de actualización. Después de que el cmdlet finalice una actualización para un dominio de actualización, si el estado de mantenimiento del dominio de actualización y del clúster cumple las directivas de mantenimiento que defina, Service Fabric actualiza el siguiente dominio de actualización. Si el dominio de actualización o el clúster no cumplen las directivas de mantenimiento, la actualización produce un error y Service Fabric revierte la actualización para el dominio de actualización o vuelve al modo manual por la directiva especificada. Este es el modo recomendado para las actualizaciones de aplicaciones en un entorno de producción.

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

-ReplicaQuorumTimeoutSec

Especifica el período de tiempo de espera, en segundos, para comprobar si el conjunto de réplicas tiene cuórum. Después del período de tiempo de espera, la actualización continúa.

Este parámetro ha quedado en desuso. Especifique el parámetro UpgradeReplicaSetCheckTimeoutSec en su lugar.

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

-RestartProcess

Indica que el host de servicio se reinicia como parte de la actualización.

Este parámetro ha quedado en desuso. Especifique el parámetro ForceRestart en su lugar.

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

-ServiceTypeHealthPolicyMap

Especifica la asignación de la directiva de mantenimiento que se va a usar para distintos tipos de servicio como tabla hash en el siguiente formato: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Por ejemplo:

@{ "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

Define el orden en el que una actualización continúa a través del clúster.

Los valores posibles son:

• Invalid : indica que este criterio de ordenación no es válido. Todas las enumeraciones de Service Fabric tienen el tipo no válido.
• Default : indica que se usará el criterio de ordenación predeterminado (como se especifica en el manifiesto del clúster).
• Numeric : indica que se usará el criterio de ordenación numérico hacia delante (nombres UD ordenados como números).
• Lexicographical : indica que se usará el criterio de ordenación lexicográfico hacia delante (nombres UD ordenados como cadenas).
• ReverseNumeric : indica que se usará el criterio de ordenación numérico inverso (nombres UD ordenados como números).
• ReverseLexicographical: indica que se usará el criterio de ordenación lexicográfico inverso (nombres UD ordenados como cadenas).

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

Especifica el período de tiempo de espera, en segundos, para la operación.

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

-UnmonitoredAuto

Indica que el modo de actualización no se supervisa de forma automática. Después de que Service Fabric actualice un dominio de actualización, actualiza el siguiente dominio de actualización, independientemente del estado de mantenimiento de la aplicación. Este modo no se recomienda para entornos de producción y solo es útil durante el desarrollo de una aplicación.

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

-UnmonitoredManual

Indica que el modo de actualización no se supervisa de forma manual. Después de que Service Fabric actualice un dominio de actualización, espera a que el usuario actualice el siguiente dominio de actualización mediante el uso del cmdlet Resume-ServiceFabricApplicationUpgrade.

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

-UpgradeDomainTimeoutSec

Especifica el tiempo máximo, en segundos, que Service Fabric tarda en actualizar un único dominio de actualización. Después de este período, se produce un error en la actualización.

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

-UpgradeReplicaSetCheckTimeoutSec

Especifica el tiempo máximo que Service Fabric espera a que un servicio vuelva a configurarse en un estado seguro, si aún no está en un estado seguro, antes de que Service Fabric continúe con la actualización.

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

-UpgradeTimeoutSec

Especifica el tiempo máximo, en segundos, que Service Fabric tarda para toda la actualización. Después de este período, se produce un error en la actualización.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

None

Salidas

System.Object

Vínculos relacionados

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricApplicationUpgrade
• Resume-ServiceFabricApplicationUpgrade
• Copy-ServiceFabricApplicationPackage
• Register-ServiceFabricApplicationType