Commands › Microsoft Teams

New-CsTenantTrustedIPAddress

Microsoft Teams MicrosoftTeams New-*

Creates a new IP address.

Quick start script

# New-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)
New-CsTenantTrustedIPAddress -Identity <XdsGlobalRelativeIdentity> -IPAddress <String> -WhatIf
New-CsTenantTrustedIPAddress -Identity <XdsGlobalRelativeIdentity> -IPAddress <String>

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

Syntax — 2 parameter sets

Identity (Default)

New-CsTenantTrustedIPAddress [-Tenant <System.Guid>] [-MaskBits <System.Int32>] [-Description <String>]
 [-Identity] <XdsGlobalRelativeIdentity> [-InMemory] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

ParentAndRelativeKey

New-CsTenantTrustedIPAddress [-Tenant <System.Guid>] -IPAddress <String> [-MaskBits <System.Int32>]
 [-Description <String>] [-InMemory] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (9)

Parameter	Type	Required	What it controls
-Confirm	SwitchParameter		Prompts you for confirmation before running the cmdlet.
-Description	String		Provide a description of the trusted IP address to identify purpose of creating it.
-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 IP address to be created.
-InMemory	SwitchParameter		PARAMVALUE: SwitchParameter
-IPAddress	String	yes	The name of the IP address. This must be a unique and valid IPv4 or IPv6 address. You cannot specify an IP address and an Identity at the same time.
-MaskBits	Int32		This parameter determines the length of bits to mask to the subnet.
-Tenant	Guid		Globally unique identifier (GUID) of the tenant account whose IP addresses are being created. 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.