How to Configure Teams Public Preview and Update Policies Using PowerShell CsTeamsUpdateManagementPolicy

Enterprise IT administrators must balance early feature validation against workforce operational stability when deploying Microsoft Teams client updates. Releasing unvetted pre-release builds or new UI paradigms to hundreds of general business users can generate unnecessary helpdesk tickets and disrupt core workflows. Conversely, suppressing early builds entirely prevents IT champions and helpdesk technicians from evaluating upcoming changes. Through the CsTeamsUpdateManagementPolicy cmdlets in the Microsoft Teams PowerShell module, administrators can deploy structured update rings—authorising designated pilot groups to access Teams Public Preview and Targeted Release features while keeping the broader organization on stable production channels.

Understanding Teams Client Update Rings and Public Preview

Microsoft Teams delivers new client software versions and user experience enhancements through staged release channels:

• Standard Production Ring: The general release channel receiving thoroughly validated features, bug fixes, and security patches.
• Targeted Release / Public Preview: An early validation ring where upcoming features (such as new meeting controls, AI Copilot capabilities, and UI refreshes) are accessible before general availability.
• Update Policy Modes: Administrators can completely disable Public Preview, allow users to opt-in manually via client settings, or automatically enforce the preview build for designated test pilot accounts.

Connecting to Microsoft Teams PowerShell

Managing update policies requires the Microsoft Teams PowerShell module (version 4.5.0 or higher) with Teams Administrator or Global Administrator privileges:

# Import the Teams PowerShell module and authenticate
Import-Module MicrosoftTeams
Connect-MicrosoftTeams

Confirm the availability of cmdlets dedicated to update management:

# Verify update management cmdlets
Get-Command *CsTeamsUpdateManagementPolicy*

Inspecting Default Update Management Policies

Retrieve the Global update management policy to inspect baseline settings applied to accounts across your tenant:

# Query the tenant Global update policy
Get-CsTeamsUpdateManagementPolicy -Identity Global

The policy exposes critical attributes:

• Identity: The unique identifier of the policy (e.g., Global or custom name).
• AllowPublicPreview: Dictates whether users are permitted to switch into the Public Preview channel. Supported values include Disabled, Enabled, and FollowOfficePreview.
• UpdatePolicy: Specifies the automated deployment ring, allowing administrators to push preview builds automatically or follow Microsoft 365 Apps update channels.

Creating Custom Update Management Policies for Pilot Rings

To establish an IT Pilot Ring where early adopters and IT support personnel automatically receive pre-release builds, provision a custom policy profile using New-CsTeamsUpdateManagementPolicy:

# Create an update policy that enables Public Preview for pilot users
New-CsTeamsUpdateManagementPolicy -Identity "IT-EarlyAdopters-Preview" `
    -AllowPublicPreview "Enabled" `
    -Description "Allows IT team and pilot users to opt into Microsoft Teams Public Preview"

For organizations aligning Teams updates with Microsoft 365 Apps Targeted Release (Office Insider), configure the policy to follow Office channel settings:

# Create policy aligning Teams updates with Office Preview channel
New-CsTeamsUpdateManagementPolicy -Identity "Follow-Office-Preview" `
    -AllowPublicPreview "FollowOfficePreview"

To strictly enforce stability across executive leadership, call centers, or critical trading desks, create an explicit lockdown policy:

# Create lockdown policy permanently blocking preview builds
New-CsTeamsUpdateManagementPolicy -Identity "Strict-Production-Only" `
    -AllowPublicPreview "Disabled"

Modifying Existing Update Management Policies

When enterprise rollout timelines shift or when broad testing is scheduled, update policy attributes using Set-CsTeamsUpdateManagementPolicy:

# Update policy settings to permit user opt-in
Set-CsTeamsUpdateManagementPolicy -Identity "IT-EarlyAdopters-Preview" `
    -AllowPublicPreview "Enabled"

# Verify policy modifications
Get-CsTeamsUpdateManagementPolicy -Identity "IT-EarlyAdopters-Preview" | Format-List Identity, AllowPublicPreview, Description

Assigning Update Policies to Users and Security Groups

Deploy custom update policies to individual pilot users or map them across Microsoft Entra ID security groups:

1. Assigning to an Individual User

# Grant preview policy to an IT administrator account
Grant-CsTeamsUpdateManagementPolicy -Identity "[email protected]" -PolicyName "IT-EarlyAdopters-Preview"

# Verify policy assignment on the target user
Get-CsUserPolicyAssignment -Identity "[email protected]" | Where-Object { $_.PolicyType -eq "TeamsUpdateManagementPolicy" }

2. Assigning to a Microsoft Entra ID Security Group

# Assign update policy to the IT Support and QA pilot group
Grant-CsTeamsUpdateManagementPolicy -Group "7c8e9f12-3a4b-5c6d-7e8f-9a0b1c2d3e4f" `
    -PolicyType TeamsUpdateManagementPolicy `
    -PolicyName "IT-EarlyAdopters-Preview" `
    -Rank 1

Activating Public Preview in the Microsoft Teams Client

Once an administrator grants the Enabled policy, the target user can activate the Public Preview channel directly from their desktop or web client:

1. In Microsoft Teams, click the Settings and more (…) button next to your profile avatar.
2. Navigate to About > Public preview.
3. Click Switch to public preview in the confirmation dialog.
4. Teams restarts into the Public Preview channel. A small letter “P” icon appears over the user profile avatar or in the About box, verifying preview engagement.

Revoking and Deleting Custom Update Policies

Before deleting a custom policy, disassociate it from active user accounts to revert them to the Global tenant baseline:

# Unassign custom policy from user
Grant-CsTeamsUpdateManagementPolicy -Identity "[email protected]" -PolicyName $null

# Delete the custom policy profile
Remove-CsTeamsUpdateManagementPolicy -Identity "IT-EarlyAdopters-Preview" -Confirm:$false

Deploying structured update rings via CsTeamsUpdateManagementPolicy ensures early feature readiness for IT operations while safeguarding operational continuity across the wider enterprise.