Public/New-MerakiNetworkFloorPlan.ps1
|
function New-MerakiNetworkFloorPlan { <# .SYNOPSIS Creates a floor plan for a Meraki network using the Meraki Dashboard API. .DESCRIPTION The New-MerakiNetworkFloorPlan function allows you to create a floor plan for a specified Meraki network by providing the authentication token, network ID, and a floor plan configuration string. .PARAMETER AuthToken The authentication token (API key) required to access the Meraki Dashboard API. .PARAMETER NetworkId The ID of the Meraki network for which you want to create a floor plan. .PARAMETER FloorPlanConfig A string containing the floor plan configuration. The string should be in JSON format and should include the "imageContents", "name", and at least one of the "bottomLeftCorner", "bottomRightCorner", "center", "topLeftCorner", or "topRightCorner" properties. .EXAMPLE $image = "C:\path\to\image.png" $base64 = Convert-MerakiImageToBase64 -FilePath $image $config = [PSCustomObject]@{ imageContents = $base64 name = "Floor Plan 1" bottomLeftCorner = @{ lat = 37.418095 lng = -122.098531 } topLeftCorner = @{ lat = 37.418095 lng = -122.095083 } topRightCorner = @{ lat = 37.420352 lng = -122.095083 } } | ConvertTo-Json -Compress New-MerakiNetworkFloorPlan -AuthToken "your-api-token" -NetworkId "L_123456789012345678" -FloorPlanConfig $config This example creates a floor plan for the Meraki network with ID "L_123456789012345678", setting the image contents to a base64-encoded PNG file, the name to "Floor Plan 1", and the corners of the floor plan to the specified latitude and longitude coordinates. .NOTES The function requires the "Invoke-RestMethod" cmdlet to be available. The function returns the response from the API if the floor plan 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]$FloorPlanConfig ) try { $header = @{ "X-Cisco-Meraki-API-Key" = $AuthToken "content-type" = "application/json; charset=utf-8" } $body = $FloorPlanConfig $url = "https://api.meraki.com/api/v1/networks/$NetworkId/floorPlans" $response = Invoke-RestMethod -Method Post -Uri $url -Header $header -UserAgent "MerakiPowerShellModule/1.0.2 DocNougat" -Body $body return $response } catch { Write-Debug $_ Throw $_ } } |