Public/Get-MerakiNetworkBluetoothClients.ps1

function Get-MerakiNetworkBluetoothClients {
    <#
    .SYNOPSIS
    Get a list of Bluetooth clients associated with a network.
 
    .DESCRIPTION
    Returns a list of all Bluetooth clients seen by APs in the network. If a given client has
    been seen by multiple APs, an entry will be returned for each AP.
 
    .PARAMETER AuthToken
    The Meraki Dashboard API token.
 
    .PARAMETER NetworkId
    The network ID.
 
    .PARAMETER t0
    The beginning of the timespan for the data. The maximum lookback period is 365 days from
    the current date. The default is the past 7 days.
 
    .PARAMETER timespan
    The timespan for which the data should be fetched. The default is 1 day.
 
    .PARAMETER perPage
    The number of entries per page returned. The default is 10.
 
    .PARAMETER startingAfter
    A token used by the server to indicate where to start fetching the next page of results.
 
    .PARAMETER endingBefore
    A token used by the server to indicate where to stop fetching results.
 
    .PARAMETER includeConnectivityHistory
    Whether or not to include connectivity history in the response. The default is $true.
 
    .EXAMPLE
    PS C:\> Get-MerakiNetworkBluetoothClients -AuthToken "1234" -NetworkId "N_1234" -t0 "2022-03-01T00:00:00Z" -timespan 3600
 
    Returns a list of all Bluetooth clients seen by APs in the network between March 1st, 2022 and
    the current time with a timespan of 1 hour.
 
    .NOTES
    For more information, please see:
    https://developer.cisco.com/meraki/api-v1/#!get-network-bluetooth-clients
    #>

    [CmdletBinding()]
    param (
        [parameter(Mandatory=$true)]
        [string]$AuthToken,
        [parameter(Mandatory=$true)]
        [string]$NetworkId,
        [parameter(Mandatory=$false)]
        [string]$t0 = $null,
        [parameter(Mandatory=$false)]
        [int]$timespan = $null,
        [parameter(Mandatory=$false)]
        [int]$perPage = $null,
        [parameter(Mandatory=$false)]
        [string]$startingAfter = $null,
        [parameter(Mandatory=$false)]
        [string]$endingBefore = $null,
        [parameter(Mandatory=$true)]
        [string]$bluetoothClientId,
        [parameter(Mandatory=$false)]
        [bool]$includeConnectivityHistory = $true
        )
    try{
        $header = @{
            'X-Cisco-Meraki-API-Key' = $AuthToken
            }
            $queryParams = @{}
        
            if ($timespan) {
                $queryParams['timespan'] = $timespan
            } else {
                if ($t0) {
                    $queryParams['t0'] = $t0
                    }
                }
            if ($perPage) {
                    $queryParams['perPage'] = $perPage
                }
            if ($startingAfter) {
                    $queryParams['startingAfter'] = $startingAfter
                }
            if ($endingBefore) {
                    $queryParams['endingBefore'] = $endingBefore
                }
            if ($includeConnectivityHistory) {
                    $queryParams['includeConnectivityHistory'] = $includeConnectivityHistory
                    }
        
            $queryString = New-MerakiQueryString -queryParams $queryParams
        
            $URL = "https://api.meraki.com/api/v1/networks/$networkId/bluetoothClients?$queryString"
        
            $URI = [uri]::EscapeUriString($URL)
        
            $response = Invoke-RestMethod -Method Get -Uri $URI -Header $header -UserAgent "MerakiPowerShellModule/1.0.2 DocNougat"
            return $response    
    } catch {
        Write-Error $_
    }
}