Compartilhar via

Get-CMComponentStatusMessage

  • Referência
Módulo:
ConfigurationManager

Obter mensagens de estado do componente no Configuration Manager.

Sintaxe

Get-CMComponentStatusMessage
   [-ComponentName <String>]
   [-ComputerName <String>]
   [-Severity <Severity>]
   [-SiteCode <String>]
   -StartTime <DateTime>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

O cmdlet Get-CMComponentStatusMessage obtém mensagens de estado do componente durante um período especificado.

O Configuration Manager indica se as operações têm êxito ou falham e incluem outras informações nas mensagens de estado do componente. Os threads ou processos enviam mensagens de estado do componente para sites do Configuration Manager, que são identificados pelos códigos do site.

Pode definir as mensagens a obter pela gravidade da mensagem, o componente que criou a mensagem, o computador que aloja esse componente ou o servidor do Configuration Manager que recebe a mensagem. Especifique sempre um período de visualização como um objeto TimeSpan .

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: obter mensagens de erro para um site

Este exemplo obtém todas as mensagens com a gravidade do erro a partir de uma hora de início específica.

Get-CMComponentStatusMessage -StartTime "2/1/2013 12:00 AM" -Severity Error

Exemplo 2: Obter mensagens de aviso para um site nas últimas 24 horas

Este exemplo recebe todos os avisos de um site específico no último dia.

Get-CMComponentStatusMessage -StartTime $(Get-Date).AddHours(-24) -Severity Warning -SiteCode "CM1"

Exemplo 3: Obter o resumo das mensagens para todos os componentes nas últimas 24 horas

Este exemplo utiliza primeiro o cmdlet Get-CMSiteComponent para obter uma lista de todos os componentes do site atual. Encaminha esta lista através de vários cmdlets para formatar a lista e, em seguida, percorre cada componente. Para cada componente, obtém as mensagens de estado de erro e aviso do último dia. Em seguida, resume o número de erros e avisos para cada componente no último dia.

Observação

Este comando pode demorar vários minutos a ser executado.

PS OPC:\> Get-CMSiteComponent | Select-Object -ExpandProperty ComponentName -Unique | Sort-Object ComponentName | ForEach-Object {
    $errs  = $(Get-CMComponentStatusMessage -ComponentName $_ -Severity Error -StartTime $(Get-Date).AddHours(-24)).Count
    $warns = $(Get-CMComponentStatusMessage -ComponentName $_ -Severity Warning -StartTime $(Get-Date).AddHours(-24)).Count
    [pscustomobject]@{
        Component  = $_
        Errors     = $errs
        Warnings   = $warns
    }
}

Component                             Errors Warnings
---------                             ------ --------
SMS_AD_SECURITY_GROUP_DISCOVERY_AGENT    742        0
SMS_WSUS_SYNC_MANAGER                     90        0
SMS_WSUS_CONFIGURATION_MANAGER             0        0
SMS_WSUS_CONTROL_MANAGER                  62        0
SMS_AD_SYSTEM_DISCOVERY_AGENT              0        0
SMS_CLIENT_HEALTH                          0        0
SMS_CLOUD_PROXYCONNECTOR                   0        0
SMS_AD_USER_DISCOVERY_AGENT                0      612
...

Parâmetros

-ComponentName

Especifica o nome de um thread ou processo. Um thread ou processo envia uma mensagem de estado do componente.

Tipo:String
Aliases:Component
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ComputerName

Defina o âmbito dos resultados das mensagens de estado e especifique o nome de um computador que aloja um componente.

Tipo:String
Aliases:MachineName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Severity

Especifica a gravidade das mensagens de estado do componente a obter.

Observação

Atualmente, este parâmetro não funciona com o All valor, mas também não devolve quaisquer valores se for omitido.

Tipo:Severity
Valores aceitos:All, Error, Warning, Information
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SiteCode

Especifica um código de site a partir do qual pode obter mensagens de estado do componente.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StartTime

Especifique uma hora para o início do período de visualização das mensagens de estado do componente.

Tipo:DateTime
Aliases:ViewingPeriod
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject[]

IResultObject