Public/Get-MerakiOrganization.ps1
|
function Get-MerakiOrganization { <# .SYNOPSIS Retrieves information about a specific Meraki organization. .DESCRIPTION This function retrieves information about a specific Meraki organization. If no organization ID is specified, it will retrieve information about the first organization associated with the provided API key. .PARAMETER AuthToken The Meraki API authentication token. .PARAMETER OrgID The organization ID. If not specified, the first organization associated with the provided API key will be used. .EXAMPLE PS C:\> Get-MerakiOrganization -AuthToken '12345' -OrgID '54321' .EXAMPLE PS C:\> Get-MerakiOrganization -AuthToken '12345' #> param ( [parameter(Mandatory=$true)] [string]$AuthToken, [parameter(Mandatory=$false)] [string]$OrganizationID = (Get-OrgID -AuthToken $AuthToken) ) If($OrganizationID -eq "Multiple organizations found. Please specify an organization ID.") { Return "Multiple organizations found. Please specify an organization ID." } else { try { $header = @{ 'X-Cisco-Meraki-API-Key' = $AuthToken } $response = Invoke-RestMethod -Method Get -Uri "https://api.meraki.com/api/v1/organizations/$OrganizationID" -Header $header -UserAgent "MerakiPowerShellModule/1.0.2 DocNougat" return $response } catch { Write-Error $_ } } } |