Compartir a través de

Get-SCOMAlert

  • Referencia
Módulo:
OperationsManager

Obtiene alertas de Operations Manager.

Syntax

Get-SCOMAlert
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAlert
   [-Id] <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAlert
   [[-Instance] <EnterpriseManagementObject[]>]
   [[-LastModifiedBy] <String[]>]
   [[-Name] <String[]>]
   [[-Owner] <String[]>]
   [[-ResolutionState] <Int32[]>]
   [[-ResolvedBy] <String[]>]
   [[-HealthState] <String[]>]
   [[-Priority] <String[]>]
   [[-Severity] <String[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAlert
   [[-Criteria] <String>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

El cmdlet Get-SCOMAlert obtiene una o varias alertas. Una alerta es una indicación de un evento significativo que requiere su atención. Las reglas y los monitores pueden generar alertas.

Ejemplos

Ejemplo 1: Obtener todas las nuevas alertas

PS C:\>Get-SCOMAlert -ResolutionState 0

Este comando obtiene todas las alertas que tienen un estado de resolución de cero (nuevas alertas).

Ejemplo 2: Obtener todas las alertas no cerradas

PS C:\>Get-SCOMAlert -Criteria "ResolutionState != 255 and Severity != 0"

Este comando obtiene todas las alertas que no tienen un estado de resolución de 255 (alertas cerradas) y la gravedad no es Informativo.

Ejemplo 3: Obtener alertas mediante un campo personalizado

PS C:\>Get-SCOMAlert -Criteria "CustomField1 = 'TestServer'"

Este comando obtiene todas las alertas que tienen un valor de TestServer en la propiedad CustomField1 .

Ejemplo 4: Obtener alertas modificadas en los últimos 30 minutos

PS C:\>Get-SCOMAlert -Criteria "LastModified > '$((Get-Date).AddMinutes(-30))'"

Este comando obtiene todas las alertas que se han modificado en los últimos 30 minutos. El valor de hora devuelto de LastModified está en UTC, mientras que Get-Date es la hora del sistema local.

Ejemplo 5: Obtener alertas y suprimir mensajes de error

PS C:\>$OriginalErrorAction = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "SilentlyContinue"
PS C:\> Get-SCOMClass -Name "*health*" | Get-SCOMClassInstance | Get-SCOMAlert -ResolutionState (5..200)
PS C:\> $ErrorActionPreference = $OriginalErrorAction

En este ejemplo se obtienen alertas y se suprimen los mensajes de error de las instancias de clase que no coinciden con los criterios del comando.

El primer comando almacena el valor de la variable $ErrorActionPreference en la variable $OriginalErrorAction.

El segundo comando establece el valor de la variable $ErrorActionPreference en SilentlyContinue. Al establecer el valor de la variable $ErrorActionPreference en SilentlyContinue, las instancias de clase que no tienen resultados de tarea coincidentes continúan ejecutándose y no muestran un error.

El tercer comando obtiene todas las clases con estado en su nombre y pasa los objetos de clase al cmdlet Get-SCOMClassInstance mediante el operador de canalización. Get-SCOMClassInstance obtiene las instancias de clase para cada objeto de clase y pasa cada uno de los objetos de instancia de clase al cmdlet Get-SCOMAlert. El cmdlet Get-SCOMAlert devuelve las alertas que tienen un estado de resolución entre 5 y 200, ambos incluidos, para cada instancia de clase.

El cuarto comando establece el valor de la variable $ErrorActionPreference en el valor almacenado en la variable $OriginalErrorAction.

Ejemplo 6: Obtención de una alerta mediante el identificador

PS C:\>Get-SCOMAlert -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd

Este comando obtiene la alerta que tiene el identificador 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.

Parámetros

-ComputerName

Especifica una matriz de nombres de equipos. Puede usar nombres netBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).

El servicio de acceso a datos de System Center debe ejecutarse en el equipo. Si no especifica un equipo, el cmdlet usa el equipo para la conexión del grupo de administración actual.

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

-Credential

Especifica un objeto PSCredential para la conexión del grupo de administración. Para obtener un objeto PSCredential, use el cmdlet Get-Credential. Para obtener más información, escriba Get-Help Get-Credential.

Si especifica un equipo en el parámetro ComputerName , use una cuenta que tenga acceso a ese equipo. El valor predeterminado es el usuario actual.

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

-Criteria

Especifica el XML de criterios que indica cómo filtrar las alertas. Los criterios pueden filtrar por reglas o monitores concretos, o propiedades de la alerta, pero no pueden filtrar por clases o grupos. Puede encontrar más detalles aquí: https://learn.microsoft.com/previous-versions/system-center/developer/bb437603(v=msdn.10)?redirectedfrom=MSDN

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

-HealthState

Especifica una matriz de estados de mantenimiento. Los valores válidos son: crítico (rojo), advertencia (amarillo), correcto (verde).

Type:String[]
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica una matriz de GUID de objetos de alerta. Para obtener el identificador de una alerta, escriba "Get-SCOMAlert | Format-Table Name, Id".

Type:Guid[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Instance

Especifica una matriz de objetos de instancia de clase. Este parámetro también acepta objetos de grupo. Para obtener un objeto de instancia de clase, use el cmdlet Get-SCOMClassInstance . Para obtener más información, escriba Get-Help Get-SCOMClassInstance.

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LastModifiedBy

Especifica una matriz de nombres de usuario. El cmdlet obtiene las alertas si el último usuario que editó la alerta coincide con un nombre de usuario que especifique.

Type:String[]
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

Especifica una matriz de nombres de alerta. El cmdlet obtiene las alertas que coinciden con los nombres de alerta que especifique.

Type:String[]
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Owner

Especifica una matriz de nombres de usuario. El cmdlet obtiene una alerta si el propietario de una alerta coincide con un nombre de usuario que especifique.

Type:String[]
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Priority

Especifica una matriz de niveles de prioirty de alertas. Los valores válidos son:

  • Bajo
  • Media
  • Alto
Type:String[]
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResolutionState

Especifica una matriz de identificadores de estado de resolución.

Cuando se genera una alerta, el estado de resolución es nuevo. Los operadores pueden cambiar el estado de resolución de una nueva alerta a Cerrado o a un estado de resolución personalizado creado por un administrador para el grupo de administración. El identificador de Nuevo es 0 y el identificador de Cerrado es 255. Puede asignar estados de resolución personalizados a cualquier valor de 2 a 254.

Type:Int32[]
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ResolvedBy

Especifica una matriz de nombres de usuario. El cmdlet obtiene las alertas si el usuario que resolvió la alerta coincide con un nombre de usuario que especifique.

Type:String[]
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-SCSession

Especifica una matriz de objetos Connection . Para obtener un objeto Connection , use el cmdlet Get-SCOMManagementGroupConnection .

Un objeto de conexión representa una conexión a un servidor de administración. El valor predeterminado es la conexión del grupo de administración actual.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Severity

Especifica una matriz de valores de gravedad de las alertas. Los valores válidos son:

  • Information
  • Advertencia
  • Crítico
Type:String[]
Position:9
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False