Compartilhar via


Get-SCOMAlert

Obtém alertas do Operations Manager.

Sintaxe

Empty (Padrão)

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

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

Exemplos

Exemplo 1: Obter todos os novos alertas

PS C:\>Get-SCOMAlert -ResolutionState 0

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

Exemplo 2: Obter todos os alertas não fechados

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

Esse 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 usando um campo personalizado

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

Esse 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))'"

Esse comando obtém 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 local do sistema.

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 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 de 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 a ID

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

Esse comando obtém o alerta que tem a 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 do grupo de gerenciamento atual.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Criteria

Especifica os critérios XML que indicam 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. Mais detalhes podem ser encontrados aqui: https://learn.microsoft.com/previous-versions/system-center/developer/bb437603(v=msdn.10)?redirectedfrom=MSDN

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromCriteria
Cargo:10
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-HealthState

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromAlertDefault
Cargo:7
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Id

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

Propriedades do parâmetro

Tipo:

Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromAlertId
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Instance

Especifica uma matriz de objetos de instância de classe. Esse 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.

Propriedades do parâmetro

Tipo:

EnterpriseManagementObject[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromAlertDefault
Cargo:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

FromAlertDefault
Cargo:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

FromAlertDefault
Cargo:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

FromAlertDefault
Cargo:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Priority

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

  • Baixo
  • Média
  • Alto

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromAlertDefault
Cargo:8
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 para um novo alerta para Fechado ou para um estado de resolução personalizado que um administrador criou para o grupo de gerenciamento. A ID do New é 0 e a ID para Closed é 255. Você pode atribuir a estados de resolução personalizados qualquer valor de 2 a 254.

Propriedades do parâmetro

Tipo:

Int32[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

FromAlertDefault
Cargo:5
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

FromAlertDefault
Cargo:6
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-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 do grupo de gerenciamento atual.

Propriedades do parâmetro

Tipo:

Connection[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Severity

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

  • Informação
  • Aviso
  • Crítico

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromAlertDefault
Cargo:9
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.