Compartir a través de


Get-SCOMAlert

Obtiene las alertas de Operations Manager.

Sintaxis

Empty (Es el valor predeterminado).

Get-SCOMAlert
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromAlertId

Get-SCOMAlert
    [-Id] <Guid[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromAlertDefault

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>]

FromCriteria

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 monitores pueden generar alertas.

Ejemplos

Ejemplo 1: Obtención de 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: Obtención de 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: Obtención de 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: Obtención de 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 de 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 tareas 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 de mediante el operador de canalización. El 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.

Propiedades del parámetro

Tipo:

String[]

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

Conjuntos de parámetros

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

-Credential

Especifica un objeto de PSCredential para la conexión del grupo de administración. Para obtener un objeto de de PSCredential, use el cmdlet get-credential de . 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.

Propiedades del parámetro

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

Conjuntos de parámetros

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

Propiedades del parámetro

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

Conjuntos de parámetros

FromCriteria
Posición:10
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-HealthState

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

Propiedades del parámetro

Tipo:

String[]

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

Conjuntos de parámetros

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

Propiedades del parámetro

Tipo:

Guid[]

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

Conjuntos de parámetros

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

Propiedades del parámetro

Tipo:

EnterpriseManagementObject[]

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

Conjuntos de parámetros

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

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

FromAlertDefault
Posición:2
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

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

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

FromAlertDefault
Posición:3
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

FromAlertDefault
Posición:4
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Priority

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

  • Bajo
  • Medio
  • Alto

Propiedades del parámetro

Tipo:

String[]

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

Conjuntos de parámetros

FromAlertDefault
Posición:8
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResolutionState

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

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

Propiedades del parámetro

Tipo:

Int32[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

FromAlertDefault
Posición:5
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

FromAlertDefault
Posición:6
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SCSession

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

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.

Propiedades del parámetro

Tipo:

Connection[]

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

Conjuntos de parámetros

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

-Severity

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

  • Información
  • Advertencia
  • Crítico

Propiedades del parámetro

Tipo:

String[]

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

Conjuntos de parámetros

FromAlertDefault
Posición:9
Mandatory: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.