Commands › Microsoft Teams

Get-CsTeamsComplianceRecordingPolicy

Microsoft Teams MicrosoftTeams Get-*

Returns information about the policies configured for governing automatic policy-based recording in your tenant. Automatic policy-based recording is only applicable to Microsoft Teams users.

Quick start script

# Get-CsTeamsComplianceRecordingPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Run and inspect
Get-CsTeamsComplianceRecordingPolicy -Id <Guid> -Parent <String> | Format-List

# 3. Export for evidence / drift tracking
Get-CsTeamsComplianceRecordingPolicy | Export-Clixml .\CsTeamsComplianceRecordingPolicy-$(Get-Date -Format yyyyMMdd).xml

Syntax — 2 parameter sets

Identity (Default)

Get-CsTeamsComplianceRecordingPolicy [-Tenant <System.Guid>] [-Identity <XdsIdentity>]  [-Id <Guid>] [-Parent <String>]
 [-LocalStore] [<CommonParameters>]

Filter

Get-CsTeamsComplianceRecordingPolicy [-Tenant <System.Guid>] [-Filter <String>]
 [-LocalStore] [<CommonParameters>]

Parameters (6)

Parameter	Type	Required	What it controls
-Filter	String		Enables you to use wildcards when retrieving one or more Teams recording policies. For example, to return all the policies configured at the per-user scope, use this syntax:
-Identity	XdsIdentity		Unique identifier of the Teams recording policy to be retrieved. To return the global policy, use this syntax:
-LocalStore	SwitchParameter		This parameter is reserved for internal Microsoft use.
-Tenant	Guid		Globally unique identifier (GUID) of the tenant account whose Teams recording policies are being queried. For example:
-Id	Guid	yes	The object ID of the compliance recording application (bot) in Microsoft Entra ID (Azure Active Directory).
-Parent	String	yes	The identity of the parent Teams Compliance Recording Policy that contains this compliance recording application.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.