Get-AuvikAlert
SYNOPSIS
Get Auvik alert events that have been triggered by your Auvik collector(s).
SYNTAX
indexByMultiAlertGeneral (Default)
Get-AuvikAlert [-tenants <String[]>] [-filter_alertDefinitionId <String>] [-filter_severity <String>]
[-filter_status <String>] [-filter_entityId <String>] [-filter_dismissed] [-filter_dispatched]
[-filter_detectedTimeAfter <DateTime>] [-filter_detectedTimeBefore <DateTime>] [-page_first <Int64>]
[-page_after <String>] [-page_last <Int64>] [-page_before <String>] [-allPages] [<CommonParameters>]
indexBySingleAlertGeneral
Get-AuvikAlert -id <String> [<CommonParameters>]
DESCRIPTION
The Get-AuvikAlert cmdlet allows you to view the alert events that has been triggered by your Auvik collector(s).
EXAMPLES
EXAMPLE 1
Get-AuvikAlert
Pulls general information about the first 100 alerts Auvik has discovered
EXAMPLE 2
Get-AuvikAlert -id 123456789
Pulls general information for the defined alert Auvik has discovered
EXAMPLE 3
Get-AuvikAlert -page_first 1000 -allPages
Pulls general information for all alerts found by Auvik.
PARAMETERS
-id
ID of alert
Type: String
Parameter Sets: indexBySingleAlertGeneral
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-tenants
Comma delimited list of tenant IDs to request info from
Type: String[]
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-filter_alertDefinitionId
Filter by alert definition ID
Type: String
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-filter_severity
Filter by alert severity
Allowed values: “unknown”, “emergency”, “critical”, “warning”, “info”
Type: String
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-filter_status
Filter by the status of the alert
Allowed values: “created”, “resolved”, “paused”, “unpaused”
Type: String
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-filter_entityId
Filter by the related entity ID
Type: String
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-filter_dismissed
Filter by the dismissed status
As of 2023-10 this parameter does not appear to work
Type: SwitchParameter
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-filter_dispatched
Filter by dispatched status
As of 2023-10 this parameter does not appear to work
Type: SwitchParameter
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-filter_detectedTimeAfter
Filter by the time which is greater than the given timestamp
Type: DateTime
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-filter_detectedTimeBefore
Filter by the time which is less than or equal to the given timestamp
Type: DateTime
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-page_first
For paginated responses, the first N elements will be returned Used in combination with page[after]
Default Value: 100
Type: Int64
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-page_after
Cursor after which elements will be returned as a page The page size is provided by page[first]
Type: String
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-page_last
For paginated responses, the last N services will be returned Used in combination with page[before]
Default Value: 100
Type: Int64
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-page_before
Cursor before which elements will be returned as a page The page size is provided by page[last]
Type: String
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-allPages
Returns all items from an endpoint
Highly recommended to only use with filters to reduce API errors\timeouts
Type: SwitchParameter
Parameter Sets: indexByMultiAlertGeneral
Aliases:
Required: False
Position: Named
Default value: False
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
OUTPUTS
NOTES
N\A
RELATED LINKS
https://celerium.github.io/Auvik-PowerShellWrapper/site/alert/Get-AuvikAlert.html