Public/Get-MerakiNetworkSmDevices.ps1

function Get-MerakiNetworkSmDevices {
    <#
    .SYNOPSIS
    Retrieves the list of devices enrolled in the Systems Manager for a given network.
 
    .DESCRIPTION
    This function retrieves the list of devices enrolled in the Systems Manager for a given network.
     
    .PARAMETER AuthToken
    Required. The Meraki Dashboard API authentication token.
     
    .PARAMETER NetworkId
    Required. The network ID.
     
    .PARAMETER perPage
    Optional. The number of devices to return per page.
     
    .PARAMETER startingAfter
    Optional. A device ID to use as a starting point for the next page of results.
     
    .PARAMETER endingBefore
    Optional. A device ID to use as an ending point for the previous page of results.
     
    .PARAMETER fields
    Optional. An array of device fields to include in the response. If not specified, all fields are returned.
     
    .PARAMETER wifiMacs
    Optional. An array of WiFi MAC addresses to filter the results.
     
    .PARAMETER serials
    Optional. An array of serial numbers to filter the results.
     
    .PARAMETER ids
    Optional. An array of device IDs to filter the results.
     
    .PARAMETER scope
    Optional. An array of configuration profile IDs or tag IDs to filter the results.
     
    .EXAMPLE
    PS C:\> Get-MerakiNetworkSmDevices -AuthToken "12345" -NetworkId "L_1234" -perPage 50 -wifiMacs "00:11:22:33:44:55"
     
    Retrieves the first 50 devices with WiFi MAC address "00:11:22:33:44:55" in the network "L_1234".
     
    .EXAMPLE
    PS C:\> Get-MerakiNetworkSmDevices -AuthToken "12345" -NetworkId "L_1234" -ids "12345","67890"
     
    Retrieves the devices with IDs "12345" and "67890" in the network "L_1234".
    #>

    param (
        [parameter(Mandatory=$true)]
        [string]$AuthToken,
        [parameter(Mandatory=$true)]
        [string]$networkId,
        [parameter(Mandatory=$false)]
        [int]$perPage = $null,
        [parameter(Mandatory=$false)]
        [string]$startingAfter = $null,
        [parameter(Mandatory=$false)]
        [string]$endingBefore = $null,
        [parameter(Mandatory=$false)]
        [array]$fields = $null,
        [parameter(Mandatory=$false)]
        [array]$wifiMacs = $null,
        [parameter(Mandatory=$false)]
        [array]$serials = $null,
        [parameter(Mandatory=$false)]
        [array]$ids = $null,
        [parameter(Mandatory=$false)]
        [array]$scope= $null
    )
    try{
        $header = @{
            'X-Cisco-Meraki-API-Key' = $AuthToken
        }
    
        $queryParams = @{}
        if ($perPage) {
            $queryParams['perPage'] = $perPage
        }
        if ($startingAfter) {
            $queryParams['startingAfter'] = $startingAfter
        }
        if ($endingBefore) {
            $queryParams['endingBefore'] = $endingBefore
        }
        if ($fields) {
            $queryParams['fields[]'] = $fields
        }
        if ($wifiMacs) {
            $queryParams['wifiMacs[]'] = $wifiMacs
        }
        if ($serials) {
            $queryParams['serials[]'] = $serials
        }
        if ($ids) {
            $queryParams['ids[]'] = $ids
        }
        if ($scope) {
            $queryParams['scope[]'] = $scope
        }
    
        $queryString = New-MerakiQueryString -queryParams $queryParams
    
        $URL = "https://api.meraki.com/api/v1/networks/$networkId/sm/devices?$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 $_
    }
}