Commands › Microsoft Teams

Grant-CsTeamsIPPhonePolicy

Assign a set of Teams phone policies to a user account or group of user accounts. Teams phone policies determine the features that are available to users of Teams phones. For example, you might enable the hot desking feature for some users while disabling it for others.

Quick start script

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

# 2. Run and inspect
Grant-CsTeamsIPPhonePolicy -Group <String> | Format-List

# 3. Export for evidence / drift tracking
Grant-CsTeamsIPPhonePolicy | Export-Clixml .\CsTeamsIPPhonePolicy-$(Get-Date -Format yyyyMMdd).xml

Syntax — 3 parameter sets

Identity (Default)

Grant-CsTeamsIPPhonePolicy [[-Identity] <String>] [-PassThru] [[-PolicyName] <String>]
 [-WhatIf] [-Confirm] [<CommonParameters>]

GrantToTenant

Grant-CsTeamsIPPhonePolicy [-PassThru] [[-PolicyName] <String>]
 [-Global] [-WhatIf] [-Confirm] [<CommonParameters>]

GrantToGroup

Grant-CsTeamsIPPhonePolicy [-PassThru] [[-PolicyName] <String>]
 -Group <String> [-Rank <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (10)

Parameter	Type	Required	What it controls
-Confirm	SwitchParameter		Prompts you for confirmation before running the cmdlet.
-DomainController	Object		Microsoft Internal Use Only.
-Global	SwitchParameter		Use this parameter to make the specified policy in -PolicyName the new effective global policy.
-Group	String	yes	Specifies the group used for the group policy assignment.
-Identity	Object		Indicates the identity of the user account the policy should be assigned to.
-PassThru	SwitchParameter		Including this parameter (which does not take a value) displays the user information when the cmdlet completes. Normally there is no output when this cmdlet is run.
-PolicyName	XdsIdentity		The Identity of the Teams phone policy to apply to the user.
-Rank	Int32		The rank of the policy assignment, relative to other group policy assignments for the same policy type.
-Tenant	Guid		Microsoft internal usage 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.