PowerShell Commands

The PowerShell cmdlets used to configure the Cloud Video Interop service in Microsoft Teams are currently only available in the Skype for Business Online PowerShell module.

Use the following steps to connect to the online PowerShell module, configure Polycom as your Microsoft Teams Cloud Video Interop service provider, enable lobby bypass (if desired), and then enable either specific individual users or all users in the tenant.

Connect PowerShell to Skype for Business Online

Please refer to the following Microsoft documentation for client-side requirements and configuration instructions: https://docs.microsoft.com/en-us/office365/enterprise/powershell/manage-skype-for-business-online-with-office-365-powershell .

If the Skype for Business Online Windows PowerShell Module is not already installed on the current Windows computer then download and install it from here: https://www.microsoft.com/en-us/download/details.aspx?id=39366.

Launch Windows PowerShell and enter the following commands to establish a connection to the Skype for Business Online module. Replace the example UserName below with an administrator account for the target Office 365 tenant.

Import-Module SkypeOnlineConnector
$sfboSession = New-CsOnlineSession -UserName 'admin@yourdomain.com'
Import-PSSession $sfboSession

Troubleshooting

If the steps above result in the error "The remote name could not be resolved" then the domain provided in the ‘UserName’ parameter is likely missing the Lyncdiscover DNS record used with Skye for Business. That this occurs then use the following set of commands instead to connect by providing the original default domain for the tenant (e.g. domain.onmicrosoft.com).

Import-Module SkypeOnlineConnector
$sfboSession = New-CsOnlineSession -UserName 'admin@yourdomain.com' -OverrideAdminDomain 'company.onmicrosoft.com'
Import-PSSession $sfboSession

Configure Video Interop Service Provider

Define Service Provider

The following command will create a new video interop service provider defintion, selecting Polycom as the provider and configuring the Microsoft-assigned Tenant Key to be used with scheduled Teams meetings.

Enable Lobby Bypass (Optional)

By default all VTCs joining a Teams meeting through the video interoperabilty service will automatically be placed into the lobby. To change this behavior for all scheduled Teams meetings the following command can be used to allow VTCs to join meetings directly and bypass the lobby.

Set-CsVideoInteropServiceProvider -Identity Polycom -AllowAppGuestJoinsAsAuthenticated $true

Apply Video Interop Policy

The service is enabled by granting an existing policy either globally or on a per-user basis. It is recommended to enable individual users initially when testing the service and then later use the global approach to enable the service for all users.

Enable Individual Users

Enter the following PowerShell command, replacing user@domain.onmicrosoft.com with the UserPrincipalName of the desired user account. Repeat this command for each individual account to be enabled.

Grant-CsTeamsVideoInteropServicePolicy -PolicyName PolycomServiceProviderEnabled -Identity 'user@domain.com'

Enable All Users

Alternatively the following command can be used to enable the service at the global level.

Grant-CsTeamsVideoInteropServicePolicy -PolicyName PolycomServiceProviderEnabled

Verify Configuration (Optional)

The commands in this section do not need to be executed as they are simply provided as a way to verify that any of the previous configuration steps were in fact completed correctly.

The following command will output the currently configured interop provider and its individual parameters.

Get-CsVideoInteropServiceProvider

This command can be used to identify the current global policy setting. The ProviderName will likely either be the default value of "DefaultProvider" (meaning the service is not globally enabled for all users) or "Polycom" (meaning the service is enabled for all users).

Get-CsTeamsVideoInteropServicePolicy -Identity Global

Execute this command to list all users in the tenant which have manually been enabled for the service with Polycom as the defined provider.

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

In the event that the service was enabled globally and it is instead preferred to only enable it for invidiual users then the following command can be used to revert the tenant's global policy to its default configuration.

Grant-CsTeamsVideoInteropServicePolicy -PolicyName ServiceProviderDisabled

Disable Service

In the event that the RealConnect Service for Microsoft Teams is no longer needed the following steps can be used to revert the tenant to the original default configuration if desired.

Individually unassign the Polycom policy if it was manually granted to a user account

Grant-CsTeamsVideoInteropServicePolicy -PolicyName $null -Identity 'user@domain.com'

Programmatically unassign the Polycom policy from all users in the tenant which were specifically granted the policy

Get-CsOnlineUser -Filter {TeamsVideoInteropServicePolicy -eq 'PolycomServiceProviderEnabled'} | Grant-CsTeamsVideoInteropServicePolicy -PolicyName $null

Reset global Video Interop Service Policy to default configuration

Grant-CsTeamsVideoInteropServicePolicy -PolicyName ServiceProviderDisabled

Delete the Video Interop Service Provider definition for Polycom

Remove-CsVideoInteropServiceProvider -Identity Polycom