Get-AuvikNetwork

SYNOPSIS

Get Auvik networks and other related information

SYNTAX

indexByMultiNetworkGeneral (Default)

Get-AuvikNetwork [-tenants <String[]>] [-filter_networkType <String>] [-filter_scanStatus <String>]
 [-filter_devices <String[]>] [-filter_modifiedAfter <DateTime>] [-include <String>]
 [-fields_networkDetail <String>] [-page_first <Int64>] [-page_after <String>] [-page_last <Int64>]
 [-page_before <String>] [-allPages] [<CommonParameters>]

indexBySingleNetworkDetail

Get-AuvikNetwork -id <String> [-details] [<CommonParameters>]

indexBySingleNetworkGeneral

Get-AuvikNetwork -id <String> [-include <String>] [-fields_networkDetail <String>] [-detailsGeneral]
 [<CommonParameters>]

indexByMultiNetworkDetail

Get-AuvikNetwork [-tenants <String[]>] [-filter_networkType <String>] [-filter_scanStatus <String>]
 [-filter_devices <String[]>] [-filter_modifiedAfter <DateTime>] [-filter_scope <String>] [-page_first <Int64>]
 [-page_after <String>] [-page_last <Int64>] [-page_before <String>] [-allPages] [<CommonParameters>]

DESCRIPTION

The Get-AuvikNetwork cmdlet allows you to view an inventory of networks and other related information discovered by Auvik.

Use the [ -details & -detailsGeneral ] parameters when wanting to target specific information. See Get-Help Get-AuvikNetwork -Full for more information on associated parameters

EXAMPLES

EXAMPLE 1

Get-AuvikNetwork

Pulls general information about the first 100 networks Auvik has discovered

EXAMPLE 2

Get-AuvikNetwork -id 123456789 -detailsGeneral

Pulls general information for the defined network Auvik has discovered

EXAMPLE 3

Get-AuvikNetwork -details

Pulls detailed information about the first 100 networks Auvik has discovered

EXAMPLE 4

Get-AuvikNetwork -id 123456789 -details

Pulls details information for the defined network Auvik has discovered

EXAMPLE 5

Get-AuvikNetwork -page_first 1000 -allPages

Pulls general information for all networks found by Auvik.

PARAMETERS

-id

ID of network

Type: String
Parameter Sets: indexBySingleNetworkDetail, indexBySingleNetworkGeneral
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: indexByMultiNetworkGeneral, indexByMultiNetworkDetail
Aliases:

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

-filter_networkType

Filter by network type

Allowed values: “routed”, “vlan”, “wifi”, “loopback”, “network”, “layer2”, “internet”

Type: String
Parameter Sets: indexByMultiNetworkGeneral, indexByMultiNetworkDetail
Aliases:

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

-filter_scanStatus

Filter by the network’s scan status

Allowed values: “true”, “false”, “notAllowed”, “unknown”

Type: String
Parameter Sets: indexByMultiNetworkGeneral, indexByMultiNetworkDetail
Aliases:

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

-filter_devices

Filter by IDs of devices on this network

Filter by multiple values by providing a comma delimited list

Type: String[]
Parameter Sets: indexByMultiNetworkGeneral, indexByMultiNetworkDetail
Aliases:

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

-filter_modifiedAfter

Filter by date and time, only returning entities modified after provided value

Type: DateTime
Parameter Sets: indexByMultiNetworkGeneral, indexByMultiNetworkDetail
Aliases:

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

-filter_scope

Filter by the network’s scope

Allowed values: “private”, “public”

Type: String
Parameter Sets: indexByMultiNetworkDetail
Aliases:

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

-include

Use to include the full resource objects of the list device relationships

Example: include=deviceDetail

Type: String
Parameter Sets: indexByMultiNetworkGeneral, indexBySingleNetworkGeneral
Aliases:

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

-fields_networkDetail

Use to limit the attributes that will be returned in the included detail object to only what is specified by this query parameter.

Allowed values: “scope”, “primaryCollector”, “secondaryCollectors”, “collectorSelection”, “excludedIpAddresses”

Requires include=networkDetail

Type: String
Parameter Sets: indexByMultiNetworkGeneral, indexBySingleNetworkGeneral
Aliases:

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

-details

Target the details endpoint

/inventory/network/info & /inventory/network/info/{id}

Type: SwitchParameter
Parameter Sets: indexBySingleNetworkDetail
Aliases:

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

-detailsGeneral

Target the general details endpoint

/inventory/network/detail & /inventory/network/detail/{id}

Type: SwitchParameter
Parameter Sets: indexBySingleNetworkGeneral
Aliases:

Required: False
Position: Named
Default value: False
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: indexByMultiNetworkGeneral, indexByMultiNetworkDetail
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: indexByMultiNetworkGeneral, indexByMultiNetworkDetail
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: indexByMultiNetworkGeneral, indexByMultiNetworkDetail
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: indexByMultiNetworkGeneral, indexByMultiNetworkDetail
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: indexByMultiNetworkGeneral, indexByMultiNetworkDetail
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/Auvik-PowerShellWrapper/site/inventory/Get-AuvikNetwork.html