Public/Get-MerakiOrganizationConfigTemplateSwitchProfilePorts.ps1
|
function Get-MerakiOrganizationConfigTemplateSwitchProfilePorts { <# .SYNOPSIS Retrieves all switch profile port configurations from a Meraki organization configuration template. .DESCRIPTION The Get-MerakiOrganizationConfigTemplateSwitchProfilePorts function retrieves all switch profile port configurations from a specified switch profile in a Meraki organization configuration template. You must provide a Meraki API key using the AuthToken parameter, the ID of the configuration template to retrieve the switch profile ports from using the configTemplateId parameter, and the ID of the switch profile to retrieve the ports from using the profileId parameter. .PARAMETER AuthToken The Meraki API key to use for authentication. .PARAMETER OrgId The ID of the Meraki organization to retrieve the switch profile port configurations from. If not specified, the function will use the ID of the first organization returned by the Get-MerakiOrganizations function. .PARAMETER configTemplateId The ID of the configuration template to retrieve the switch profile port configurations from. .PARAMETER profileId The ID of the switch profile to retrieve the port configurations from. .EXAMPLE PS C:\> Get-MerakiOrganizationConfigTemplateSwitchProfilePorts -AuthToken "12345" -configTemplateId "67890" -profileId "abcdef" Retrieves the configurations for all ports in the switch profile with ID "abcdef" in the Meraki organization configuration template with ID "67890" using the API key "12345". .NOTES For more information about the Meraki API, see https://developer.cisco.com/meraki/api/. #> [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string]$AuthToken, [Parameter(Mandatory=$false)] [string]$OrganizationID = (Get-OrgID -AuthToken $AuthToken), [Parameter(Mandatory=$true)] [string]$configTemplateId, [Parameter(Mandatory=$true)] [string]$profileId ) 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/configTemplates/$configTemplateId/switch/profiles/$profileId/ports" -Header $header -UserAgent "MerakiPowerShellModule/1.0.2 DocNougat" return $response } catch { Write-Host $_ Throw $_ } } } |