Kaffeeundcode
Script Library
PowerShell 01.06.2026

Script Workspace

Get TeamsVoiceRoutesByNumberPattern

Review the purpose, inspect the code, then test it safely in your own tenant.

261_Get-TeamsVoiceRoutesByNumberPattern.ps1

<#
.SYNOPSIS
    Teams Voice Routes By Number Pattern

.DESCRIPTION
    Ruft Teams Voice Routes By Number Pattern aus der Teams-Telefonie ab.

.NOTES
    File Name : 261_Get-TeamsVoiceRoutesByNumberPattern.ps1
    Author    : Kaffeeundcode
    Version   : 1.0
#>

param(
    [string]$OutputPath = "$PSScriptRoot/261_Get-TeamsVoiceRoutesByNumberPattern.csv",
    [int]$Top = 25,
    [switch]$SkipConnect
)

. "$PSScriptRoot/000_TeamsTelephonyHelper.ps1"

Ensure-TtCommand -Commands @("Get-CsVoiceRoute")
Initialize-TtSession -SkipConnect:$SkipConnect

$PropertyMap = ([ordered]@{
    Identity = "Identity"
    NumberPattern = "NumberPattern"
    Priority = "Priority"
    GatewayCount = "OnlinePstnGatewayList.Count"
    PstnUsageCount = "OnlinePstnUsages.Count"
    Description = "Description"
})


$Items = @(Get-CsVoiceRoute)

$Result = Select-TtProps -Items $Items -PropertyMap $PropertyMap

$Result = @($Result | Sort-Object NumberPattern)

if ($OutputPath) {
    Export-TtData -Data $Result -OutputPath $OutputPath
    Write-Host "Export abgeschlossen: $OutputPath" -ForegroundColor Green
} else {
    Write-TtPreview -Data $Result -Top $Top
}