Edit

Share via

New-CsTeamsWorkLocationDetectionPolicy

  • Reference
Module:
MicrosoftTeamsPowerShell

This cmdlet is used to create a new instance of the TeamsWorkLocationDetectionPolicy. The end user experience utilizing this policy has rolled out to the general public. You can see updates at Microsoft 365 Roadmap | Microsoft 365 and to learn more on how to enable the end user experience, please see Setting up Bookable Desks in Microsoft Teams - Microsoft Teams | Microsoft Learn.

Syntax

New-CsTeamsWorkLocationDetectionPolicy
   [-EnableWorkLocationDetection <Boolean>]
   [-Identity] <String>
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Creates a new instance of the TeamsWorkLocationDetectionPolicy. This policy can be used to tailor the work location detection experience. The parameter EnableWorkLocationDetection 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:\> New-CsTeamsWorkLocationDetectionPolicy -Identity wld-enabled -EnableWorkLocationDetection $true

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

Creates a new policy instance with the identity wld-enabled. EnableWorkLocationDetection is set to the value specified in the command.

Example 2

PS C:\> New-CsTeamsWorkLocationDetectionPolicy -Identity wld-disable

Identity                 EnableWorkLocationDetection
--------                 ----------------------
Tag:wld-disable                            False

Creates a new policy instance with the identity wld-disable. EnableWorkLocationDetection will default to false if it is not specified.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

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

-Force

Suppresses the display of any non-fatal error message that might arise when running the command.

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

-Identity

Name of the new policy instance to be created.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.String

Outputs

TeamsWorkLocationDetectionPolicy.Cmdlets.TeamsWorkLocationDetectionPolicy