Edit

Share via

Get-CsTeamsWorkLocationDetectionPolicy

  • Reference
Module:
MicrosoftTeamsPowerShell

This cmdlet is used to fetch policy instances of TeamsWorkLocationDetectionPolicy.

Syntax

Get-CsTeamsWorkLocationDetectionPolicy
   [[-Identity] <String>]
   [<CommonParameters>]
Get-CsTeamsWorkLocationDetectionPolicy
   [-Filter <String>]
   [<CommonParameters>]

Description

Fetches instances of TeamsWorkLocationDetectionPolicy. Each policy object contains a property called 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.

Examples

Example 1

PS C:\> Get-CsTeamsWorkLocationDetectionPolicy

Identity            EnableWorkLocationDetection                                                                          
--------                 ----------------------                                                                          
Global                                     False
Tag:wld-enabled                            True
Tag:wld-disabled                           False

Fetches all the policy instances currently available.

Example 2

PS C:\> Get-CsTeamsWorkLocationDetectionPolicy -Identity wld-enabled

Identity            EnableWorkLocationDetection                                                                          
--------                 ----------------------                                                                          
Tag:wld-enabled                            True

Fetches an instance of a policy with a known identity.

Example 3

PS C:\> Get-CsTeamsWorkLocationDetectionPolicy -Filter *wld*

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.

Note: The "Tag:" prefix can be ignored when specifying the identity.

Parameters

-Filter

This parameter can be used to fetch policy instances based on partial matches on the Identity field.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Identity

This parameter can be used to fetch a specific instance of the policy.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.String

Outputs

TeamsWorkLocationDetectionPolicy.Cmdlets.TeamsWorkLocationDetectionPolicy