Get-ServiceFabricApplicationHealth

Obtiene el estado de una aplicación de Service Fabric.

Syntax

Get-ServiceFabricApplicationHealth
   [-ApplicationName] <Uri>
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyDeployedApplications <Byte>]
   [-MaxPercentUnhealthyServices <Byte>]
   [-MaxPercentUnhealthyPartitionsPerService <Byte>]
   [-MaxPercentUnhealthyReplicasPerPartition <Byte>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-ServicesHealthStateFilter <Int64>]
   [-ServicesFilter <HealthStateFilter>]
   [-DeployedApplicationsHealthStateFilter <Int64>]
   [-DeployedApplicationsFilter <HealthStateFilter>]
   [-ExcludeHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

El cmdlet Get-ServiceFabricApplicationHealth obtiene el estado de mantenimiento de una aplicación de Service Fabric. Service Fabric notifica los siguientes estados de mantenimiento:

  • Aceptar. La entidad cumple las directrices de mantenimiento.
  • Error. La entidad no cumple las directrices de mantenimiento.
  • Advertencia. La entidad cumple las directrices de mantenimiento, pero ha experimentado algún problema.

Si la entidad no se encuentra en el almacén de estado, este cmdlet devuelve un error.

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 del estado de una aplicación

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist

Este comando consulta el estado de la aplicación con nombre.

Ejemplo 2: Obtener el estado de una aplicación mediante una directiva de mantenimiento personalizada y devolver filtros

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ConsiderWarningAsError $True -EventsFilter Error -ServicesFilter 'Error,Warning' -DeployedApplicationsFilter 'Warning,Error'

Este comando consulta el estado de la aplicación con nombre. El comando especifica valores para la directiva de mantenimiento y usa filtros para devolver solo eventos error y elementos secundarios con estados de estado de error o advertencia.

Ejemplo 3: Obtención del estado de una aplicación y exclusión de las estadísticas de mantenimiento

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ExcludeHealthStatistics

Este comando consulta el estado de la aplicación con nombre. El estado de la aplicación devuelto no incluye las estadísticas de mantenimiento.

Parámetros

-ApplicationName

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

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

-ConsiderWarningAsError

Indica si este cmdlet considera un informe de estado de advertencia como un error durante la evaluación de estado.

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

-DeployedApplicationsFilter

Especifica el filtro para los elementos secundarios DeployedApplicationHealthState en función del estado de mantenimiento. El valor se obtiene de miembros o operaciones bit a bit en miembros de HealthStateFilter. Solo se devuelven elementos secundarios que coincidan con el filtro. Todos los elementos secundarios se usan para evaluar el estado de mantenimiento agregado de la aplicación. Si no se especifica, se devuelven todas las entradas.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployedApplicationsHealthStateFilter

Este parámetro está en desuso. Especifique el parámetro DeployedApplicationsFilter en su lugar.

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

-EventsFilter

Especifica el filtro para la colección de objetos HealthEvent notificados en la aplicación según el estado de mantenimiento. El valor se puede obtener de miembros o operaciones bit a bit en miembros de HealthStateFilter. Se devuelven únicamente los eventos que coinciden con el filtro. Todos los eventos se usan para evaluar el estado de mantenimiento agregado de la aplicación. Si no se especifica, se devuelven todas las entradas.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventsHealthStateFilter

Este parámetro está en desuso. Especifique el parámetro EventsFilter en su lugar.

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

-ExcludeHealthStatistics

Indica si las estadísticas de mantenimiento deben incluirse en el resultado de la consulta. Si se especifica, las estadísticas de mantenimiento no se devuelven como parte del resultado de la consulta. De lo contrario, el resultado de la consulta incluye las estadísticas de estado de la aplicación, que contienen información sobre cuántos servicios, particiones y réplicas de esta aplicación se encuentran en los estados Ok, Warning y Error.

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

-MaxPercentUnhealthyDeployedApplications

Especifica el porcentaje máximo tolerado de instancias de aplicación incorrecta implementadas en los nodos del clúster. Si hay más aplicaciones implementadas con un error de estado de mantenimiento que tolerado, el estado de mantenimiento de la aplicación es un error. Si no especifica este parámetro, la evaluación de estado usa el valor proporcionado en el manifiesto de aplicación.

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

-MaxPercentUnhealthyPartitionsPerService

Especifica el porcentaje máximo tolerado de particiones de servicio incorrectas. Si hay más particiones con un error de estado de mantenimiento que tolerado, el estado de mantenimiento de los servicios es un error. Si no especifica este parámetro, la evaluación de estado usa el valor proporcionado en el manifiesto de aplicación.

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

-MaxPercentUnhealthyReplicasPerPartition

Especifica el porcentaje máximo tolerado de réplicas de partición incorrectas. Si hay más réplicas con un error de estado de mantenimiento que tolerado, el estado de mantenimiento de la partición es un error. Si no especifica este parámetro, la evaluación de estado usa el valor proporcionado en el manifiesto de aplicación.

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

-MaxPercentUnhealthyServices

Especifica el porcentaje máximo tolerado de servicios incorrectos en una aplicación. Si hay más servicios con un error de estado de mantenimiento de lo tolerado, el estado de mantenimiento de la aplicación es un error. Si no especifica este parámetro, la evaluación de estado usa el valor proporcionado en el manifiesto de aplicación.

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

-ServicesFilter

Especifica el filtro para los elementos secundarios serviceHealthState en función del estado de mantenimiento. El valor se puede obtener de miembros o operaciones bit a bit en miembros de HealthStateFilter. Solo se devuelven elementos secundarios que coincidan con el filtro. Todos los elementos secundarios se usan para evaluar el estado de mantenimiento agregado de la aplicación. Si no se especifica, se devuelven todas las entradas.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicesHealthStateFilter

Este parámetro está en desuso. Especifique el parámetro ServicesFilter en su lugar.

Type:Int64
Position:Named
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

Entradas

System.Uri

Salidas

System.Object