Get-CMSiteStatusMessage

Gets site system status messages.

Syntax

Get-CMSiteStatusMessage
   [-ComputerName <String[]>]
   [-Severity <Severity[]>]
   [-SiteCode <String[]>]
   [-StartDateTime <DateTime>]
   [-MessageId <Int32[]>]
   [-Module <String[]>]
   [-Component <String[]>]
   [-FilterHashtable <Hashtable>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

The Get-CMSiteStatusMessage cmdlet gets status messages for one or more Microsoft System Center Configuration Manager site system components. A status message is a message that a System Center Configuration Manager component generates that contains information about the success, failure, or operation of site system components. System Center Configuration Manager stores status messages in a System Center Configuration Manager site database. You can view status messages in the Status Message Viewer.

Examples

Example 1: Get site status messages

PS C:\> Get-CMSiteStatusMessage -ViewingPeriod "2012/09/03 02:16:10.000" -ComputerName "cmcen-dist02" -Severity Error -SiteCode "CM2"

This command gets the site status messages that System Center Configuration Manager receives on or after September 3, 2012 and that have an error severity. System Center Configuration Manager gets the status messages from the Configuration Manager site that has the site code CM2 on the computer named cmcen-dist02.tsqa.contoso.com.

Optional Parameters

-Component
Type:String[]
Aliases:ComponentName, Components, ComponentNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ComputerName

Specifies the fully qualified domain name (FQDN) of the server that hosts the site system role.

Type:String[]
Aliases:ComputerNames
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
-FilterHashtable
Type:Hashtable
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
-MessageId
Type:Int32[]
Aliases:MessageIds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Module
Type:String[]
Aliases:ModuleName, Modules, ModuleNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Severity

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

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

Specifies the site code of the Configuration Manager site that hosts the site system role.

Type:String[]
Aliases:SiteCodes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StartDateTime
Type:DateTime
Aliases:ViewingPeriod
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False