Commands › Microsoft Teams
New-CsTeamsComplianceRecordingPolicy
Creates a new 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
# New-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)
New-CsTeamsComplianceRecordingPolicy -Identity <XdsIdentity> -WhatIf
New-CsTeamsComplianceRecordingPolicy -Identity <XdsIdentity>
# 4. Verify and diff
$after = Get-CsTeamsComplianceRecordingPolicy
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
New-CsTeamsComplianceRecordingPolicy [-Tenant <System.Guid>] [-Identity <XdsIdentity>]
[-Enabled <Boolean>] [-WarnUserOnRemoval <Boolean>] [-DisableComplianceRecordingAudioNotificationForCalls <Boolean>]
[-RecordReroutedCalls <Boolean>] [-Description <String>]
[-ComplianceRecordingApplications <ComplianceRecordingApplication[]>] [-CustomBanner <Guid>]
[-CustomPromptsEnabled <Boolean>] [-CustomPromptsPackageId <String>]
[-InMemory] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (15)
| 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. | |
| -CustomBanner | Guid | References the Custom Banner text in the storage. | |
| -CustomPromptsEnabled | Boolean | Indicates whether compliance recording custom prompts feature is enabled for this tenant / user. | |
| -CustomPromptsPackageId | String | Reference to custom prompts package. | |
| -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. | |
| -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 | yes | Unique identifier to be assigned to the new Teams recording policy. |
| -InMemory | SwitchParameter | Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of... | |
| -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.