Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In order to complete the steps below, you must have Global Administrator or Teams Service Administrator role.

...

For more information on policies, see https://docs.microsoft.com/en-us/powershell/module/skype/set-csteamscompliancerecordingpolicy

The policy configuration consists of the following steps:

Table of Contents

Prerequisites

Step 1 - Download and install PowerShell 5.1.

Step 2 - Open PowerShell as administrator.

Step 3 - Set the security protocol to TLS 1.2 with the following command:

Code Block
languagepowershell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

...

Note
titleSeparate Azure tenants for the recording provider (bot) and for the Teams environment to record

In the case when the recorded Teams environment and the recording bot are in separate Microsoft Entra (formerly Azure AD) tenants, the following steps have to be done in the Teams tenant.

...

Step 5 - Execute the following command. Replace the <TenantId> part with your Azure Tenant ID (Creating the Microsoft Teams Recording Bot - Step 29). At the <Policy Description> part, provide some description. At the <PolicyName> part, provide a name. 

Code Block
languagepowershell
New-CsTeamsComplianceRecordingPolicy -Tenant '<TenantId>' -Enabled $true  -Description '<Policy Description>' -Identity '<PolicyName>'

Step 6 - Execute the following command.  Replace the <TenantId> parts with your Azure Tenant ID (Creating the Microsoft Teams Recording Bot - Step 29). Replace the <PolicyName> parts with the name provided in the previous command. Replace the <ObjectId> part with the Object ID gathered at the previous part of the configuration (Whitelisting the Microsoft Teams Bot App - Step 6).

Code Block
languagepowershell
Set-CsTeamsComplianceRecordingPolicy -Tenant '<TenantId>' -Identity '<PolicyName>' -ComplianceRecordingApplications @(New-CsTeamsComplianceRecordingApplication -Tenant '<TenantId>' -Parent '<PolicyName>' -Id '<ObjectId>')

...

NameDescriptionDefault Setting
RequiredBeforeMeetingJoinDefines if the bot has to join the call before the recorded user can join the meetings1 (On)
RequiredBeforeCallEstablishmentDefines if the bot has to join the call before the recorded user can place or receive calls1 (On)
RequiredDuringMeetingDefines if the recorded user will be disconnected from the meetings if the recorder bot connection is lost1 (On)
RequiredDuringCallDefines if the recorded user will be disconnected from the call if the recorder bot connection is lost1 (On)


Warning

It is strongly recommended to use the default settings (strict mode) for the compliance recording policies. The default settings ensure that if, for some reason, the bot cannot join or disconnects from the call/meeting, the recorded user will be disconnected automatically to avoid compliance issues. There is no failover or automatic retry mechanism implemented on the Teams side.


Follow the steps below to change the settings:

Step 8 - Execute the following command to get the ID of the compliance recording application and the name of the compliance recording policy. It will return the name of the compliance recording policy in the Identity field. Take note of the value of the Identity field (after the Tag: part). It also returns the compliance recording application ID. Take a note of the identifier which is displayed after ComplianceRecordingApplications : {Id=

Code Block
languagepowershell
Get-CsTeamsComplianceRecordingPolicy

...