Public/Get-MerakiOrganizationSAML.ps1

function Get-MerakiOrganizationSAML {
    <#
    .SYNOPSIS
    Gets the SAML settings for a Meraki organization.
     
    .DESCRIPTION
    This function retrieves the SAML settings for a Meraki organization using the Meraki Dashboard API.
     
    .PARAMETER AuthToken
    The API key for the Meraki Dashboard API.
     
    .PARAMETER OrgId
    The ID of the organization containing the SAML settings. If not specified, the ID of the first organization returned by Get-MerakiOrganizations is used.
     
    .EXAMPLE
    PS C:\> Get-MerakiOrganizationSAML -AuthToken "your_api_key"
     
    Retrieves the SAML settings for the first organization returned by Get-MerakiOrganizations.
     
    .EXAMPLE
    PS C:\> Get-MerakiOrganizationSAML -AuthToken "your_api_key" -OrgId "1234"
     
    Retrieves the SAML settings for the organization with ID "1234".
     
    #>

    [CmdletBinding()]
    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/saml" -Header $header -UserAgent "MerakiPowerShellModule/1.0.2 DocNougat"
            return $response
        } catch {
            Write-Error $_
        }
    }
}