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