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-policy -EnableWorkLocationDetection $true

Identity                 EnableWorkLocationDetection
--------                 ----------------------
Tag:wld-policy                            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-policy

Identity                 EnableWorkLocationDetection
--------                 ----------------------
Tag:wld-policy                            False

Creates a new policy instance with the identity wld-policy. 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

Share via