New-CsTeamsIPPhonePolicy

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