Edit

Share via


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.

Inputs

System.String

Outputs

TeamsWorkLocationDetectionPolicy.Cmdlets.TeamsWorkLocationDetectionPolicy