Partilhar via

Get-SCOMAlert

  • Referência
Módulo:
OperationsManager

Obtém alertas do 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

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 obtém 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 com 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 obtém todos os alertas que foram modificados nos últimos 30 minutos. O valor de hora devolvido de LastModified está em UTC, enquanto Get-Date é da 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 obtém 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 tarefas correspondentes continuam a ser executadas e não mostram um erro.

O terceiro comando obtém todas as classes com estado de funcionamento no respetivo nome e transmite os objetos de classe para o cmdlet Get-SCOMClassInstance com o operador de pipeline. Get-SCOMClassInstance obtém as instâncias de classe para cada objeto de classe e transmite cada um dos objetos de instância de classe para o cmdlet Get-SCOMAlert. O cmdlet Get-SCOMAlert devolve 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 com o ID

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

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

Parâmetros

-ComputerName

Especifica uma matriz de nomes de computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio completamente qualificados (FQDNs). Para especificar o computador local, escreva o nome do computador, localhost ou um ponto (.).

O serviço de Acesso a Dados do System Center tem de estar em execução no computador. Se não especificar um computador, o cmdlet utiliza o computador para a ligação do grupo de gestão atual.

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

-Credential

Especifica um objeto PSCredential para a ligação do grupo de gestão. Para obter um objeto PSCredential , utilize o cmdlet Get-Credential . Para mais informações, insira Get-Help Get-Credential.

Se especificar um computador no parâmetro ComputerName , utilize uma conta que tenha acesso a esse computador. A predefinição é o utilizador atual.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 em classes ou grupos. Pode encontrar mais detalhes aqui: 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 uma matriz de estados de funcionamento. Os valores válidos são: crítico (vermelho), aviso (amarelo), bom estado de funcionamento (verde).

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

-Id

Especifica uma matriz de GUIDs de objetos de alerta. Para obter o ID de um alerta, escreva "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 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, utilize o cmdlet Get-SCOMClassInstance . Para mais informações, insira Get-Help Get-SCOMClassInstance.

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

-LastModifiedBy

Especifica uma matriz de nomes de utilizador. O cmdlet recebe os alertas se o último utilizador que editou o alerta corresponder a um nome de utilizador que especificar.

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

-Name

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

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

-Owner

Especifica uma matriz de nomes de utilizador. O cmdlet recebe um alerta se o proprietário de um alerta corresponder a um nome de utilizador que especificar.

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

-Priority

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

  • Baixo
  • Médio
  • Alto
Type:String[]
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResolutionState

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

Quando é gerado um alerta, o estado de resolução é Novo. Os operadores podem alterar o estado de resolução para um novo alerta para Fechado ou para um estado de resolução personalizado que um administrador tenha criado para o grupo de gestão. O ID de Novo é 0 e o ID para Fechado é 255. Pode atribuir estados de resolução personalizados a qualquer valor de 2 a 254.

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

-ResolvedBy

Especifica uma matriz de nomes de utilizador. O cmdlet recebe os alertas se o utilizador que resolveu o alerta corresponder a um nome de utilizador que especificar.

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

-SCSession

Especifica uma matriz de objetos de Ligação . Para obter um objeto Ligação , utilize o cmdlet Get-SCOMManagementGroupConnection .

Um objeto de ligação representa uma ligação a um servidor de gestão. A predefinição é a ligação do grupo de gestão atual.

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

-Severity

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

  • Informações
  • Aviso
  • Crítico
Type:String[]
Position:9
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False