Commands › Microsoft Teams

New-CsTeamsComplianceRecordingApplication

Microsoft Teams MicrosoftTeams New-*

Creates a new association between an application instance of a policy-based recording application and a Teams recording policy for administering automatic policy-based recording in your tenant. Automatic policy-based recording is only applicable to Microsoft Teams users.

Quick start script

# New-CsTeamsComplianceRecordingApplication — 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-CsTeamsComplianceRecordingApplication
$before | Format-List

# 3. Make the change (dry run first)
New-CsTeamsComplianceRecordingApplication -Id <String> -Identity <XdsIdentity> -Parent <String> -WhatIf
New-CsTeamsComplianceRecordingApplication -Id <String> -Identity <XdsIdentity> -Parent <String>

# 4. Verify and diff
$after = Get-CsTeamsComplianceRecordingApplication
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax — 2 parameter sets

Identity (Default)

New-CsTeamsComplianceRecordingApplication [-Tenant <System.Guid>] [-Identity <XdsIdentity>]
 [-RequiredBeforeMeetingJoin <Boolean>] [-RequiredDuringMeeting <Boolean>]
 [-RequiredBeforeCallEstablishment <Boolean>] [-RequiredDuringCall <Boolean>]
 [-ConcurrentInvitationCount <UInt32>] [-ComplianceRecordingPairedApplications <ComplianceRecordingPairedApplication[]>]
 [-Priority <Int32>] [-InMemory] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

ParentAndRelativeKey

New-CsTeamsComplianceRecordingApplication [-Tenant <System.Guid>] -Parent <String> -Id <String>
 [-RequiredBeforeMeetingJoin <Boolean>] [-RequiredDuringMeeting <Boolean>]
 [-RequiredBeforeCallEstablishment <Boolean>] [-RequiredDuringCall <Boolean>]
 [-ConcurrentInvitationCount <UInt32>] [-ComplianceRecordingPairedApplications <ComplianceRecordingPairedApplication[]>]
 [-Priority <Int32>] [-InMemory] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (15)

Parameter	Type	Required	What it controls
-ComplianceRecordingPairedApplications	ComplianceRecordingPairedApplication[]		Determines the other policy-based recording applications to pair with this application to achieve application resiliency. Can only have one paired application.
-ConcurrentInvitationCount	UInt32		Determines the number of invites to send out to the application instance of the policy-based recording application. Can be set to 1 or 2 only.
-Confirm	SwitchParameter		Prompts you for confirmation before running the cmdlet.
-Force	SwitchParameter		Suppresses the display of any non-fatal error message that might arise when running the command.
-Id	String	yes	The ObjectId of the application instance of a policy-based recording application as exposed by the Get-CsOnlineApplicationInstance cmdlet. For example, the Id of an application instance can be...
-Identity	XdsIdentity	yes	A name that uniquely identifies the application instance of the policy-based recording application.
-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...
-Parent	String	yes	The Identity of the Teams recording policy that this application instance of a policy-based recording application is associated with. For example, the Parent of an application instance can be...
-Priority	Int32		This priority determines the order in which the policy-based recording applications are displayed in the output of the Get-CsTeamsComplianceRecordingPolicy cmdlet.
-RequiredBeforeCallEstablishment	Boolean		Indicates whether the policy-based recording application must be in the call before the call is allowed to establish.
-RequiredBeforeMeetingJoin	Boolean		Indicates whether the policy-based recording application must be in the meeting before the user is allowed to join the meeting.
-RequiredDuringCall	Boolean		Indicates whether the policy-based recording application must be in the call while the call is active.
-RequiredDuringMeeting	Boolean		Indicates whether the policy-based recording application must be in the meeting while the user is in the meeting.
-Tenant	Guid		Globally unique identifier (GUID) of the tenant account whose Teams recording policies are being queried. For example:
-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.