Skip to main content

Get-LXCOAlerts

This cmdlet returns a list of alerts or information about a specific alert.

Note
You cannot pipe objects to this cmdlet.

Syntax​

Get-LXCOAlerts [-Connection LXCOConnection]
                -ID String 
               [CommonParameters]

Get-LXCOAlerts [-Connection LXCOConnection]
                -Excluded 
               [-Severity String[]]
               [-Message String]
               [-System String]
               [-EventId String]
               [-AlertDate String[]]
               [CommonParameters]

Get-LXCOAlerts [-Connection LXCOConnection]
               [-ActiveAlerts]
               [-Serviceability String[]]
               [-Severity String[]]
               [-Message String]
               [-System String]
               [-EventId String]
               [-AlertDate String[]]
               [-ResourceType String[]]
               [-SourceType String[]]
               [-GroupName String]
               [CommonParameters]

Parameters​

-Connection LXCOConnection
Specifies the connection to the Lenovo XClarity Orchestrator server. If no connection is specified, the result from the last Connect-LXCO cmdlet is used.
-ID String
Specifies the ID of the alert to return.
-Excluded
When specified, this cmdlet returns a list of all excluded alerts.
-Severity String[]
Specifies a comma-separated list of severities. This can be one or more of the following values.
  • Informational. Information only. No action is necessary.
  • Warning. User can decide if action is needed.
  • Critical. Action is needed immediately, and the scope is broad (perhaps an imminent outage to a critical resource will result).
-Message String
Specifies the full or partial message text. All alerts that contain the specified pattern are returned..
-System String
Specifies the full or partial resource name. All alerts that contain the specified pattern are returned.
-EventId String
Specifies the full or partial event code. All alerts that contain the specified pattern are returned.
-AlertDate String[]
Specifies the alert dates as a range, using the following format: {startDate},{endDate}. The end date is optional. If is not specified, the current date is used by default.
-ActiveAlerts String
When specified, this cmdlet returns a list of all active alerts.
-Serviceability String[]
Specifies a comma-separated list of serviceabilities. This can be one or more of the following values.
  • None. (default). Not serviceable.
  • Serviceable. Serviceable by Lenovo. If Call Home is configured, service ticket is opened with the Lenovo Support Center, and service data is collected and sent for the device, resource manager, and XClarity Orchestrator.
  • Unknown. Serviceability is not known
  • User. Serviceable by the user
-ResourceType String[]
Specifies a comma-separated list of resource types. This can be one or more of the following values.
  • Chassis
  • XClarityAdministrator
  • XClarityManagementHub2_0
  • XClarityOrchestrator
  • Server
  • Storage
  • Switch
-SourceType String[]
Specifies a comma-separated list of source types. This can be one or more of the following values.
  • Analytics
  • Device
  • Management
  • System
-GroupName String
Specifies a comma-separated list of full or partial resource-group name. All alerts that contain one or more the specified patterns are returned.
CommonParameters
This cmdlet supports the following common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable, -OutBuffer, -PipelineVariable, -OutVariable. For detailed information about each common parameter, see the Microsoft PowerShell Common Parameters webpage.

Results​

Examples​

The following example returns information about all alerts

$cred = Get-Credential
Connect-LXCO -HostUri 192.0.2.0 -Credential $cred -SkipCertificateCheck

$result = Get-LXCOAlerts

$result|Format-List

Disconnect-LXCO

The following example returns information about certain excluded alerts that were raised since January 10, 2022.

Connect-LXCO -HostUri 192.0.2.0 -Credential $cred -SkipCertificateCheck

$result = Get-LXCOAlerts -Excluded `
                         -AlertDate '1.10.2022 14:30:00' `
                         -EventId 2552 `
                         -Message 25522 `
                         -Severity Critical `
                         -System Orchestrator
$result|Format-List
  
Disconnect-LXCO

The following example returns information about a specific excluded alert.

$cred = Get-Credential
Connect-LXCO -HostUri 192.0.2.0 -Credential $cred -SkipCertificateCheck

$result = Get-LXCOAlerts -ID 0X806F06080A01FF03

$result

Disconnect-LXCO