Get-CMComponentStatusMessage

  • リファレンス
モジュール:
ConfigurationManager

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 オブジェクトとして指定 します。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 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

スレッドまたはプロセスの名前を指定します。 スレッドまたはプロセスは、コンポーネントの状態メッセージを送信します。

Type:String
Aliases:Component
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ComputerName

状態メッセージの結果を範囲指定し、コンポーネントをホストするコンピューターの名前を指定します。

Type:String
Aliases:MachineName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Severity

取得するコンポーネントの状態メッセージの重大度を指定します。

注意

このパラメーターは現在、値を使用しませんが、省略した場合は値 All を返しません。

Type:Severity
Accepted values:All, Error, Warning, Information
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteCode

コンポーネントの状態メッセージを取得するサイト コードを指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StartTime

コンポーネントの状態メッセージの表示期間の開始時刻を指定します。

Type:DateTime
Aliases:ViewingPeriod
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

入力

なし

出力

IResultObject[]

IResultObject