Get-CMComponentStatusMessage

Gets component status messages in Configuration Manager.

Syntax

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

Description

The Get-CMComponentStatusMessage cmdlet gets component status messages for a specified period.

Microsoft System Center Configuration Manager indicates whether operations succeed or fail and include other information in component status messages. Threads or processes send component status messages to Configuration Manager sites, which are identified by site codes.

You can define which messages to get by the severity of the message, the component that created the message, the computer that hosts that component, or the Configuration Manager server that receives the message. You must specify a viewing period, as a TimeSpan object.

Examples

Example 1: Get critical messages for a site

PS C:\> Get-CMComponentStatusMessage -ViewingPeriod "2/1/2013 12:00 AM" -Severity Warning -SiteCode "CM1"

This command gets component status messages for the specified viewing period for the Configuration Manager site that has the site code CM1. The command gets only warning messages.

Required Parameters

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

Optional Parameters

-ComponentName

Specifies the name of a thread or process. A thread or process sends a component status message.

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

Specifies the name of a computer. A computer hosts a component that sends a status message.

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

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

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

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

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

Specifies the severity of status messages. The acceptable values for this parameter are:

  • ALL
  • Error
  • Information
  • Warning
Type:Severity
Parameter Sets:All, Error, Warning, Information
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteCode

Specifies an array of a site codes for Configuration Manager sites.

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