共用方式為

Get-CMComponentStatusMessage

  • 參考
模組:
ConfigurationManager

在 Configuration Manager 中取得元件狀態消息。

語法

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

Description

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