Update Get-CsTeamsWorkLocationDetectionPolicy documentation

Artemii Kozlov · Artemii Kozlov · commit 91e95009ac91 · 2024-02-07T22:25:09.000+01:00
diff --git a/teams/teams-ps/teams/Get-CsTeamsWorkLocationDetectionPolicy.md b/teams/teams-ps/teams/Get-CsTeamsWorkLocationDetectionPolicy.md
@@ -1,14 +1,17 @@
 ---
 external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml
-Module Name: Microsoft.Teams.Policy.Administration.Cmdlets.Core
-online version:
+Module Name: MicrosoftTeams
+online version: https://learn.microsoft.com/powershell/module/skype/get-csteamsworklocationdetectionpolicy
 schema: 2.0.0
+ms.author: arkozlov
+manager: prashibadkur
+author: artemiykozlov
 ---
 
 # Get-CsTeamsWorkLocationDetectionPolicy
 
 ## SYNOPSIS
-{{ Fill in the Synopsis }}
+This cmdlet is used to fetch policy instances of TeamsWorkLocationDetectionPolicy.
 
 ## SYNTAX
 
@@ -23,21 +26,52 @@ Get-CsTeamsWorkLocationDetectionPolicy [-Filter <String>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
-{{ Fill in the Description }}
+Fetches instances of TeamsWorkLocationDetectionPolicy. Each policy object contains a property called `EnableWorkLocationDetection`. This property lets organizations collect the work location information of users using users plugging into hotdesks (unassigned desks) or rooms using tenant admin managed devices, using M365 in proximity of tenant managed device as MTRs, and sharing geographic geo location of mobile phone. The users can consent to use this information to set their workplace location.  The location information will be stored in the cloud and will be used for M365 hybrid work location scenarios. This information will also be used by M365 to drive analytics on workplace utilization and enhance the hybrid work experience.
 
 ## EXAMPLES
 
 ### Example 1
 ```powershell
-PS C:\> {{ Add example code here }}
+PS C:\> Get-CsTeamsWorkLocationDetectionPolicy
 ```
+```output
+Identity            EnableWorkLocationDetection                                                                          
+--------                 ----------------------                                                                          
+Global                                     False
+Tag:wld-enabled                            True
+Tag:wld-disabled                           False
+```
+Fetches all the policy instances currently available.
+
+### Example 2
+```powershell
+PS C:\> Get-CsTeamsWorkLocationDetectionPolicy -Identity wld-enabled
+```
+```output
+Identity            EnableWorkLocationDetection                                                                          
+--------                 ----------------------                                                                          
+Tag:wld-enabled                            True
+```
+Fetches an instance of a policy with a known identity.
+
+### Example 3
+```powershell
+PS C:\> Get-CsTeamsWorkLocationDetectionPolicy -Filter *wld*
+```
+```output
+Identity            EnableWorkLocationDetection                                                                          
+--------                 ----------------------                                                                          
+Tag:wld-enabled                            True
+Tag:wld-disabled                          False
+```
+The `Filter` parameter can be used to fetch policy instances based on partial matches on Identity.
 
-{{ Add example description here }}
+Note: _The "Tag:" prefix can be ignored when specifying the identity._
 
 ## PARAMETERS
 
 ### -Filter
-{{ Fill Filter Description }}
+This parameter can be used to fetch policy instances based on partial matches on the Identity field.
 
 ```yaml
 Type: String
@@ -52,7 +86,7 @@ Accept wildcard characters: False
 ```
 
 ### -Identity
-{{ Fill Identity Description }}
+This parameter can be used to fetch a specific instance of the policy.
 
 ```yaml
 Type: String
@@ -71,7 +105,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## INPUTS
 
-### None
+### System.String
 
 ## OUTPUTS
 
@@ -80,3 +114,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## NOTES
 
 ## RELATED LINKS
+[New-CsTeamsWorkLocationDetectionPolicy](New-CsTeamsWorkLocationDetectionPolicy.md)
+
+[Remove-CsTeamsWorkLocationDetectionPolicy](Remove-CsTeamsWorkLocationDetectionPolicy.md)
+
+[Set-CsTeamsWorkLocationDetectionPolicy](Set-CsTeamsWorkLocationDetectionPolicy.md)
+
+[Grant-CsTeamsWorkLocationDetectionPolicy](Grant-CsTeamsWorkLocationDetectionPolicy.md)
