Public/Get-MerakiNetworkWirelessClientsConnectionStats.ps1

function Get-MerakiNetworkWirelessClientsConnectionStats {
    <#
    .SYNOPSIS
    Retrieves the connection statistics for wireless clients in a Meraki network.
    .DESCRIPTION
    This function retrieves the connection statistics for wireless clients in a Meraki network using the Meraki REST API.
    .PARAMETER AuthToken
    The API token used to authenticate the request. This token can be generated in the Meraki Dashboard under Organization > Settings > Dashboard API access.
    .PARAMETER networkId
    The ID of the network containing the clients to retrieve connection statistics for.
    .PARAMETER t0
    The beginning of the time range for the data. This parameter is ignored if timespan is provided.
    .PARAMETER t1
    The end of the time range for the data. This parameter is ignored if timespan is provided.
    .PARAMETER timespan
    The timespan of the data to retrieve, in seconds. If timespan is provided, t0 and t1 are ignored.
    .PARAMETER band
    The band (either '2.4GHz' or '5GHz') to retrieve statistics for.
    .PARAMETER ssid
    The ID of the SSID to retrieve statistics for.
    .PARAMETER vlan
    The ID of the VLAN to retrieve statistics for.
    .PARAMETER apTag
    The tag of the access point to retrieve statistics for.
    .EXAMPLE
    PS C:\> Get-MerakiNetworkWirelessClientsConnectionStats -AuthToken $token -networkId $networkId -timespan 3600
    Retrieves the connection statistics for all wireless clients in the specified network for the past hour.
    .INPUTS
    None. You cannot pipe objects to this function.
    .OUTPUTS
    The function returns an array of objects containing the following properties:
    - mac: the MAC address of the client.
    - ipv4: the IPv4 address of the client.
    - ipv6: the IPv6 address of the client.
    - ssid: the SSID the client is connected to.
    - vlan: the VLAN the client is on.
    - apMac: the MAC address of the access point the client is connected to.
    - rssi: the received signal strength indicator (RSSI) of the client's connection.
    - connectionTime: the length of time the client has been connected, in seconds.
    - dnsLatency: the average DNS latency, in milliseconds.
    - phyRate: the PHY rate of the client's connection.
    - txRate: the TX rate of the client's connection.
    - rxRate: the RX rate of the client's connection.
    - usageSent: the amount of data sent by the client, in bytes.
    - usageReceived: the amount of data received by the client, in bytes.
    .NOTES
    This function requires the Meraki PowerShell module, which can be installed from the PowerShell Gallery using the following command:
    Install-Module -Name Meraki
    #>

    [CmdletBinding()]
    param (
        [parameter(Mandatory=$true)]
        [string]$AuthToken,
        [parameter(Mandatory=$true)]
        [string]$networkId,
        [parameter(Mandatory=$false)]
        [string]$t0 = $null,
        [parameter(Mandatory=$false)]
        [string]$t1 = $null,
        [parameter(Mandatory=$false)]
        [int]$timespan = $null,        
        [parameter(Mandatory=$false)]
        [string]$band = $null,
        [parameter(Mandatory=$false)]
        [int]$ssid = $null,
        [parameter(Mandatory=$false)]
        [int]$vlan = $null,
        [parameter(Mandatory=$false)]
        [string]$apTag = $null
    )
    try {
        $header = @{
            "X-Cisco-Meraki-API-Key" = $AuthToken
        }
        $queryParams = @{}
        if ($timespan) {
            $queryParams['timespan'] = $timespan
        } else {
            if ($t0) {
                $queryParams['t0'] = $t0
            }
            if ($t1) {
                $queryParams['t1'] = $t1
            }
        }
    
        if ($band) {
                $queryParams['band'] = $band
            }
    
        if ($ssid) {
                $queryParams['ssid'] = $ssid
            }
        if ($vlan) {
                $queryParams['vlan'] = $vlan
            }
        if ($apTag) {
                $queryParams['apTag'] = $apTag
            }
    
        $queryString = New-MerakiQueryString -queryParams $queryParams
    
        $URL = "https://api.meraki.com/api/v1/networks/$networkId/wireless/clients/connectionStats?$queryString"
    
        $URI = [uri]::EscapeUriString($URL)
    
        $response = Invoke-RestMethod -Method Get -Uri $URI -Header $header -UserAgent "MerakiPowerShellModule/1.0.2 DocNougat"
        return $response
    } catch {
        Write-Debug $_
        Throw $_
    }
}