Microsoft Teams setup for Pexip CVI
This article explains how to make your environment ready for using Pexip's Cloud Video Interop (CVI) Service for Microsoft Teams. (For information on how to integrate Microsoft Teams with Pexip Infinity, please go here.)
If you are a new customer on the service and/or you have not already configured your DNS SRV records for the custom domain to use, this must be done. Please see Domain hosting DNS SRV records for instructions.
To configure your environment:
To manage this configuration, you must have the Global administrator role in your Office 365 tenant.
After requesting access to the service, you will receive an email asking you to authorize the Pexip CVI application. Click the linklink.
This opens a web page where you again need to click on.
Follow the instructions to log in with your O365 account and then clickwhen prompted.
Accept the request.More information on CVI app permissions
Information about the permissions required by the Pexip CVI app is provided in the following table:
Permission Details More information Read all users' full profiles
The User.Read.All application permission provides access to properties and permissions for operations listed at https://docs.microsoft.com/en-us/graph/api/resources/users?view=graph-rest-1.0, in particular the methods and properties listed at https://docs.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0 that require the User.Read.All permission.
It is used to:
- Show the user's UPN (user@domain) instead of GUID in logs for an administrator to know which user was in which call.
- Display the photo of a user if the user has not started their video.
and will enable Pexip in future releases to:
- Allow point-to-point call capabilities.
Application permissions: https://docs.microsoft.com/en-us/graph/permissions-reference#application-permissions-38 Initiate outgoing 1 to 1 calls from the app The Calls.Initiate.All application permission is not currently used. It may be used in the future to support point-to-point calling scenarios. Calls permissions: https://docs.microsoft.com/en-us/graph/permissions-reference#calls-permissions Initiate outgoing group calls from the app The Calls.InitiateGroupCall.All application permission is not currently used. It may be used in the future for creating ad hoc calls (e.g. to implement point-to-point calling scenarios). Join group calls and meetings as an app The Calls.JoinGroupCall.All application permission allows VTC devices to join a Teams meeting as a trusted participant (permits lobby bypass). Join group calls and meetings as a guest The Calls.JoinGroupCallAsGuest.All application permission allows VTC devices to join a Teams meeting as a guest/untrusted participant. Access media streams in a call as an app The Calls.AccessMedia.All application permission is used to access the media streams of participants that are attending a Teams meeting. Read online meeting details The OnlineMeetings.Read.All application permission is used to resolve the VTC meeting coordinate from the invite body into a Teams meeting. Online meetings permissions: https://docs.microsoft.com/en-us/graph/permissions-reference#online-meetings-permissions Sign in and read user profile The User.Read delegated permission is added by default for Azure AD apps, but is not used by the Pexip Teams Connector. User permissions: https://docs.microsoft.com/en-us/graph/permissions-reference#user-permissions Any permissions that are not currently used are included in the current consent process as it is not practical to re-consent existing apps as new functionality becomes available via the SDK and/or as we add additional functionality to the Teams Connector itself.
A confirmation page verifies that the consent was successfully provided. On this page, you'll also find a PowerShell script and further instructions. Copy and run the script as described on the page.
The instructions contained on this page to complete the setup are repeated here for your convenience.
Start a PowerShell session as Administrator and run the following commands:
Uninstall-Module MicrosoftTeams -AllVersions -Force
Install-Module MicrosoftTeams -MinimumVersion "2.0.0" -AllowClobber
(These commands ensure the appropriate MicrosoftTeams module is installed, and that it replaces any existing SkypeOnlineConnector module that may already be installed.)
Runthe following commands to sign in to your Teams tenant:
In all standard deployments run:
If this is a GCC High / Azure US Government Cloud deployment then use these commands instead:
Connect-MicrosoftTeams -TeamsEnvironmentName TeamsGCCH
Create a new video interop service provider with your App ID set as trusted.
Use the New-CsVideoInteropServiceProvider command as contained in your email as it includes your personalized information.
To run the command, you need the Global administrator role.
Grant interop for all users or specific individuals.
During normal rollout we recommend granting access for everyone in the organization (all users in the tenant):
Grant-CsTeamsVideoInteropServicePolicy -PolicyName PexipServiceProviderEnabled -Global
During trials you may want to only grant access to selected individuals in your company, for example:
Grant-CsTeamsVideoInteropServicePolicy -PolicyName PexipServiceProviderEnabled -Identity "firstname.lastname@example.org"
After this, the settings need to propagate and you will receive a final email from us when the service is ready:
- You can verify that your domain has been correctly set up here: dns.pexip.com.
- It may take several hours before the new meeting template is displayed.
Outlook users: the first time you invite, you may see that the meeting invite does not contain any new information. This is due to Outlook caching the previous meeting information. You therefore need to make two invitations for the new information to appear.
These articles provide further details about the CVI interop service and explain how to invite and join a Teams meeting from a video system and Skype for Business:
- About Pexip's Microsoft Teams CVI integration
- Inviting people to a Microsoft Teams meeting
- Joining a Microsoft Teams meeting via VTC
- Joining a Microsoft Teams meeting via Skype for Business
If you need to remove Pexip's CVI service, see Removing Microsoft Teams CVI.