One-time operation: Add back-end application to Teams Application Meeting Configuration

Once consent is granted to the App Registration, there is one more permission required. The back-end App Registration should be allowed to remove participants from calls. This can be used to remove the Agent from the call when the Customer disconnects and vice versa.

This permission needs to be granted by using the MicrosoftTeams PowerShell module. If you do not have this PowerShell module installed, please follow below steps.

Install the MicrosoftTeams PowerShell module

1. Open Windows PowerShell or PowerShell with Elevated Permissions

   1. Make sure to use 64-bit version of PowerShell
   2. Make sure you have admin privileges
   3. Right-click PowerShell and click Run as Administrator

2. Run the following PowerShell command to verify whether the MicrosoftTeams PowerShell module is installed

   Copy

   PowerShell

   Get-InstalledModule MicrosoftTeams

   Important

   If you have Microsoft Teams module version 5.3.0, it is highly recommended that you uninstall it and install the latest version. The following steps in the guide are not compatible with version 5.3.0. Uninstalling the module can be done with the command below. After this, you can continue with the guide.

   Copy

   PowerShell

   uninstall-module MicrosoftTeams

   Expected outcome: If the module is not installed, the following message will show up

   

3. Run the following PowerShell command to install the MicrosoftTeams PowerShell module

   Copy

   PowerShell

   Install-module -name MicrosoftTeams -force

4. Optionally, you will be prompted to confirm installing the module (in case there is no trusted PowerShell Repository configured). Select Yes or Yes to all

   

5. Wait for the installation to complete

6. Re-run the following PowerShell command to verify whether the MicrosoftTeams PowerShell module is installed

   Copy

   PowerShell

   Get-InstalledModule MicrosoftTeams

   Expected outcome: The version number of the MicrosoftTeams PowerShell module will be shown

   

Grant permissions to remove participants from the call

When the MicrosoftTeams PowerShell module is installed, the following steps should be executed to grant the back-end App Registration permissions to remove participants from calls. For example, this is needed when a customer or agent disconnects, and the dialogue should be ended accordingly.

1. Open Windows PowerShell or PowerShell (no Elevated Permissions are needed)

   1. Make sure to use 64-bit version of PowerShell

2. Run the following PowerShell command to login to Microsoft Teams

   Copy

   PowerShell

   Connect-MicrosoftTeams

3. Login with a Microsoft User Account that has either one of these permissions

   1. Global Administrator; or
   2. Teams Administrator; or
   3. Teams Communications Administrator

   To learn how to assign user roles with Azure Active Directory please visit:
   Add an existing Azure subscription to your tenant | Microsoft Learn

   Expected outcome: If you are successfully logged in, your account and tenant details will be displayed

   

   Unexpected outcome: You receive an error message indicating the command was found but the module could not be loaded.

   

   Run the following PowerShell command

   Copy

   PowerShell

   Import-Module MicrosoftTeams

   If an error message shows up stating that running scripts is disabled, run the follow PowerShell Command to make sure executing PowerShell scripts is allowed.

   Copy

   PowerShell

   Set-ExecutionPolicy RemoteSigned

4. Run the following PowerShell command to allow the back-end App Registration to remove participants from calls

   Note

   Please select your matching regional PowerShell command.

   Copy

   PowerShell for Production NORA

   Set-CsApplicationMeetingConfiguration -AllowRemoveParticipantAppIds @{Add='ddecbc1f-b83e-4725-8535-a0d2fe3e5369'}

   Copy

   PowerShell for Production EMEA

   Set-CsApplicationMeetingConfiguration -AllowRemoveParticipantAppIds @{Add='71240355-f973-44f0-af0c-f1fdd0275214'}

   Copy

   PowerShell for Preview

   Set-CsApplicationMeetingConfiguration -AllowRemoveParticipantAppIds @{Add='fc323a43-fda2-4a68-9ee4-75961abd77a9'}

5. Run the following PowerShell command to verify if the App Registration is added successfully.

   Copy

   PowerShell

   Get-CsApplicationMeetingConfiguration | select -expandproperty AllowRemoveParticipantAppIds

   Expected outcome: An App Registration with matching ID should be listed

   Note

   Please select your matching regional Application ID.

   Copy

   Production NORA Application Id

   ddecbc1f-b83e-4725-8535-a0d2fe3e5369

   Copy

   Production EMEA Application Id

   71240355-f973-44f0-af0c-f1fdd0275214

   Copy

   Preview Application Id

   fc323a43-fda2-4a68-9ee4-75961abd77a9

   

Next Steps

One-time operation: Update default permissions to Agent.