Public/New-MerakiNetworkSwitchQOSRule.ps1

function New-MerakiNetworkSwitchQOSRule {
    <#
    .SYNOPSIS
    Creates a network switch QoS rule.
     
    .DESCRIPTION
    The New-MerakiNetworkSwitchQOSRule function allows you to create a network switch QoS rule by providing the authentication token, network ID, and a JSON formatted string of QoS configuration.
     
    .PARAMETER AuthToken
    The authentication token (API key) required to access the Meraki Dashboard API.
     
    .PARAMETER NetworkId
    The ID of the network.
     
    .PARAMETER QOSConfig
    A JSON formatted string of QoS configuration.
     
    .EXAMPLE
    $QOSConfig = [PSCustomObject]@{
        vlan = 100
        protocol = "TCP"
        srcPort = 2000
        srcPortRange = "70-80"
        dstPort = 3000
        dstPortRange = "3000-3100"
        dscp = 0
    }
 
    $QOSConfig = $QOSConfig | ConvertTo-Json -Compress
    New-MerakiNetworkSwitchQOSRule -AuthToken "your-api-token" -NetworkId "N_1234" -QOSConfig $QOSConfig
 
    This example creates a network switch QoS rule with the specified QoS configuration.
     
    .NOTES
    The function requires the "Invoke-RestMethod" cmdlet to be available.
     
    The function returns the response from the API if the creation is successful, otherwise, it displays an error message.
    #>

    
        [CmdletBinding()]
        param (
            [parameter(Mandatory=$true)]
            [string]$AuthToken,
            [parameter(Mandatory=$true)]
            [string]$NetworkId,
            [parameter(Mandatory=$true)]
            [string]$QOSConfig
        )
    
        try {
            $header = @{
                "X-Cisco-Meraki-API-Key" = $AuthToken
                "content-type" = "application/json; charset=utf-8"
            }
    
            $url = "https://api.meraki.com/api/v1/networks/$NetworkId/switch/qosRules"
    
            $body = $QOSConfig
    
            $response = Invoke-RestMethod -Method Post -Uri $url -Header $header -UserAgent "MerakiPowerShellModule/1.0.2 DocNougat" -Body $body
            return $response
        }
        catch {
            Write-Host $_
        }
    }