Get-PhoneCall.ps1

function Get-PhoneCall
{
    <#
    .Synopsis
        Gets information about phone calls
    .Description
        Gets information about phone calls sent to or from any Twilio Number
    .Example
        Get-PhoneCall
    .Link
        Send-PhoneCall
    .Link
        Get-Web
    .Link
        http://twilio.com/

    #>
    [OutputType([PSObject])]
    param(
    # The call identifier   
    [Parameter(ValueFromPipelineByPropertyName=$true)]
    [Alias('Sid')] 
    [string]
    $CallSid, 

    # The Twilio credential 
    [Management.Automation.PSCredential]
    $Credential,
    
    
    # The status of the phone call
    [ValidateSet("queued", "ringing", "in-progress", "completed", "failed", "busy", "no-answer")]    
    [string]$Status,
    
    # The number the phone call was sent to
    [string]$To,
    
    # The number the phone call came from
    [string]$From,
        
    # Twilio connection settings
    [Parameter(ValueFromPipelineByPropertyName=$true)]       
    [string[]]
    $Setting = @("TwilioAccountKey", "TwilioAccountSecret"),

    # If set, will include the recording information with the call
    [Switch]$IncludeRecording,
    
    # If set, will include transcription information with the call
    [Switch]$IncludeTranscript

    )
    
    process {
        #region Resolve the Twilio Credential
        if (-not $Credential -and $Setting) {
            if ($setting.Count -eq 1) {

                $userName = Get-WebConfigurationSetting -Setting "${Setting}_UserName"
                $password = Get-WebConfigurationSetting -Setting "${Setting}_Password"
            } elseif ($setting.Count -eq 2)  {
                $userName = Get-secureSetting -Name $Setting[0] -ValueOnly
                $password= Get-secureSetting -Name $Setting[1] -ValueOnly
            }

            if ($userName -and $password) {                
                $password = ConvertTo-SecureString -AsPlainText -Force $password
                $credential  = New-Object Management.Automation.PSCredential $username, $password 
            } elseif ((Get-SecureSetting -Name "$Setting" -ValueOnly | Select-Object -First 1)) {
                $credential = (Get-SecureSetting -Name "$Setting" -ValueOnly | Select-Object -First 1)
            }
            
            
        }

        if (-not $Credential) {
            Write-Error "No Twilio Credential provided.  Use -Credential or Add-SecureSetting TwilioAccountDefault -Credential (Get-Credential) first"               
            return
        }
        #endregion Resolve the Twilio Credential

        #region Define the default web parameters
        $getWebParams = @{
            WebCredential=$Credential
            Url="https://api.twilio.com/2010-04-01/Accounts/$($Credential.GetNetworkCredential().Username.Trim())/Calls/?"           
            AsXml =$true                        
            UseWebRequest = $true
        }
        
        if ($psBoundParameters.Status) {
            $getWebParams.Url += "&Status=$status"
        }
        
        if ($psBoundParameters.To) {
            $getWebParams.Url += "&To=$to"
        }
        
        if ($psBoundParameters.From) {
            $getWebParams.Url += "&From=$from"
        }                
        
        if ($callSid) {
            $getWebParams.Url = 
                "https://api.twilio.com/2010-04-01/Accounts/$($Credential.GetNetworkCredential().Username.Trim())/Calls/$CallSid"           
        }         
        #endregion Define the default web parameters
        
        do {
            # Get the response from Twilio
            $twiResponse = Get-Web @getwebParams |            
                Select-Object -ExpandProperty TwilioResponse 
            
            #region Extract out call information
            $twiResponse | 
                Select-Object -ExpandProperty Calls | 
                Select-Object -ExpandProperty Call |
                ForEach-Object {
                    $item = $_
                    $_.pstypenames.clear()
                    $_.pstypenames.add('Twilio.PhoneCall')
                    if ($includeRecording) {
                        $recording = 
                            Get-TwilioRecording -CallSid $_.CallSid -Credential $credential -Asmp3 -errorAction SilentlyContinue
                        $_ | 
                            Add-Member NoteProperty Recording $recording -Force                     
                    }
                
                    if ($includeTranscript) {                    
                        $recording= 
                            Get-TwilioRecording -CallSid $item.Sid -Credential $credential -errorAction SilentlyContinue
                        if ($recording) {
                            Get-TwilioTranscription -RecordingSid $recording.Sid -Credential $credential 
                        }                                            
                    }
                    $_                
                }
            #endregion Extract out call information

            if ($twiResponse.Calls.NextPageUri) {
                # If there's a next page, slightly change the URL
                    $getWebParams.Url="https://api.twilio.com" + $twiResponse.Calls.NextPageUri
                    

            }
        } while ($twiResponse.Calls.NextPageUri)        
    }       
}