PSFive9Admin

1.0.98

Public/Prompts/Get-Five9Prompt.ps1

function Get-Five9Prompt
{
    <#
    .SYNOPSIS
     
        Function used to return prompt(s)
 
    .EXAMPLE
 
        Get-Five9Prompt
 
        # Returns list of all prompts
 
    .EXAMPLE
 
        Get-Five9Prompt -Name 'Greeting'
 
        # Returns prompt named 'Greeting'
 
    #>
    [CmdletBinding(PositionalBinding=$true)]
    param
    (
        # Name of prompt to be returned
        # If omitted, all prompts will be returned
        [Parameter(Mandatory=$false)][string]$Name
    )

    try
    {
        Test-Five9Connection -ErrorAction: Stop

        if ($PSBoundParameters.Keys -contains "Name")
        {
            Write-Verbose "$($MyInvocation.MyCommand.Name): Returning prompt '$Name'." 
            return $global:DefaultFive9AdminClient.getPrompt($Name)
        }
        else
        {
            Write-Verbose "$($MyInvocation.MyCommand.Name): Returning all prompts." 
            return $global:DefaultFive9AdminClient.getPrompts() | sort name
        }

    }
    catch
    {
        $_ | Write-PSFive9AdminError
        $_ | Write-Error
    }
}