Partilhar via


Get-SCOMAlert

Obtém alertas do Operations Manager.

Sintaxe

Empty (Predefiniçã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 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.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 dos parâmetros

Tipo:PSCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromCriteria
Position:10
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-HealthState

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromAlertDefault
Position:7
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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".

Propriedades dos parâmetros

Tipo:

Guid[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromAlertId
Position:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

EnterpriseManagementObject[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromAlertDefault
Position:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

FromAlertDefault
Position:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

FromAlertDefault
Position:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

FromAlertDefault
Position:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Priority

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

  • Baixo
  • Média
  • Alto

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromAlertDefault
Position:8
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

Int32[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

FromAlertDefault
Position:5
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

FromAlertDefault
Position:6
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 atual do grupo de gerenciamento.

Propriedades dos parâmetros

Tipo:

Connection[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Severity

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

  • Informação
  • Advertência
  • Crítica

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromAlertDefault
Position:9
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.