Teams number plan and number assignment

What it is for

The number plan shows all phone numbers Microsoft holds for this tenant: numbers from Operator Connect, Direct Routing and Calling Plan. For each number you see type, owner, operator and whether EasyUC uses it as the target of a script.

From the number plan you assign a number to a Teams user or resource account, or take an assignment back. EasyUC does this through Teams PowerShell. Beforehand a preview shows which steps run, whether the user has a Teams Phone licence and Enterprise Voice, and what is in the way.

The numbers themselves come from Teams PowerShell. Microsoft Graph only supplies the display name of the owner.

Prerequisites

• Licence module teams. Without this module the EasyUC Teams workspace does not appear.
• Role EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) with the sub-permissions TENANTS (ROLE_APP_TEAMS_TENANTS) to read and TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT) to change.
• EasyUC is signed in to Teams PowerShell or an app registration is stored. Without a sign-in the number plan stays empty.
• For display names and the user search: Graph credentials with User.Read.All.
• For an assignment: the target user has a Teams Phone licence. The preview checks this.

Step by step: Search and view numbers

1. Open Teams Tenants, click the tenant and select Number plan in the tenant bar.
2. Under Phone number, choose the search mode begins with, contains or ends with and type the digits.
3. Narrow down to a number type with Type.
4. Under Show, choose whether you want to see all numbers, assigned only, not assigned only, users only, resource accounts only or EasyUC targets only.
5. Under Limit, set how many rows appear per page: 10, 20, 50 or 100.
6. In a row, click Actions and then Show details. The row expands and shows, among other things, SMS, emergency address, activation state, assignment status, capabilities and porting order.

Step by step: Assign a number to a user

1. In the row of the number, click Actions and then Assign ….
2. In the dialog, search by name, mail address or UPN. Only the first hits are shown; narrow the search if necessary.
3. Click the user or resource account you want. The preview loads.
4. Check Phone number, Number type and User with UPN.
5. Check Currently assigned to, Teams Phone licence, Enterprise Voice and Current number of the user.
6. Read These steps will run. Each step is marked will be executed, already in place or skipped.
7. If something is listed under This is in the way, fix it in Microsoft first. Read the notes under Please note before you continue.
8. If you chose the wrong user, click Choose another user.
9. Click Assign number. The prompt Are you sure? appears.
10. Click Yes, execute now. Only now does EasyUC write to Microsoft.
11. Wait for “The number has been assigned.” and click Close.

Step by step: Remove an assignment

1. In the row of the assigned number, click Actions and then Remove assignment ….
2. Check the number and the previous owner in the preview.
3. Click Remove assignment and then Yes, execute now.
4. Wait for “The assignment has been removed.” and click Close.

Fields and options

Check the result and narrow down errors

• Success: after closing the dialog the row in the number plan shows the new owner. The number also appears in the user details under Teams phone number.
• “Microsoft Graph credentials are missing” with the note “Without Graph credentials the numbers still come from Teams PowerShell, but the display name of the owner stays empty.” The list works, just without names.
• “This tenant does not return any telephone number.” Check the sign-in to Teams PowerShell on the Settings page.
• „Die Rufnummernart konnte nicht ermittelt werden: …“ There is no usable PowerShell sign-in. Sign in again.
• „Diese Nummer ist im EasyUC-Script „…“ als … hinterlegt. Eine Änderung in Microsoft Teams wirkt sich auf die Erreichbarkeit dieses Scripts aus.“ Change the script first or cancel.
• Teams Phone licence unknown is not a confirmed licence. Check the licence in Microsoft 365 before assigning.
• If execution fails, the message from Microsoft is shown in the dialog. Reload the number plan before trying again so that you start from the actual state.