Commands › Microsoft Teams

Get-CsOnlinePSTNGateway

Microsoft Teams MicrosoftTeams Get-*

Shows the configuration of the previously defined Session Border Controller(s) (SBC(s)) that describes the settings for the peer entity. This cmdlet was introduced with Microsoft Phone System Direct Routing.

App-only limitation executed read-only 12 Nov 2026 · module v8.0.0 — The remote server returned an error: (403) Forbidden.

Quick start script

# Get-CsOnlinePSTNGateway — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Run and inspect
Get-CsOnlinePSTNGateway | Format-List

# 3. Export for evidence / drift tracking
Get-CsOnlinePSTNGateway | Export-Clixml .\CsOnlinePSTNGateway-$(Get-Date -Format yyyyMMdd).xml

Syntax — 2 parameter sets

Identity (Default)

Get-CsOnlinePSTNGateway [[-Identity] <string>] [<CommonParameters>]

Filter

Get-CsOnlinePSTNGateway [-Filter <string>] [<CommonParameters>]

Parameters (2)

Parameter	Type	Required	What it controls
-Filter	String		{{ Fill Tenant Description }}
-Identity	String		The parameter is optional for the cmdlet. If not set all SBCs paired to the tenant are listed.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.