Using Atmos and CT Unite Services Together
Description
Both Atmos and CT Unite utilize Teams compliance recording applications and policies to integrate with Teams Voice services. When implementing these services, an application and policy was created for each service individually. However, a user can only be assigned to a single policy at a time.
If a user needs to be able to use both services, a new application and policy must be created that will combine Atmos and CT Unite into a single policy that can be assigned to users.
Below is a PowerShell script that can be run to accomplish this. The script will go through the following steps:
- Verify the necessary modules are installed and, if necessary, install them.
- Connect to Microsoft Teams and Entra
- Locate the application instances of both Atmos and CT Unite
- If both instances are found it will create a new compliance recording policy
- A new application is create for both Atmos and CT Unite which gets tied to the newly created recording policy.
- A new Entra ID security group is created called "Atmos and CT Unite Combined Recording"
- A group policy assignment is created to automatically assign the new recording policy to users in the new group.
Note: After implementing this setup, you will use the CT Unite portal “onboard.ctunite.services” (screenshot below) only for users who will only be using CT Unite. Users who need both services should not be managed through this portal.
Prerequisites
- Minimum Microsoft 365 admin roles required
- Teams Administrator
- Group Administrator
- Local administrator permission on the PC running the PowerShell script
- Ensure that any users needing both services do not have any other recording policies assigned directly or through other group policy assignments.
Directions
1. Open PowerShell or PowerShell ISE as administrator
2. Copy and paste the script below into PowerShell and run it
# 0) Pre-Requisites check and connect
$modules = Get-InstalledModule
if ($modules.name -notcontains "MicrosoftTeams") {
Install-Module MicrosoftTeams
Import-Module MicrosoftTeams
}
if ($modules.name -notcontains "Microsoft.Entra") {
Install-Module Microsoft.Entra
Import-Module Microsoft.Entra
}
$tenant = Connect-MicrosoftTeams
Connect-Entra
# 1) Resolve the two existing recorder app instances to their ObjectIds
$identityDisplayName = ($tenant.Account.Id).split("@")[1].split(".")[0].ToLower() + " Teams Bot"
$app1 = (Get-CsOnlineApplicationInstance | Where-Object "DisplayName" -like *$identityDisplayName*).ObjectId
$app2 = (Get-CsOnlineApplicationInstance | Where-Object {($_.DisplayName -like "*Atmos*") -or ($_.DisplayName -like "*CallCabinet*")}).ObjectId
if (-not $app1 -or -not $app2) { throw "Could not resolve one or both recorder app instances." }
# 2) Create the policy FIRST (no apps yet)
$policyName = "Atmos and CT Unite Combined Recording"
New-CsTeamsComplianceRecordingPolicy -Identity $policyName -Enabled $true -Description "Call recording policy to give users both CT Unite and Atmos recording"
# 3) Add EACH app to the existing policy (these are the associations)
New-CsTeamsComplianceRecordingApplication -Parent $policyName -Id $app1 -RequiredBeforeMeetingJoin:$false -RequiredBeforeCallEstablishment:$false -RequiredDuringMeeting:$true -RequiredDuringCall:$true
New-CsTeamsComplianceRecordingApplication -Parent $policyName -Id $app2 -RequiredBeforeMeetingJoin:$false -RequiredBeforeCallEstablishment:$false -RequiredDuringMeeting:$true -RequiredDuringCall:$true
# 4) Verify
Get-CsTeamsComplianceRecordingPolicy -Identity $policyName |
Select-Object Identity, Enabled, ComplianceRecordingApplications
# 5) Create new security group
$group = New-EntraGroup -SecurityEnabled $true -DisplayName $policyName -MailNickname "Atmos_CT_Unite" -MailEnabled $false -Description "Call recording goup to give users both CT Unite and Atmos recording"
# 6) Create new group policy assignment
New-CsGroupPolicyAssignment -GroupId $group.Id -PolicyType "TeamsComplianceRecordingPolicy" -PolicyName $policyName -Rank 1
3. Add users needing this new policy to the newly created group "Atmos and CT Unite Combined Recording" in Entra ID.