Commands › Microsoft Teams

Get-CsOnlineLisPort

Microsoft Teams MicrosoftTeams Get-*

Retrieves one or more ports from the location configuration database.

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

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

Syntax

Get-CsOnlineLisPort [[-ChassisID] <string>] [-Filter <string>] [-Force] [-IsDebug <bool>] [-NCSApiUrl <string>] [-PortID <string>] [-TargetStore <string>] [<CommonParameters>]

Parameters (7)

Parameter	Type	What it controls
-ChassisID	String	The Media Access Control (MAC) address of the port's switch. This value is in the form `nn-nn-nn-nn-nn-nn`, such as `12-34-56-78-90-ab`.
-Filter	String	Filters ports by property values. For example, use `ChassisID -in ['AA-BB-CC-DD-EE-01', 'AA-BB-CC-DD-EE-02']` to retrieve ports on either switch.
-Force	SwitchParameter	The `-Force` switch suppresses warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If you don't include the `-Force` switch in the command, the command prompts you for...
-IsDebug	Boolean	This parameter is reserved for internal Microsoft use.
-NCSApiUrl	String	This parameter is reserved for internal Microsoft use.
-PortID	String	This parameter identifies the ID of the port.
-TargetStore	String	This parameter is reserved for internal Microsoft use.

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