Partilhar via

Get-SCOMAlert

  • Referência
Módulo:
OperationsManager

Obtém alertas do Operations Manager.

Sintaxe

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

O cmdlet Get-SCOMAlert recebe um ou mais alertas. Um alerta é uma indicação de um evento significativo que requer a sua atenção. Regras e monitores podem gerar alertas.

Exemplos

Exemplo 1: Obter todos os novos alertas

PS C:\>Get-SCOMAlert -ResolutionState 0

Este comando obtém todos os alertas que têm um estado de resolução de zero (novos alertas).

Exemplo 2: Obter todos os alertas não fechados

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

Este comando recebe todos os alertas que não têm um estado de resolução de 255 (alertas fechados) e a gravidade não é informativa.

Exemplo 3: Obter alertas usando um campo personalizado

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

Este comando obtém todos os alertas que têm um valor de TestServer na propriedade CustomField1.

Exemplo 4: Obter alertas modificados nos últimos 30 minutos

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

Este comando recebe todos os alertas que foram modificados nos últimos 30 minutos. O valor de tempo retornado de LastModified está em UTC, enquanto Get-Date é de Hora do sistema Local.

Exemplo 5: Obter alertas e suprimir mensagens de erro

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

Este exemplo recebe alertas e suprime mensagens de erro para as instâncias de classe que não correspondem aos critérios do comando.

O primeiro comando armazena o valor da variável $ErrorActionPreference na variável $OriginalErrorAction.

O segundo comando define o valor da variável $ErrorActionPreference como SilentlyContinue. Ao definir o valor da variável $ErrorActionPreference como SilentlyContinue, as instâncias de classe que não têm resultados de tarefa correspondentes continuam a ser executadas e não mostram um erro.

O terceiro comando obtém todas as classes com integridade em seu nome e passa os objetos de classe para o cmdlet Get-SCOMClassInstance usando o operador de pipeline. O Get-SCOMClassInstance obtém as instâncias de classe para cada objeto de classe e passa cada um dos objetos de instância de classe para o cmdlet Get-SCOMAlert. O cmdlet Get-SCOMAlert retorna os alertas que têm um estado de resolução de 5 a 200, inclusive, para cada instância de classe.

O quarto comando define o valor da variável $ErrorActionPreference de volta para o valor armazenado na variável $OriginalErrorAction.

Exemplo 6: Obter um alerta usando o ID

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

Este comando recebe o alerta que tem o ID 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.

Parâmetros

-ComputerName

Especifica uma matriz de nomes de computadores. Você pode usar nomes NetBIOS, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).

O serviço de Acesso a Dados do System Center deve estar em execução no computador. Se você não especificar um computador, o cmdlet usará o computador para a conexão atual do grupo de gerenciamento.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Especifica um objeto PSCredential para a conexão do grupo de gerenciamento. Para obter um objeto PSCredential , use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

Se você especificar um computador no parâmetro ComputerName, use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Criteria

Especifica o XML de critérios que indica como filtrar alertas. Os critérios podem filtrar regras ou monitores específicos ou propriedades do alerta, mas não podem filtrar classes ou grupos. Mais detalhes podem ser encontrados aqui: https://learn.microsoft.com/previous-versions/system-center/developer/bb437603(v=msdn.10)?redirectedfrom=MSDN

Tipo:String
Position:10
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HealthState

Especifica uma matriz de estados de integridade. Os valores válidos são: crítico (vermelho), aviso (amarelo), saudável (verde).

Tipo:String[]
Position:7
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Id

Especifica uma matriz de GUIDs de objetos de alerta. Para obter o ID de um alerta, digite "Get-SCOMAlert | Format-Table Name, Id".

Tipo:Guid[]
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Instance

Especifica uma matriz de objetos de instância de classe. Este parâmetro também aceita objetos de grupo. Para obter um objeto de instância de classe, use o cmdlet Get-SCOMClassInstance. Para obter mais informações, digite Get-Help Get-SCOMClassInstance.

Tipo:EnterpriseManagementObject[]
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LastModifiedBy

Especifica uma matriz de nomes de usuário. O cmdlet receberá os alertas se o último usuário que editou o alerta corresponder a um nome de usuário especificado.

Tipo:String[]
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-Name

Especifica uma matriz de nomes de alerta. O cmdlet obtém os alertas que correspondem aos nomes de alerta especificados.

Tipo:String[]
Position:3
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-Owner

Especifica uma matriz de nomes de usuário. O cmdlet receberá um alerta se o proprietário de um alerta corresponder a um nome de usuário especificado.

Tipo:String[]
Position:4
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-Priority

Especifica uma matriz de níveis de alerta prioirty. Os valores válidos são:

  • Baixo
  • Média
  • Alto
Tipo:String[]
Position:8
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResolutionState

Especifica uma matriz de IDs de estado de resolução.

Quando um alerta é gerado, seu estado de resolução é Novo. Os operadores podem alterar o estado de resolução de um novo alerta para Fechado ou para um estado de resolução personalizado criado por um administrador para o grupo de gerenciamento. O ID para Novo é 0 e o ID para Fechado é 255. Você pode atribuir estados de resolução personalizados a qualquer valor de 2 a 254.

Tipo:Int32[]
Position:5
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-ResolvedBy

Especifica uma matriz de nomes de usuário. O cmdlet receberá os alertas se o usuário que resolveu o alerta corresponder a um nome de usuário especificado.

Tipo:String[]
Position:6
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-SCSession

Especifica uma matriz de objetos Connection. Para obter um objeto Connection, use o cmdlet Get-SCOMManagementGroupConnection.

Um objeto de conexão representa uma conexão com um servidor de gerenciamento. O padrão é a conexão atual do grupo de gerenciamento.

Tipo:Connection[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Severity

Especifica uma matriz de valores de gravidade de alertas. Os valores válidos são:

  • Informação
  • Advertência
  • Crítica
Tipo:String[]
Position:9
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False