Get-CMSiteStatusMessage

Gets site system status messages.

Syntax

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

Description

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

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Get site status messages

PS XYZ:\> 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 Configuration Manager receives on or after September 3, 2012 and that have an error severity. 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.

Parameters

-Component

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

-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
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-FilterHashtable

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-MessageId

Type:Int32[]
Aliases:MessageIds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Module

Type:String[]
Aliases:ModuleName, Modules, ModuleNames
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-PassThru

Add this parameter to return an object that represents the item with which you're working. By default, this cmdlet may not generate any output.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Accepted values:All, Error, Information, Warning
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartDateTime

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

Inputs

None

Outputs

IResultObject[]

IResultObject