Public/Get-GCTelephonyPhone.ps1

<#
.SYNOPSIS
    Retrieves a single phone from Genesys Cloud.

.DESCRIPTION
    Queries the Genesys Cloud API to retrieve a specific telephony phone device by its ID.
    API Endpoint: GET /api/v2/telephony/providers/edges/phones/{phoneId}

.PARAMETER PhoneId
    The unique identifier of the phone to retrieve.

.EXAMPLE
    Get-GCTelephonyPhone -PhoneId 'phone-abc123'
    Retrieves the phone with the specified ID.

.NOTES
    Genesys Cloud API: GET /api/v2/telephony/providers/edges/phones/{phoneId}
#>

function Get-GCTelephonyPhone {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true)]
        [string]$PhoneId
    )

    $endpoint = "telephony/providers/edges/phones/$PhoneId"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method GET
}