Commands › Microsoft Teams
Set-CsTeamsComplianceRecordingPolicy
Modifies an existing Teams recording policy for governing automatic policy-based recording in your tenant. Automatic policy-based recording is only applicable to Microsoft Teams users.
Quick start script
# Set-CsTeamsComplianceRecordingPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId
# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsTeamsComplianceRecordingPolicy
$before | Format-List
# 3. Make the change (dry run first)
Set-CsTeamsComplianceRecordingPolicy -WhatIf
Set-CsTeamsComplianceRecordingPolicy
# 4. Verify and diff
$after = Get-CsTeamsComplianceRecordingPolicy
Compare-Object ($before | Out-String) ($after | Out-String)Syntax — 2 parameter sets
Identity (Default)
Set-CsTeamsComplianceRecordingPolicy [-Tenant <System.Guid>] [-Identity <XdsIdentity>]
[-Enabled <Boolean>] [-WarnUserOnRemoval <Boolean>] [-Description <String>]
[-DisableComplianceRecordingAudioNotificationForCalls <Boolean>] [-RecordReroutedCalls <Boolean>]
[-ComplianceRecordingApplications <ComplianceRecordingApplication[]>] [-CustomBanner <Guid>]
[-Force] [-WhatIf] [-Confirm] [<CommonParameters>]Instance
Set-CsTeamsComplianceRecordingPolicy [-Tenant <System.Guid>] [-Instance <PSObject>]
[-Enabled <Boolean>] [-WarnUserOnRemoval <Boolean>] [-Description <String>]
[-ComplianceRecordingApplications <ComplianceRecordingApplication[]>]
[-Force] [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (13)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -ComplianceRecordingApplications | ComplianceRecordingApplication[] | A list of application instances of policy-based recording applications to assign to this policy. The Id of each of these application instances must be the ObjectId of the application instance as obtained by the... | |
| -Confirm | SwitchParameter | Prompts you for confirmation before running the cmdlet. | |
| -Description | String | Enables administrators to provide explanatory text to accompany a Teams recording policy. For example, the Description might include information about the users the policy should be assigned to. | |
| -DisableComplianceRecordingAudioNotificationForCalls | Boolean | Setting this attribute to true disables recording audio notifications for 1:1 calls that are under compliance recording | |
| -DisableComplianceRecordingAudioNotificationForCalls | Boolean | Setting this attribute to true disables recording audio notifications for 1:1 calls that are under compliance recording. | |
| -Enabled | Boolean | Controls whether this Teams recording policy is active or not. | |
| -Force | SwitchParameter | Suppresses the display of any non-fatal error message that might arise when running the command. | |
| -Identity | XdsIdentity | Unique identifier to be assigned to the new Teams recording policy. | |
| -Instance | PSObject | Allows you to pass a reference to an object to the cmdlet rather than set individual parameter values. | |
| -RecordReroutedCalls | Boolean | Setting this attribute to true enables compliance recording for calls that have been re-routed from a compliance recording-enabled user. Supported call scenarios include forward, transfer, delegation, call groups,... | |
| -Tenant | Guid | Globally unique identifier (GUID) of the tenant account whose Teams recording policies are being queried. For example: | |
| -WarnUserOnRemoval | Boolean | This parameter is reserved for future use. | |
| -WhatIf | SwitchParameter | Shows what would happen if the cmdlet runs. The cmdlet is not run. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.