Public/Get-GCTelephonyEdges.ps1
|
<# .SYNOPSIS Retrieves a list of edges from Genesys Cloud. .DESCRIPTION Queries the Genesys Cloud API to retrieve a paginated list of telephony edge devices. Supports filtering by name and sorting. API Endpoint: GET /api/v2/telephony/providers/edges .PARAMETER PageSize The number of results per page. Default is 25. .PARAMETER PageNumber The page number to retrieve. Default is 1. .PARAMETER SortBy The field to sort results by. .PARAMETER SortOrder The sort order for results. Valid values are 'ascending' or 'descending'. .PARAMETER Name Filter edges by name. Supports partial matching. .EXAMPLE Get-GCTelephonyEdges Retrieves the first page of edges with default page size. .EXAMPLE Get-GCTelephonyEdges -PageSize 50 -Name 'MainOffice' Retrieves edges matching the name 'MainOffice' with 50 results per page. .NOTES Genesys Cloud API: GET /api/v2/telephony/providers/edges #> function Get-GCTelephonyEdges { [CmdletBinding()] param( [Parameter(Mandatory = $false)] [int]$PageSize = 25, [Parameter(Mandatory = $false)] [int]$PageNumber = 1, [Parameter(Mandatory = $false)] [string]$SortBy, [Parameter(Mandatory = $false)] [string]$SortOrder, [Parameter(Mandatory = $false)] [string]$Name ) $queryParams = @{ pageSize = $PageSize pageNumber = $PageNumber } if ($SortBy) { $queryParams['sortBy'] = $SortBy } if ($SortOrder) { $queryParams['sortOrder'] = $SortOrder } if ($Name) { $queryParams['name'] = $Name } $endpoint = "telephony/providers/edges" return Invoke-GCApiRequest -Endpoint $endpoint -Method GET -QueryParameters $queryParams } |