Get-CsTeamsWorkLocationDetectionPolicy
This cmdlet is used to fetch policy instances of TeamsWorkLocationDetectionPolicy.
Syntax
Identity (Default)
Get-CsTeamsWorkLocationDetectionPolicy
[[-Identity] <String>]
[<CommonParameters>]
Filter
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-policy1 True
Tag:wld-policy2 False
Fetches all the policy instances currently available.
Example 2
PS C:\> Get-CsTeamsWorkLocationDetectionPolicy -Identity wld-policy1
Identity EnableWorkLocationDetection
-------- ----------------------
Tag:wld-policy1 True
Fetches an instance of a policy with a known identity.
Example 3
PS C:\> Get-CsTeamsWorkLocationDetectionPolicy -Filter *wld*
Identity EnableWorkLocationDetection
-------- ----------------------
Tag:wld-policy1 True
Tag:wld-policy2 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.
Parameter properties
Type: | String |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
Filter
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-Identity
This parameter can be used to fetch a specific instance of the policy.
Parameter properties
Type: | String |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
Identity
Position: | 1 |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.