Get-CMSiteStatusMessage
Get-CMSiteStatusMessage
Gets site system status messages.
Syntax
Parameter Set: SearchBySiteStatus
Get-CMSiteStatusMessage -ViewingPeriod <DateTime> [-ComputerName <String> ] [-Severity <Severity> {All | Error | Information | Warning} ] [-SiteCode <String> ] [ <CommonParameters>]
Detailed Description
The Get-CMSiteStatusMessage cmdlet gets status messages for one or more Microsoft System Center 2012 SP1 Configuration Manager site system components. A status message is a message that a System Center 2012 Configuration Manager component generates that contains information about the success, failure, or operation of site system components. System Center 2012 Configuration Manager stores status messages in a System Center 2012 Configuration Manager site database. You can view status messages in the Status Message Viewer.
Parameters
-ComputerName<String>
Specifies the fully qualified domain name (FQDN) of the server that hosts the site system role.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Severity<Severity>
Specifies the severity of a status message. The acceptable values for this parameter are:
-- All
-- Error
-- Information
-- Warning
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SiteCode<String>
Specifies the site code of the Configuration Manager site that hosts the site system role.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ViewingPeriod<DateTime>
Specifies the viewing period for site system status messages.
You can view only the status messages that Configuration Manager receives on or after the date and time that you specify. The default value is the current date, time, and time zone.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Get site status messages
This command gets the site status messages that System Center 2012 Configuration Manager receives on or after September 3, 2012 and that have an error severity. System Center 2012 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.
PS C:\> Get-CMSiteStatusMessage -ViewingPeriod "2012/09/03 02:16:10.000" -ComputerName "cmcen-dist02" -Severity Error -SiteCode "CM2"