How to Configure Teams Video Filter and Background Policies Using PowerShell CsTeamsVideoFiltersPolicy

In enterprise Microsoft Teams deployments, visual presentation during video meetings directly affects professional conduct, data privacy, and organizational compliance. While video effects—such as background blur, standard corporate images, custom user uploads, and AI facial enhancement filters—improve user comfort, regulated industries (such as financial advisory, healthcare, and legal services) often require strict boundaries to prevent inappropriate custom backgrounds or unauthorized video modifications. Through the Microsoft Teams PowerShell module, administrators can define and enforce granular video filter policies using the CsTeamsVideoFiltersPolicy cmdlet suite. These policies control the exact category of background visual effects permitted for specific organizational units and users.

Understanding Teams Video Filter Policy Modes

The CsTeamsVideoFiltersPolicy cmdlet governs video effect capabilities through the VideoFiltersMode parameter. Microsoft Teams provides four hierarchical modes:

• NoFilters: Disables all video enhancements completely. Users cannot blur their background, apply custom images, or use cosmetic facial filters. The raw camera feed is strictly broadcast.
• BlurOnly: Allows users to apply standard background blur (both standard and soft blur). Users cannot select background images or upload custom imagery, shielding sensitive domestic or office environments while preventing inappropriate image displays.
• BlurAndDefaultBackgrounds: Permits background blur alongside Microsoft-provided default corporate backgrounds. Custom image uploads and third-party filters remain prohibited.
• AllFilters: Unlocks full capability, allowing blur, default backgrounds, custom user image uploads, and cosmetic/studio lighting filters.

Connecting to Microsoft Teams PowerShell

To administer video filter policies, launch an elevated PowerShell session and connect to your Microsoft 365 tenant using the MicrosoftTeams module:

# Install module if not previously installed
Install-Module -Name MicrosoftTeams -Force -AllowClobber

# Authenticate with Teams Administrator credentials
Connect-MicrosoftTeams

Ensure your administrative account holds the Teams Administrator or Global Administrator role.

Auditing Existing Video Filter Policies

To review the global default policy and any custom video filter policies configured in your tenant, execute:

Get-CsTeamsVideoFiltersPolicy | Format-Table Identity, VideoFiltersMode, Description -AutoSize

In standard tenants, the default Global policy is configured with VideoFiltersMode: AllFilters, giving all users unrestricted access to custom background uploads and video effects.

Creating Granular Video Filter Policies for Regulated Roles

To restrict video backgrounds for compliance-sensitive departments (such as call centre representatives, trading desks, or healthcare practitioners), create dedicated custom policies.

To create a policy that permits only background blur:

New-CsTeamsVideoFiltersPolicy -Identity "Restricted-BlurOnly" `
    -VideoFiltersMode BlurOnly `
    -Description "Allows background blur only; prohibits custom and default background images."

To create a strict policy that strips all video filters for high-security environments:

New-CsTeamsVideoFiltersPolicy -Identity "HighSecurity-NoFilters" `
    -VideoFiltersMode NoFilters `
    -Description "Completely disables all video filters, blur, and effects."

To create a standard corporate policy allowing blur and curated Microsoft default images while blocking custom user uploads:

New-CsTeamsVideoFiltersPolicy -Identity "Corporate-StandardBackgrounds" `
    -VideoFiltersMode BlurAndDefaultBackgrounds `
    -Description "Allows blur and default backgrounds; blocks user custom image uploads."

Modifying the Global Default Policy

If your organization decides as a blanket rule to prohibit user-uploaded custom backgrounds across the entire company, modify the Global policy directly:

Set-CsTeamsVideoFiltersPolicy -Identity Global `
    -VideoFiltersMode BlurAndDefaultBackgrounds

All users who do not have an explicit custom policy assigned will immediately inherit this baseline restriction.

Assigning Policies to Users and Security Groups

After creating video filter policies, assign them to individual staff members or security groups.

To assign a policy directly to a single user:

Grant-CsTeamsVideoFiltersPolicy -Identity "[email protected]" `
    -PolicyName "Restricted-BlurOnly"

To assign a policy dynamically across all members of an Entra ID (Azure AD) security group:

# Retrieve the Group Object ID
$Group = Get-AzADGroup -DisplayName "Legal and Compliance"

# Grant policy to group members with priority evaluation
New-CsGroupPolicyAssignment -GroupId $Group.Id `
    -PolicyType TeamsVideoFiltersPolicy `
    -PolicyName "Restricted-BlurOnly" `
    -Rank 1

To remove a direct policy assignment so a user reverts to the global default:

Grant-CsTeamsVideoFiltersPolicy -Identity "[email protected]" -PolicyName $null

Verifying Policy Propagation and Client Enforcement

To confirm that a user has been properly granted the target video filter policy:

Get-CsUserPolicyAssignment -Identity "[email protected]" |
    Where-Object { $_.PolicyType -eq "TeamsVideoFiltersPolicy" }

Once assigned, changes typically replicate to the Microsoft Teams desktop client and web app within several hours. Upon entering a meeting, restricted users will find that the background settings panel selectively hides unavailable options according to policy.

Deploying targeted video filter policies through CsTeamsVideoFiltersPolicy establishes corporate visual consistency, safeguards confidentiality, and eliminates distractions across organizational communications.