Get-AlarmLine¶
SYNOPSIS¶
Gets Alarms from the Event Server
SYNTAX¶
GetAlarmLines (Default)¶
Get-AlarmLine [-Conditions <Condition[]>] [-SortOrders <OrderBy[]>] [-StartAt <Int32>] [-PageSize <Int32>]
[-SinglePage] [<CommonParameters>]
Get¶
DESCRIPTION¶
Gets a list of Alarms Event Server using the AlarmCommandClient / IAlarmCommand interface.
REQUIREMENTS
- Requires VMS connection and will attempt to connect automatically
EXAMPLES¶
EXAMPLE 1¶
$c1 = New-AlarmCondition -Operator GreaterThan -Target Timestamp -Value (Get-Date).Date.AddDays(-1).ToUniversalTime()
$c2 = New-AlarmCondition -Operator LessThan -Target Timestamp -Value (Get-Date).Date.ToUniversalTime()
$order = New-AlarmOrder -Order Descending -Target Timestamp
Get-AlarmLine -Conditions $c1,$c2 -SortOrders $order | Select-Object LocalId, Timestamp, Message, SourceName, State
Create Conditions to filter the AlarmLines to only those alarms with a timestamp occurring 'Yesterday', and order the results in descending order by time.
PARAMETERS¶
-Conditions¶
Specifies the AlarmFilter used to filter alarms to those having only the desired attributes. This is also used to specify how the output should be sorted.
By default the results will be unfiltered with no guaranteed order.
Type: Condition[]
Parameter Sets: GetAlarmLines
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id¶
Specifies the Guid of a single AlarmLine entry to be retrieved.
Type: Guid
Parameter Sets: Get
Aliases:
Required: True
Position: Named
Default value: 00000000-0000-0000-0000-000000000000
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-PageSize¶
Each call to IAlarmCommand.GetAlarmLines returns a maximum number of results.
By default this module implements a page size of 100, but you may increase or decrease the page size to optimize for speed or memory consumption.
Type: Int32
Parameter Sets: GetAlarmLines
Aliases:
Required: False
Position: Named
Default value: 100
Accept pipeline input: False
Accept wildcard characters: False
-SinglePage¶
By default all alarms matching the given conditions will be returned.
Use this switch and the StartAt and PageSize parameters if you need control over pagination.
Type: SwitchParameter
Parameter Sets: GetAlarmLines
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-SortOrders¶
Specifies the AlarmFilter used to filter alarms to those having only the desired attributes. This is also used to specify how the output should be sorted.
By default the results will be unfiltered with no guaranteed order.
Type: OrderBy[]
Parameter Sets: GetAlarmLines
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-StartAt¶
Results are requested and returned in pages defined by a starting number and a PageSize
Type: Int32
Parameter Sets: GetAlarmLines
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters¶
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
INPUTS¶
System.Guid¶
Specifies the Guid of a single AlarmLine entry to be retrieved.