Share via

Get-CMComponentStatusMessage

  • Referência
Módulo:
ConfigurationManager

Obtenha mensagens de status do componente em Configuration Manager.

Syntax

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

Description

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

Configuration Manager indica se as operações têm êxito ou falha e incluem outras informações em mensagens de status de componente. Threads ou processos enviam mensagens de status de componente para Configuration Manager sites, que são identificados por códigos de site.

Você pode definir quais mensagens obter pela gravidade da mensagem, pelo componente que criou a mensagem, pelo computador que hospeda esse componente ou pelo servidor Configuration Manager que recebe a mensagem. Especifique sempre um período de exibição como um objeto TimeSpan .

Observação

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

Exemplos

Exemplo 1: obter mensagens de erro para um site

Este exemplo obtém todas as mensagens com a gravidade do erro 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 obtém todos os avisos para um site específico no último dia.

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

Exemplo 3: obter resumo de mensagens para todos os componentes nas últimas 24 horas

Este exemplo usa primeiro o cmdlet Get-CMSiteComponent para obter uma lista de todos os componentes do site atual. Ele canaliza essa lista por meio de vários cmdlets para formatar a lista e, em seguida, faz loops por meio de cada componente. Para cada componente, ele obtém as mensagens de status de erro e aviso para o último dia. Em seguida, resume o número de erros e avisos para cada componente no último dia.

Observação

Esse comando pode levar vários minutos para 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 status de componente.

Type:String
Aliases:Component
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Escopo dos resultados das mensagens de status e especifique o nome de um computador que hospeda um componente.

Type:String
Aliases:MachineName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Severity

Especifica a gravidade das mensagens de status do componente a serem recebidas.

Observação

Atualmente, esse parâmetro não funciona com o All valor, mas também não retorna nenhum valor se omitido.

Type:Severity
Accepted values:All, Error, Warning, Information
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

Especifica um código de site do qual obter mensagens de status do componente.

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

-StartTime

Especifique um tempo para o início do período de exibição para as mensagens de status do componente.

Type:DateTime
Aliases:ViewingPeriod
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

IResultObject[]

IResultObject