Commands › Microsoft Teams
Get-CsOnlineLisSwitch
Retrieves one or more network switches 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-CsOnlineLisSwitch — 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-CsOnlineLisSwitch | Format-List
# 3. Export for evidence / drift tracking
Get-CsOnlineLisSwitch | Export-Clixml .\CsOnlineLisSwitch-$(Get-Date -Format yyyyMMdd).xmlSyntax
Get-CsOnlineLisSwitch [[-ChassisID] <string>] [-Filter <string>] [-Force] [-IsDebug <bool>] [-NCSApiUrl <string>] [-TargetStore <string>] [<CommonParameters>]Parameters (6)
| Parameter | Type | Required | 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 switches by property values. Use `ChassisID -eq 'AA-BB-CC-DD-EE-01'` to match one chassis ID, or `ChassisID -in ['AA-BB-CC-DD-EE-01', 'AA-BB-CC-DD-EE-02']` to match any chassis ID in a list. | |
| -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. | |
| -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.