Merge pull request #13384 from MicrosoftDocs/main

[AutoPublish] main to live - 02/19 13:39 PST | 02/20 03:09 IST

Author: m365-skilling-repo-management[bot]

teams/teams-ps/MicrosoftTeams/Get-CsTeamsWorkLocationDetectionPolicy.md

@@ -30,9 +30,31 @@ Get-CsTeamsWorkLocationDetectionPolicy [-Filter <String>] [<CommonParameters>]
 ## DESCRIPTION
 Fetches instances of TeamsWorkLocationDetectionPolicy. Each policy object contains the following properties:
 
-- `EnableWorkLocationDetection`: This setting allows your organization to collect the work location of users when they connect, interact, or are detected near your organization's networks and devices. It also captures the geographic location information users share from personal and mobile devices. This gives users the ability to consent to the use of this location data to set their current work location. Microsoft collects this information to provide users with a consistent location-based experience and to improve the hybrid work experience in Microsoft 365 according to the [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839).
+-  `EnableWorkLocationDetection`: specifies whether Microsoft Teams determines a user’s work location based on interaction with organization‑managed networks and devices. When enabled, Teams sets the user’s current work location using signals from administrator‑configured resources, such as desks or peripherals managed by the organization. This parameter does not collect or use geographic location data from users’ personal or mobile devices. Location information is used to support consistent location‑based experiences in Microsoft Teams and Microsoft 365 and is processed in accordance with the [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839). 
 
-- `UserSettingsDefault`: Specifies the default user settings behavior for work location detection. Possible values are `Disabled` (default) and `Enabled`.
+- `UserSettingsDefault`: Specifies the default user consent behavior when automatic detection is enabled and only applies to WiFi, and has no impact on device-based detection.
+  - `Disabled` (default): Users must explicitly opt in (Ask mode).
+  - `Enabled`: Automatic detection is enabled by default, and users can opt out (Inform mode).
+
+Learn more about the [admin configuration modes](https://learn.microsoft.com/en-us/microsoft-365/places/configure-auto-detect-work-location).
+
+The combination of these settings determines whether automatic detection runs, which signals are active, and how users are informed.
+
+### Behavior matrix
+
+| EnableWorkLocationDetection | UserSettingsDefault | Automatic detection behavior |
+|----------------------------|---------------------|------------------------------|
+| False | (ignored) | Peripheral and Wi-Fi check-in are disabled. UserSettingsDefault is ignored. |
+| True | Disabled | Peripheral and Wi-Fi check‑in are enabled. Wi‑Fi check‑in runs in **Ask mode**, meaning users will be asked to opt in before detection activates. |
+| True | Enabled | Peripheral and Wi‑Fi check‑in are enabled. Wi-Fi check-in runs in **Inform mode**, meaning Wi-Fi based detection is on by default and users can opt out. |
+| False | Enabled | Peripheral check‑in is disabled. Wi‑Fi check‑in is disabled. UserSettingsDefault is ignored when EnableWorkLocationDetection is set to False. |
+
+### Notes on behavior
+
+- When **EnableWorkLocationDetection** is set to **False**, automatic detection is fully disabled regardless of user defaults.
+- When **EnableWorkLocationDetection** is set to **True**, **UserSettingsDefault** determines whether users experience **Ask (opt‑in)** or **Inform (opt‑out)** behavior.
+- Peripheral and Wi‑Fi signals follow the same consent model and are not independently configured.
+- Automatic detection applies only to **actual location** for the current working day and is cleared at the end of a user’s working hours.
 
 ## EXAMPLES