Get-CMComponentStatusMessage
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
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de