Get-CMComponentStatusMessage

在 Configuration Manager 中获取组件状态消息。

语法

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

说明

Get-CMComponentStatusMessage cmdlet 获取指定时间段的组件状态消息。

Configuration Manager 指示操作是成功还是失败,并在组件状态消息中包含其他信息。 线程或进程将组件状态消息发送到 Configuration Manager 站点,这些站点由站点代码标识。

可以按消息的严重性、创建消息的组件、承载该组件的计算机或接收消息的 Configuration Manager 服务器来定义要获取的消息。 始终将查看时段指定为 TimeSpan 对象。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:获取站点的错误消息

此示例从特定开始时间获取具有错误严重性的所有消息。

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

示例 2:获取过去 24 小时内站点的警告消息

此示例获取最后一天特定站点的所有警告。

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

示例 3:获取过去 24 小时内所有组件的消息摘要

此示例首先使用 Get-CMSiteComponent cmdlet 从当前站点获取所有组件的列表。 它通过多个 cmdlet 通过管道将此列表设置为列表格式,然后循环访问每个组件。 对于每个组件,它获取最后一天的错误和警告状态消息。 然后,它汇总了最后一天每个组件的错误数和警告数。

注意

此命令可能需要几分钟才能运行。

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
...

参数

-ComponentName

指定线程或进程的名称。 线程或进程发送组件状态消息。

类型:String
别名:Component
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ComputerName

确定状态消息结果的范围,并指定承载组件的计算机的名称。

类型:String
别名:MachineName
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Severity

指定要获取的组件状态消息的严重性。

注意

此参数当前不适用于 All 值,但如果省略,也不会返回任何值。

类型:Severity
接受的值:All, Error, Warning, Information
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SiteCode

指定从中获取组件状态消息的站点代码。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-StartTime

为组件状态消息指定查看时段开始的时间。

类型:DateTime
别名:ViewingPeriod
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输入

None

输出

IResultObject[]

IResultObject