Enrolling a device into the Pro Management Portal

This article explains how to enroll Teams Rooms devices to the Pro Management Portal. The Pro Management Portal supports Teams Rooms on Windows, Teams Rooms on Android, and Teams panel devices.

For Teams Rooms on Windows devices, the Teams Rooms Pro Management agent is automatically downloaded and installed at device setup. For Teams Rooms on Android devices or Teams panels, the admin agent included on the device automatically connects to the Pro Management Portal. Devices once signed into Teams automatically enrolls and appears in the Teams Rooms Pro Management Portal.

Prerequisites

Follow these procedures to set up your environment or device prior to attempting to connect a device to the Pro Management Portal.

Network security

Ensure the required URLs listed in Teams Rooms - Network Security are allowed on your network. For GCC-High customers, also add these two URLs:

• mmrgcchiot.azure-devices.us
• mmrgcchstor.blob.core.usgovcloudapi.net

If necessary, configure proxy settings on the device

Review proxy requirements and configuration steps for your Teams Rooms devices in Prepare your environment for Teams devices.

Manual Teams Rooms on Windows enrollment process

The enrollment process involves these steps:

1. On the left navigation bar of the Microsoft Teams Rooms Pro Management portal Commercial & GCC: http://portal.rooms.microsoft.com or GCC-High: http://devices.gov.teams.microsoft.us, expand Settings and select General.

2. Under Enroll a room, select Download installer to download the monitoring agent software.

3. Install the agent using the installer downloaded in step 2. This can be done either by running the MSI locally or via Intune.

4. The room appears in the portal within 5-10 minutes.

   

Agent Installation

After downloading the installer, unzip its contents to access the file ManagedRoomsInstaller.msi.

There are two modes of installation: 1) individual local machine install and 2) mass deploy mode (usually via Intune). We recommend individual install for nondomain joined machines or for machines that you have no way of running MSI installers remotely.

Individual device installation

1. Log in to the device as administrator. Ensure the Performing operations as the Admin user of the device steps are followed.

2. Copy the file ManagedRoomsInstaller.msi to the MTR device.

   On running the ManagedRoomsInstaller.msi is a License Agreement screen.

3. After reading the agreement, check I accept the terms in the License Agreement and press Install.

   This begins the Microsoft Teams Rooms Pro monitoring software install. A prompt for elevation (run as administrator) is displayed.

4. Select Yes.

   The installation continues. During the installation procedure, a console window opens and begins the final stage of the Microsoft Teams Rooms Pro monitoring software installation.

   Note

   Don't close the window. Once the installation is complete, the wizard displays a "Finish" button.

Intune-enrolled device bulk deployment

The following components are prerequisites for successful installation:

• Intune enrollment: Teams Rooms on Windows devices must be already enrolled in Intune. For more information about how to enroll Teams Rooms on Windows devices in Intune, see Enrolling Microsoft Teams Rooms on Windows devices with Microsoft Endpoint Manager - Microsoft Tech Community
• Microsoft Entra group with all Teams Rooms on Windows devices as members – a group created in Microsoft Entra ID that includes all Teams Rooms on Windows devices that should be part of the Microsoft Teams Rooms Premium service. This group is used for targeting the deployment of the MTR Pro agent.

To install using Intune

1. Sign in to the Microsoft Endpoint Manager admin center.

2. Select Apps > All apps > Add.

3. In the Select app type pane, under Other app types, select Line-of-business app.

4. Click Select. The Add app steps are displayed.

5. In the Add app pane, click Select app package file.

   1. In the App package file pane, select Browse. Then, select the ManagedRoomsInstaller.msi file downloaded previously (refer to the prerequisites section).
   2. When you're finished, select OK on the App package file pane to add the app.

6. In the App information page, perform the following changes:

   1. Publisher: enter Microsoft Corporation.

   2. Ignore app version: select Yes.

      Note

      The MTR Pro agent is self updating; hence, you should explicitly ignore the app version (any baseline version can update automatically).

   3. (Optional) Category: Select Computer Management.

7. Click Next to display the Assignments page.

   1. Under the Required section, click + add group to target a group of devices for installation of the agent.
   2. In the Select group pane, type the group name in the Search box (refer to prerequisites above) and click on the desired group and click Select. For more information, see Add groups to organize users and devices and Assign apps to groups with Microsoft Intune.

8. Click Next to display the Review + create page.

9. Review the values and settings you entered for the app. When you're done, click Create to add the app to Intune.

Once the process is completed, your devices will start installing the MTR Pro agent after a few minutes.

Unenrolling and uninstalling monitoring software

To unenroll the device, remove the monitoring agent from the Teams Rooms device as follows:

1. On the device being monitored, log in the device as administrator. Be sure to follow the steps in Performing operations as the Admin user of the device.

2. Download reset script from aka.ms/MTRPDeviceOffBoarding.

3. Extract the script somewhere on the device and copy the path.

4. Open PowerShell as administrator: In the Windows Search field (bottom-left section of the screen), enter 'PowerShell' and right-click Windows PowerShell.

5. Select "Run as Administrator" and accept UAC prompt.

6. Enter Set-ExecutionPolicy –ExecutionPolicy RemoteSigned , then press Y on next prompt.

7. Paste or type the full path to the unzipped offboarding script into the PowerShell window and press Enter. Example:

   C:\Users\admin\Downloads\MTRP\_Device\_Offboarding\MTRP\_Device\_Offboarding.ps1
   

8. This command resets the device to user standard MTR updates and removes the Teams Rooms Pro management monitoring agent and files.

9. From the left-hand menu in the Microsoft Teams Rooms Pro Management portal, select Rooms.

10. In the list of rooms provided, choose the room you want to unenroll and select Remove to stop getting incident alerts or investigation tickets, or to report an incident for the room.

Troubleshooting table

Application runtime log file ___location =

C:\Windows\ServiceProfiles\LocalService\AppData\Local\ServicePortalAgent\ app-x.x.x\ServicePortalAgent\ServicePortal_Verbose_LogFile.log, where x.x.x is the app version number.