Commands › Microsoft Teams

Set-CsTeamsWorkLocationDetectionPolicy

Microsoft Teams MicrosoftTeams Set-*

This cmdlet is used to update an instance of TeamsWorkLocationDetectionPolicy. This policy can be used to tailor the Automatic Update of work location experience in Microsoft Teams. When the EnableWorkLocationDetection parameter is enabled, a user’s work location is updated based on their interaction with organization‑managed networks and devices, such as desks or peripherals configured by IT administrators. To learn how to configure desks to certain work location, please see Configure buildings and floors - Microsoft Places | Microsoft Learn. Microsoft processes this information in accordance

Quick start script

# Set-CsTeamsWorkLocationDetectionPolicy — 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-CsTeamsWorkLocationDetectionPolicy
$before | Format-List

# 3. Make the change (dry run first)
Set-CsTeamsWorkLocationDetectionPolicy -Identity <String> -WhatIf
Set-CsTeamsWorkLocationDetectionPolicy -Identity <String>

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

Syntax

Set-CsTeamsWorkLocationDetectionPolicy [-EnableWorkLocationDetection <Boolean>] [-UserSettingsDefault <String>] [-Identity] <String> [-Force]
 [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (6)

Parameter	Type	Required	What it controls
-Confirm	SwitchParameter		Prompts you for confirmation before running the cmdlet.
-EnableWorkLocationDetection	Boolean		This parameter specifies whether Microsoft Teams determines a user’s work location based on interaction with organization‑managed networks and devices. When enabled, users' work location gets updated using signals...
-UserSettingsDefault	String		This parameter specifies the default user consent behavior when automatic update of work location is enabled and only applies to WiFi, and has no impact on device-based detection.
-Force	SwitchParameter		Suppresses the display of any non-fatal error message that might arise when running the command.
-Identity	String	yes	Name of the new policy instance to be updated.
-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.