Set Teams Phone
Assign a phone number to a Microsoft Teams enabled user, enable calling and Grant specific Microsoft Teams policies.
Description
Assign a phone number to a Microsoft Teams enabled user, enable calling and Grant specific Microsoft Teams policies. If the policy name of a policy is left blank, the corresponding policy will not be changed. To clear the policies assignment, the value "Global (Org Wide Default)" has to be entered.
Location
User → Phone → Set Teams Phone
Full Runbook name
rjgit-user_phone_set-teams-phone
Details
Version
1.0.2
Required modules
RealmJoin.RunbookHelper (>= 0.8.9) MicrosoftTeams (>= 7.9.0)
Schedulable
no
Permissions
Application permissions
Type: Microsoft Graph
Organization.Read.All
Required by the app-based Teams PowerShell sign-in to read tenant information
RBAC roles
Teams Administrator
Required to assign phone numbers and voice policies via Set-CsPhoneNumberAssignment and Grant-Cs cmdlets
Parameters
UserName
User principal name of the target user.
Required
true
Default Value
Type
String
Hidden in portal
yes (preset via runbook customization)
PhoneNumber
Phone number which should be assigned to the user. The number must be in E.164 format (e.g. +49123456789).
Required
true
Default Value
Type
String
Portal display name
Phone number to assign (E.164 Format - Example:+49123987654
OnlineVoiceRoutingPolicy
Name of the Online Voice Routing Policy to assign. If the policy name is left blank, the corresponding policy will not be changed. To clear the policies assignment, the value "Global (Org Wide Default)" has to be entered.
Required
false
Default Value
Type
String
Portal display name
Microsoft Teams Online Voice Routing Policy Name
TenantDialPlan
Name of the Tenant Dial Plan to assign. If the policy name is left blank, the corresponding policy will not be changed. To clear the policies assignment, the value "Global (Org Wide Default)" has to be entered.
Required
false
Default Value
Type
String
Portal display name
Microsoft Teams DialPlan Name
TeamsCallingPolicy
Name of the Teams Calling Policy to assign. If the policy name is left blank, the corresponding policy will not be changed. To clear the policies assignment, the value "Global (Org Wide Default)" has to be entered.
Required
false
Default Value
Type
String
Portal display name
Microsoft Teams Calling Policy Name
TeamsIPPhonePolicy
Name of the Teams IP Phone Policy to assign. If the policy name is left blank, the corresponding policy will not be changed. To clear the policies assignment, the value "Global (Org Wide Default)" has to be entered.
Required
false
Default Value
Type
String
Portal display name
Microsoft Teams IP Phone Policy Name (a.o. for Common Area Phone Users)
Last updated
Was this helpful?