Public/Get-MerakiOrganizationAssuranceAlert.ps1
|
function Get-MerakiOrganizationAssuranceAlert { <# .SYNOPSIS Retrieves the details of a specific assurance alert for a specified organization. .DESCRIPTION This function allows you to retrieve the details of a specific assurance alert for a specified organization by providing the authentication token, organization ID, and the alert ID. .PARAMETER AuthToken The authentication token (API key) required to access the Meraki Dashboard API. .PARAMETER OrganizationId The ID of the organization. .PARAMETER AlertId The ID of the assurance alert. .EXAMPLE Get-MerakiOrganizationAssuranceAlert -AuthToken "your-api-token" -OrganizationId "123456" -AlertId "alertId123" This example retrieves the details of the assurance alert with ID "alertId123" for the organization with ID "123456". .NOTES For more information about the Meraki API, visit https://developer.cisco.com/meraki/api-v1/. #> [CmdletBinding()] param ( [parameter(Mandatory=$true)] [string]$AuthToken, [parameter(Mandatory=$false)] [string]$OrganizationID = (Get-OrgID -AuthToken $AuthToken), [parameter(Mandatory=$true)] [string]$AlertId ) 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 "content-type" = "application/json; charset=utf-8" } $url = "https://api.meraki.com/api/v1/organizations/$OrganizationId/assurance/alerts/$AlertId" $response = Invoke-RestMethod -Method Get -Uri $url -headers $header -UserAgent "MerakiPowerShellModule/1.1.0 DocNougat" return $response } catch { Write-Debug $_ Throw $_ } } } |