Get-AuvikSNMPPollerHistory

SYNOPSIS

Get Auvik historical values of SNMP Poller settings

SYNTAX

IndexByStringSNMP (Default)

Get-AuvikSNMPPollerHistory -Tenants <String[]> -FilterFromTime <DateTime> [-FilterThruTime <DateTime>]
 [-FilterCompact] [-FilterDeviceId <String>] [-FilterSNMPPollerSettingId <String[]>] [-PageFirst <Int64>]
 [-PageAfter <String>] [-PageLast <Int64>] [-PageBefore <String>] [-AllResults] [<CommonParameters>]

IndexByNumericSNMP

Get-AuvikSNMPPollerHistory -Tenants <String[]> -FilterFromTime <DateTime> [-FilterThruTime <DateTime>]
 -FilterInterval <String> [-FilterDeviceId <String>] [-FilterSNMPPollerSettingId <String[]>]
 [-PageFirst <Int64>] [-PageAfter <String>] [-PageLast <Int64>] [-PageBefore <String>] [-AllResults]
 [<CommonParameters>]

DESCRIPTION

The Get-AuvikSNMPPollerHistory cmdlet allows you to view historical values of SNMP Poller settings

There are two endpoints available in the SNMP Poller History API

Read String SNMP Poller Setting History: Provides historical values of String SNMP Poller Settings Read Numeric SNMP Poller Setting History: Provides historical values of Numeric SNMP Poller Settings

EXAMPLES

EXAMPLE 1

Get-AuvikSNMPPollerHistory -FilterFromTime 2023-10-01 -Tenants 123456789

Gets general information about the first 100 historical SNMP string poller settings

EXAMPLE 2

Get-AuvikSNMPPollerHistory -FilterFromTime 2023-10-01 -Tenants 123456789 -FilterInterval day

Gets general information about the first 100 historical SNMP numerical poller settings

EXAMPLE 3

Get-AuvikSNMPPollerHistory -FilterFromTime 2023-10-01 -Tenants 123456789 -PageFirst 1000 -AllResults

Gets general information about all historical SNMP string poller settings

PARAMETERS

-Tenants

Comma delimited list of tenant IDs to request info from

Type: String[]
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterFromTime

Timestamp from which you want to query

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterThruTime

Timestamp to which you want to query (defaults to current time)

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterCompact

Whether to show compact view of the results or not

Compact view only shows changes in value If compact view is false, dateTime range can be a maximum of 24h

Type: SwitchParameter
Parameter Sets: IndexByStringSNMP
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-FilterInterval

Statistics reporting interval

Allowed values: “minute”, “hour”, “day”

Type: String
Parameter Sets: IndexByNumericSNMP
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterDeviceId

Filter by device ID

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterSNMPPollerSettingId

Comma delimited list of SNMP poller setting IDs to request info from

Note this is internal SNMPPollerSettingId The user can get the list of IDs for a specific poller using the GET /settings/snmppoller endpoint

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PageFirst

For paginated responses, the first N elements will be returned Used in combination with page[after]

Default Value: 100

Type: Int64
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-PageAfter

Cursor after which elements will be returned as a page The page size is provided by page[first]

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PageLast

For paginated responses, the last N services will be returned Used in combination with page[before]

Default Value: 100

Type: Int64
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-PageBefore

Cursor before which elements will be returned as a page The page size is provided by page[last]

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllResults

Returns all items from an endpoint

Highly recommended to only use with filters to reduce API errors\timeouts

Type: SwitchParameter
Parameter Sets: (All)
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

https://celerium.github.io/Celerium.Auvik/site/Pollers/Get-AuvikSNMPPollerHistory.html