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

-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
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
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
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
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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
-Tenant

Internal Microsoft use only.

Type:Guid
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

System.Object