Commands › Microsoft Teams

New-CsTeamsIPPhonePolicy

Microsoft Teams MicrosoftTeams New-*

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.

Quick start script

# New-CsTeamsIPPhonePolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsTeamsIPPhonePolicy
$before | Format-List

# 3. Make the change (dry run first)
New-CsTeamsIPPhonePolicy -Identity <XdsIdentity> -WhatIf
New-CsTeamsIPPhonePolicy -Identity <XdsIdentity>

# 4. Verify and diff
$after = Get-CsTeamsIPPhonePolicy
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

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

Parameters (12)

Parameter	Type	Required	What it controls
-AllowBetterTogether	String		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:
-AllowHomeScreen	String		Determines whether the Home Screen feature of the Teams IP Phones is enabled. Possible values this parameter can take:
-AllowHotDesking	Boolean		Determines whether hot desking mode is enabled. Set this to TRUE to enable. Set this to FALSE to disable hot desking mode.
-Confirm	SwitchParameter		Prompts you for confirmation before running the cmdlet.
-Description	String		Free form text that can be used by administrators as desired.
-Force	SwitchParameter		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.
-HotDeskingIdleTimeoutInMinutes	String		Determines the idle timeout value in minutes for the signed in user account. When the timeout is reached, the account is logged out.
-Identity	XdsIdentity	yes	The identity of the policy that you want to create.
-SearchOnCommonAreaPhoneMode	Object		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.
-SignInMode	String		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...
-Tenant	Guid		Internal Microsoft use only.
-WhatIf	SwitchParameter		Shows what would happen if the cmdlet runs. The cmdlet is not run.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.