Public/Campaigns/Get-Five9Campaign.ps1

function Get-Five9Campaign
{
    <#
    .SYNOPSIS
     
        Function used to get campaign(s) from Five9
 
    .NOTES
 
        Returning a single campaign also returns additional details that are NOT returned when multiple campaigns are returned.
    
    .EXAMPLE
     
        Get-Five9Campaign -Type OUTBOUND
     
        # Returns basic info on all outbound campaigns
     
    .EXAMPLE
     
        Get-Five9Campaign -Type OUTBOUND -NamePattern 'MultiMedia'
 
        # Returns basic and additional info for outbound campaign with name "MultiMedia"
    #>


    [CmdletBinding(PositionalBinding=$true)]
    param
    ( 
        <#
        Campaign Type
 
        Options are:
            • INBOUND
            • OUTBOUND
            • AUTODIAL
        #>

        [Parameter(Mandatory=$true)][ValidateSet('OUTBOUND', 'INBOUND', 'AUTODIAL')][string]$Type,

        # Optional parameter. Returns only campaigns matching a given regex string
        [Parameter(Mandatory=$false)][string]$NamePattern = '.*'
        
    )

    try
    {
        Test-Five9Connection -ErrorAction: Stop
        
        Write-Verbose "$($MyInvocation.MyCommand.Name): Returning $Type campaign(s) matching pattern '$NamePattern'" 

        $response = @($global:DefaultFive9AdminClient.getCampaigns($NamePattern, $Type, $true) | ? {$_ -ne $null})

        if ($response.Count -gt 1)
        {
            return $response | sort name | sort state -Descending

        }
        elseif ($response.Count -eq 1)
        {
            $response = $response | select -First 1

            if ($Type -eq "OUTBOUND")
            {
                $global:DefaultFive9AdminClient.getOutboundCampaign($response.name)
            }
            elseif ($Type -eq "INBOUND")
            {
                $global:DefaultFive9AdminClient.getInboundCampaign($response.name)
            }
            elseif ($Type -eq "AUTODIAL")
            {
                $global:DefaultFive9AdminClient.getAutodialCampaign($response.name)
            }
        }
    }
    catch
    {
        $_ | Write-PSFive9AdminError
        $_ | Write-Error
    }

}