Commands › Microsoft Teams
Grant-CsTeamsComplianceRecordingPolicy
Assigns a per-user Teams recording policy to one or more users. This policy is used to govern automatic policy-based recording in your tenant. Automatic policy-based recording is only applicable to Microsoft Teams users.
Quick start script
# Grant-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
Grant-CsTeamsComplianceRecordingPolicy -Group <String> -PolicyName <String> | Format-List
# 3. Export for evidence / drift tracking
Grant-CsTeamsComplianceRecordingPolicy | Export-Clixml .\CsTeamsComplianceRecordingPolicy-$(Get-Date -Format yyyyMMdd).xmlSyntax — 3 parameter sets
Identity (Default)
Grant-CsTeamsComplianceRecordingPolicy [-Identity <UserIdParameter>] [-PolicyName <String>]
[-Tenant <System.Guid>] [-DomainController <Fqdn>]
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]GrantToTenant
Grant-CsTeamsComplianceRecordingPolicy [-Global] [-PolicyName <String>]
[-Tenant <System.Guid>] [-DomainController <Fqdn>]
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]GrantToGroup
Grant-CsTeamsComplianceRecordingPolicy [-PassThru] [[-PolicyName] <String>]
[-MsftInternalProcessingMode <String>] -Group <String> [-Rank <Int32>] [-WhatIf] [-Confirm]
[<CommonParameters>]Parameters (10)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Confirm | SwitchParameter | Prompts you for confirmation before running the cmdlet. | |
| -DomainController | Fqdn | This parameter is reserved for internal Microsoft use. | |
| -Global | SwitchParameter | When you use this cmdlet without specifying a user identity, the policy applies to all users in your tenant. To skip a warning when you do this operation, specify "-Global". | |
| -Group | String | yes | Specifies the group used for the group policy assignment. |
| -Identity | UserIdParameter | Indicates the Identity of the user account to be assigned the per-user Teams recording policy. User Identities can be specified using one of the following formats: | |
| -PassThru | SwitchParameter | Enables you to pass a user object through the pipeline that represents the user account being assigned the Teams recording policy. By default, the Grant-CsTeamsComplianceRecordingPolicy cmdlet does not pass objects... | |
| -PolicyName | String | yes | Name of the policy to be assigned. The PolicyName is simply the policy Identity without the policy scope i.e. the "Tag:" prefix. For example, a policy with the Identity Tag:ContosoPartnerComplianceRecordingPolicy has... |
| -Rank | Int32 | The rank of the policy assignment, relative to other group policy assignments for the same policy type. | |
| -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.