Verifying Users Enabled for CVI

March 13, 2019 by · Leave a Comment 

This brief article includes a few tips on how to verify which Office 365 user account have been enabled to use a partner-provided Cloud Video Interop (CVI) solution, like the Polycom RealConnect Service.

When initially configuring an Office 365 tenant for CVI one of the final steps is to enable user accounts for the service.  The steps to do so though are different between Skype for Business and Microsoft Teams.

Note that in order to perform the PowerShell commands shown in this article one or more PowerShell Online modules will need to be setup on the workstation, if not already configured.  One potentially confusing concept in this article to pay extra attention to is that in order to check the Teams configuration the Skype for Business Online PowerShell Module is used (this module contains both Skype and Teams cmdlets), yet to check the Skype configuration the Azure Active Directory (v1) module is used.  This is because Teams uses a simple user setting via a policy while Skype leverages Office 365 add-on licenses.

Microsoft Teams

To enable the service for users on their own scheduled Microsoft Teams meetings the configuration is straightforward.  A simple PowerShell cmdlet would have been used to enable either individual users or the entire tenant globally.  If users have been enabled individually then the following steps will list those users.

  • Open Windows PowerShell and connect to the Skype for Business Online PowerShell module using the following cmdlets, but replacing the highlighted portion with the username of an administrative account in the target Office 365 tenant.  Enter the account’s password when prompted.

Import-Module SkypeOnlineConnector
$skype = New-CsOnlineSession -UserName "jeff@msteams.net"
Import-PSSession $skype

image

In order to list all users enabled for the service the Get-CsOnlineUser cmdlet will be executed and the results filtered to output only accounts which have the TeamsVideoInteropServicePolicy parameter set to the desired value.  In this example the Polycom service is being used, so the value to search for is ‘PolycomServiceProviderEnabled‘.  Currently other possible parameter values are ‘BlueJeansServiceProviderEnabled‘, ‘PexipServiceProviderEnabled‘, or ‘ServiceProviderDisabled‘.

  • Enter the following command to list all users enabled for the Polycom RealConnect Service for Microsoft Teams.

Get-CsOnlineUser -Filter {TeamsVideoInteropServicePolicy -eq "PolycomServiceProviderEnabled"} | Select-Object DisplayName, UserPrincipalName, TeamsVideoInteropServicePolicy

image

In the event that the TeamsVideoInteropServicePolicy has been previously set to a specific provider globally, then the individual user’s policy setting will operate in the standard policy relationship.  This means that any users with a null value on their parameter will use the Global policy setting, but if the user’s parameter is set to a different value then the user-specific value will take precedence.

  • The following cmdlet can be used to find the current tenant-level global policy setting.

Get-CsVideoInteropServiceProvider

image

Note that the tenant can only be configured to use one partner-provided service at a time, so the only viable configuration scenarios are shown in the following table outlining possible tenant and user configuration options.

Status TeamsVideoInteropServicePolicy
Tenant User
Service Disabled null null
Service Enabled null PolycomServiceProviderEnabled
Service Enabled PolycomServiceProviderEnabled null (or) PolycomServiceProviderEnabled
Service Disabled null (or) PolycomServiceProviderEnabled PolycomServiceProviderDisabled

Skype for Business

Unlike Microsoft Teams there is no option to simply globally enable the service on all users in a tenant for Skype meetings.  User configuration in Skype for Business is handled by assigning an Office 365 add-on license entitled "Skype for Business Video Interop for Skype for Business". 

image

Because this solution is user-license based then enough licenses must be provided in the tenant and they must all be manually assigned to existing user accounts, as well as added to new user accounts as they are created in the environment.

License entitlement is performed automatically through the Cloud Solutions Provider relationship with the partner and one license will automatically be added to the tenant for every existing qualifying user license that exists in the tenant (e.g. Business Essentials, Enterprise E5, etc).  For example, the tenant used in this article currently contains 20 Enterprise E1 licenses and 4 Enterprise E3 licenses, hence the total of 24 Video Interop licenses.

image

Given that Microsoft licenses are the components which enable the service for users then it is trivial to list all users in the tenant via PowerShell which are assigned a specific license.

  • Open Windows PowerShell and connect to the Azure Active Directory PowerShell module using the Connect-MsolService cmdlet.  When prompted enter the credentials of an administrative account for the Office 365 tenant.

Connect-MsolService

image

  • Enter the following command to parse all user accounts and list only those with an assigned license containing the string ‘Video’.

Get-MsolUser | Where-Object {($_.licenses).AccountSkuId -match "Video"} |ft UserPrincipalName,DisplayName,Licenses

image

The output above lists any user accounts currently assigned a VIDEO_INTEROP license.

About Jeff Schertz
Site Administrator

Speak Your Mind

Tell us what you're thinking...
and oh, if you want a pic to show with your comment, go get a gravatar!