Get-CMComponentStatusMessage
Configuration Manager でコンポーネントの状態メッセージを取得します。
構文
Get-CMComponentStatusMessage
[-ComponentName <String>]
[-ComputerName <String>]
[-Severity <Severity>]
[-SiteCode <String>]
-StartTime <DateTime>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
説明
Get-CMComponentStatusMessage コマンドレットは、指定した期間のコンポーネントステータスメッセージを取得します。
Configuration Manager は、操作が成功したか失敗したかを示し、コンポーネントの状態メッセージに他の情報を含めます。 スレッドまたはプロセスは、コンポーネントの状態メッセージを Configuration Manager サイトに送信します。これはサイト コードによって識別されます。
メッセージの重大度、メッセージを作成したコンポーネント、そのコンポーネントをホストするコンピューター、またはメッセージを受信する Configuration Manager サーバーによって取得するメッセージを定義できます。 表示期間は常に TimeSpan オブジェクトとして指定します。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 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 コマンドレットを使用して、現在のサイトからすべてのコンポーネントの一覧を取得します。 このリストを複数のコマンドレットでパイプ処理してリストを書式設定し、各コンポーネントをループします。 コンポーネントごとに、最後の日のエラーと警告の状態メッセージが取得されます。 次に、最後の日の各コンポーネントのエラーと警告の数を要約します。
注:
このコマンドの実行には数分かかることがあります。
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 |
Aliases: | Component |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ComputerName
ステータス メッセージの結果のスコープを設定し、コンポーネントをホストするコンピューターの名前を指定します。
型: | String |
Aliases: | MachineName |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Severity
取得するコンポーネントステータスメッセージの重大度を指定します。
注:
このパラメーターは現在、 All
値では機能しませんが、省略しても値は返されません。
型: | Severity |
指定可能な値: | All, Error, Warning, Information |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SiteCode
コンポーネントの状態メッセージを取得するサイト コードを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-StartTime
コンポーネントステータスメッセージの表示期間の開始時間を指定します。
型: | DateTime |
Aliases: | ViewingPeriod |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject[]
IResultObject