Commands › Microsoft Teams

Remove-CsTenantTrustedIPAddress

Microsoft Teams MicrosoftTeams Remove-*

Remove a tenant trusted IP address.

Quick start script

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

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsTenantTrustedIPAddress
$before | Format-List

# 3. Make the change (dry run first)
Remove-CsTenantTrustedIPAddress -Identity <XdsGlobalRelativeIdentity> -WhatIf
Remove-CsTenantTrustedIPAddress -Identity <XdsGlobalRelativeIdentity>

# 4. Verify and diff
$after = Get-CsTenantTrustedIPAddress
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

Remove-CsTenantTrustedIPAddress [-Tenant <System.Guid>] [-Identity] <XdsGlobalRelativeIdentity> [-Force]
 [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (5)

ParameterTypeRequiredWhat it controls
-Confirm SwitchParameter Prompts you for confirmation before running the cmdlet.
-Force SwitchParameter The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force switch isn't provided in the command, you're prompted for...
-Identity XdsGlobalRelativeIdentity yes Unique identifier for the trusted IP address to be removed.
-Tenant Guid Globally unique identifier (GUID) of the tenant account whose trusted IP address are being removed. For example:
-WhatIf SwitchParameter Shows what would happen if the cmdlet runs. The cmdlet is not run.

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