Compartir a través de

Get-CMComponentStatusMessage

  • Referencia
Módulo:
ConfigurationManager

Obtener mensajes de estado de componente en Configuration Manager.

Sintaxis

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

Description

El cmdlet Get-CMComponentStatusMessage obtiene mensajes de estado de componente durante un período especificado.

Configuration Manager indica si las operaciones se realizan correctamente o no e incluyen otra información en los mensajes de estado del componente. Los subprocesos o procesos envían mensajes de estado de componente a sitios de Configuration Manager, que se identifican mediante códigos de sitio.

Puede definir qué mensajes se obtienen por la gravedad del mensaje, el componente que creó el mensaje, el equipo que hospeda ese componente o el servidor de Configuration Manager que recibe el mensaje. Especifique siempre un período de visualización como un objeto TimeSpan .

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Obtención de mensajes de error para un sitio

En este ejemplo se obtienen todos los mensajes con la gravedad del error de una hora de inicio específica.

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

Ejemplo 2: Obtención de mensajes de advertencia para un sitio en las últimas 24 horas

En este ejemplo se obtienen todas las advertencias de un sitio específico en el último día.

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

Ejemplo 3: Obtención de un resumen de los mensajes de todos los componentes en las últimas 24 horas

En este ejemplo se usa primero el cmdlet Get-CMSiteComponent para obtener una lista de todos los componentes del sitio actual. Canaliza esta lista a través de varios cmdlets para dar formato a la lista y, a continuación, recorre en bucle cada componente. Para cada componente, obtiene los mensajes de estado de error y advertencia del último día. A continuación, resume el número de errores y advertencias de cada componente en el último día.

Nota:

Este comando puede tardar varios minutos en ejecutarse.

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 el nombre de un subproceso o proceso. Un subproceso o proceso envía un mensaje de estado de componente.

Tipo:String
Alias:Component
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ComputerName

Establezca el ámbito de los resultados de los mensajes de estado y especifique el nombre de un equipo que hospeda un componente.

Tipo:String
Alias:MachineName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Severity

Especifica la gravedad de los mensajes de estado de componente que se van a obtener.

Nota:

Este parámetro no funciona actualmente con el All valor, pero tampoco devuelve ningún valor si se omite.

Tipo:Severity
Valores aceptados:All, Error, Warning, Information
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SiteCode

Especifica un código de sitio desde el que se van a obtener mensajes de estado del componente.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-StartTime

Especifique una hora para el inicio del período de visualización de los mensajes de estado del componente.

Tipo:DateTime
Alias:ViewingPeriod
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

IResultObject[]

IResultObject