Start-ServiceFabricApplicationUpgrade

Módulo:
ServiceFabric Module

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

Sintaxis

UnmonitoredAuto (valor predeterminado) 

Start-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ApplicationTypeVersion] <String>
    [[-ApplicationParameter] <Hashtable>]
    [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
    [[-SortOrder] <UpgradeSortOrder>]
    [-ForceRestart]
    [-ReplicaQuorumTimeoutSec <UInt32>]
    [-RestartProcess]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-UnmonitoredAuto]
    [-Force]
    [-TimeoutSec <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UnmonitoredManual 

Start-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ApplicationTypeVersion] <String>
    [[-ApplicationParameter] <Hashtable>]
    [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
    [[-SortOrder] <UpgradeSortOrder>]
    [-ForceRestart]
    [-ReplicaQuorumTimeoutSec <UInt32>]
    [-RestartProcess]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-UnmonitoredManual]
    [-Force]
    [-TimeoutSec <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Monitored 

Start-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ApplicationTypeVersion] <String>
    [[-ApplicationParameter] <Hashtable>]
    [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
    [[-SortOrder] <UpgradeSortOrder>]
    -FailureAction <UpgradeFailureAction>
    [-ForceRestart]
    [-ReplicaQuorumTimeoutSec <UInt32>]
    [-RestartProcess]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-Monitored]
    [-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 a la API de actualización, como se muestra en el ejemplo 1 a continuación.

Para obtener 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 que se van a 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.

Propiedades de parámetro

Tipo:Uri
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ApplicationParameter

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

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:2
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ConsiderWarningAsError

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

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Monitored
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 siguientes valores:

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Monitored
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FailureAction

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

  • Reversión
  • Manual de instrucciones

Propiedades de parámetro

Tipo:UpgradeFailureAction
Valor predeterminado:None
Valores aceptados:Invalid, Rollback, Manual
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Monitored
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Force

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ForceRestart

Indica que el host de servicio se reinicia aunque la actualización sea un cambio de solo configuración.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:3
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-HealthCheckRetryTimeoutSec

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

Propiedades de parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Monitored
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 no detectados de mantenimiento justo después de realizar la comprobación de estado.

Propiedades de parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Monitored
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Monitored
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-InstanceCloseDelayDurationSec

Especifica la duración en segundos, para esperar antes de que se cierre una instancia sin estado que se ve afectada por la actualización de la aplicación, para permitir que las solicitudes activas se drenen 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 anulará el valor preconfigurado. Consulte InstanceCloseDelayDuration (en New-ServiceFabricService) para obtener más información.

Propiedades de parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 se produzca un error en el estado de mantenimiento de la aplicación para el clúster.

Propiedades de parámetro

Tipo:Byte
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Monitored
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Monitored
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ReplicaQuorumTimeoutSec

Especifica el período de tiempo de espera, en segundos, para comprobar si el conjunto de réplicas tiene quó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.

Propiedades de parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServiceTypeHealthPolicyMap

Especifica el mapa de la directiva de mantenimiento que se usará para diferentes tipos de servicio como tabla hash en el formato siguiente: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Por ejemplo:

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

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Monitored
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 utilizará el criterio de ordenación numérico hacia adelante (nombres UD ordenados como números).
  • Lexicographical - Indica que se utilizará el criterio de ordenación lexicográfico hacia adelante (nombres UD ordenados como cadenas).
  • ReverseNumeric - Indica que se utilizará el orden numérico inverso (nombres UD ordenados como números).
  • ReverseLexicographical- Indica que se utilizará el criterio de ordenación lexicográfico inverso (nombres UD ordenados como cadenas).

Propiedades de parámetro

Tipo:UpgradeSortOrder
Valor predeterminado:None
Valores aceptados:Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:5
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TimeoutSec

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

Propiedades de parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UnmonitoredAuto
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UnmonitoredManual
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Monitored
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:4
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UpgradeTimeoutSec

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

Propiedades de parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Monitored
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

System.Object