Get-SCOMAlert
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 0Este 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 = $OriginalErrorActionEn 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-dac9ff76dabdEste 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 |