New-CsTeamsIPPhonePolicy

Module:

MicrosoftTeamsPowerShell

Applies to:

Microsoft Teams

New-CsTeamsIPPhonePolicy allows you to create a policy to manage features related to Teams phone experiences. Teams phone policies determine the features that are available to users.

Syntax

New-CsTeamsIPPhonePolicy
   [-AllowHomeScreen <String>]
   [-AllowBetterTogether <String>]
   [-Description <String>]
   [-HotDeskingIdleTimeoutInMinutes <Int>]
   [-AllowHotDesking <Boolean>]
   [[-Identity] <XdsIdentity>]
   [-Tenant <Guid>]
   [-InMemory]
   [-SignInMode <String>]
   [-WhatIf]
   [-Confirm]
   [-Force]
   [-SearchOnCommonAreaPhoneMode <Object>]

Description

The New-CsTeamsIPPhonePolicy cmdlet allows you to create a policy to manage features related to Teams phone experiences assigned to a user account used to sign into a Teams phone.

Examples

Example 1

PS C:\> New-CsTeamsIPPhonePolicy -Identity CommonAreaPhone -SignInMode CommonAreaPhoneSignin

This example shows a new policy being created called "CommonAreaPhone" setting the SignInMode as "CommonAreaPhoneSignIn".

Parameters

-AllowBetterTogether

Determines whether Better Together mode is enabled, phones can lock and unlock in an integrated fashion when connected to their Windows PC running a 64-bit Teams desktop client. Possible values this parameter can take:

• Enabled
• Disabled

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

-AllowHomeScreen

Determines whether the Home Screen feature of the Teams IP Phones is enabled. Possible values this parameter can take:

• Enabled
• EnabledUserOverride
• Disabled

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

-AllowHotDesking

Determines whether hot desking mode is enabled. Set this to TRUE to enable. Set this to FALSE to disable hot desking mode.

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

-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

-Description

Free form text that can be used by administrators as desired.

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

-Force

Suppresses any confirmation prompts that would otherwise be displayed before making changes and 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

-HotDeskingIdleTimeoutInMinutes

Determines the idle timeout value in minutes for the signed in user account. When the timeout is reached, the account is logged out.

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

-Identity

The identity of the policy that you want to create.

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

-SearchOnCommonAreaPhoneMode

Determines whether a user can search the Global Address List in Common Area Phone Mode. Set this to ENABLED to enable the feature. Set this to DISABLED to disable the feature.

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

-SignInMode

Determines the sign in mode for the device when signing in to Teams. Possible Values:

• 'UserSignIn: Enables the individual user's Teams experience on the phone'
• 'CommonAreaPhoneSignIn: Enables a Common Area Phone experience on the phone'
• 'MeetingSignIn: Enables the meeting/conference room experience on the phone'

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

-Tenant

Internal Microsoft use only.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
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

None

Outputs

System.Object