Commands › Microsoft Teams

Get-CsTenantTrustedIPAddress

Microsoft Teams MicrosoftTeams Get-*

Returns information about the external trusted IPs in the tenant. Trusted IP address from user's endpoint will be checked to determine which internal subnet the user's endpoint is located.

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-CsTenantTrustedIPAddress — 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-CsTenantTrustedIPAddress | Format-List

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

Syntax — 2 parameter sets

Identity (Default)

Get-CsTenantTrustedIPAddress [-Tenant <System.Guid>] [[-Identity] <XdsGlobalRelativeIdentity>] [-LocalStore]
 [<CommonParameters>]

Filter

Get-CsTenantTrustedIPAddress [-Tenant <System.Guid>] [-Filter <String>] [-LocalStore] [<CommonParameters>]

Parameters (4)

Parameter	Type	What it controls
-Filter	String	The Filter parameter allows you to limit the number of results based on filters you specify.
-Identity	XdsGlobalRelativeIdentity	The Identity parameter is a unique identifier that designates the scope. It specifies the collection of trusted IP address to be returned.
-LocalStore	SwitchParameter	PARAMVALUE: SwitchParameter
-Tenant	Guid	Globally unique identifier (GUID) of the tenant account whose trusted IP addresses are being returned.

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