Compartir a través de

Update-ServiceFabricApplicationUpgrade

  • Referencia
Módulo:
ServiceFabric

Modifica la descripción de la actualización de una actualización de aplicación activa.

Sintaxis

Update-ServiceFabricApplicationUpgrade
      [-ApplicationName] <Uri>
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-DefaultServiceTypeHealthPolicy <String>]
      [-MaxPercentUnhealthyDeployedApplications <Byte>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-Force]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Update-ServiceFabricApplicationUpgrade modifica los parámetros de una descripción de actualización de la aplicación mientras la actualización sigue activa. Service Fabric detecta y aplica cambios según el valor de UpgradeStatusPollInterval, tal como se especifica en el manifiesto del clúster. Excepto las directivas de evaluación de estado, este cmdlet solo actualiza los parámetros que especifique. Los parámetros no especificados no se ven afectados. Debe actualizar las siguientes directivas de evaluación de estado juntas, no individualmente:

  • ConsiderWarningAsError
  • defaultServiceTypeHealthPolicy
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap

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: Actualización de un valor para una actualización de la aplicación

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

Este comando establece el valor de tiempo de espera de comprobación del conjunto de réplicas en 0 para una actualización pendiente en fabric:/MyApplication. La actualización deja solo todos los demás valores de actualización.

Parámetros

-ApplicationName

Especifica el identificador uniforme de recursos (URI) de una aplicación de Service Fabric. El cmdlet actualiza la configuración de la actualización de la aplicación que tiene el URI que especifica este parámetro.

Tipo:Uri
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ConsiderWarningAsError

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

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultServiceTypeHealthPolicy

Especifica la directiva de mantenimiento predeterminada para los tipos de servicio. La directiva de mantenimiento se usa para la actualización supervisada. La directiva sigue el formato MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices. Por ejemplo, 5,10,15 indica los siguientes valores:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Tipo:UpgradeFailureAction
Valores aceptados:Invalid, Rollback, Manual
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceRestart

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

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HealthCheckStableDurationSec

Especifica la duración, en segundos, que Service Fabric espera para comprobar que la aplicación es estable antes de continuar con el 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.

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 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 para obtener más información.

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaxPercentUnhealthyDeployedApplications

Especifica el porcentaje máximo de aplicaciones implementadas toleradas que pueden tener un estado de mantenimiento de error. Si el porcentaje de instancias de aplicación incorrectas implementadas en los nodos del clúster supera el valor que especifica este parámetro, el estado de mantenimiento de la aplicación es un error.

Tipo:Byte
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServiceTypeHealthPolicyMap

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

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

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TimeoutSec

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

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UpgradeMode

Especifica el nuevo upgradeMode de para la actualización.

Tipo:RollingUpgradeMode
Valores aceptados:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UpgradeReplicaSetCheckTimeoutSec

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

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

System.Object