In modern enterprise collaboration, large-scale broadcasts—such as company-wide all-hands meetings, executive updates, and technical keynotes—require robust streaming infrastructure and strict administrative controls. Microsoft Teams transitioned from legacy Live Events to Town Halls, delivering enhanced scalability (supporting up to 20,000 attendees), studio-grade RTMP ingest, and real-time attendee reactions. For Microsoft 365 administrators, governing who can schedule town halls, restricting external public attendance, and managing automated cloud recordings cannot be left to default tenant configurations. Using the Microsoft Teams PowerShell module, administrators can deploy and enforce granular event governance using CsTeamsEventsPolicy cmdlets.
Understanding Microsoft Teams Events Policies
Teams organizes large-scale broadcast administration under the CsTeamsEventsPolicy umbrella. This policy framework governs both Webinars and Town Halls across your tenant:
- Global (Org-Wide Default) Policy: The baseline policy automatically assigned to all licensed Microsoft 365 users in your organization unless overridden by a custom policy.
- Custom Per-User Policies: Explicit policies assigned to specific organizational units, departments (such as Corporate Communications), or individual executives granting expanded broadcast capabilities.
- Town Hall Controls: Governs whether users can schedule town halls (
AllowTownhalls), who can attend (EventAccessType), whether external anonymous guests can join, and whether live transcription and cloud recording are mandatory.
Connecting to Microsoft Teams PowerShell
To manage event policies, open an elevated PowerShell prompt and connect to the Microsoft Teams management endpoint using administrative credentials:
# Install the Microsoft Teams PowerShell module if required
Install-Module -Name MicrosoftTeams -Force -AllowClobber
# Authenticate to your Microsoft 365 tenant
Connect-MicrosoftTeams
Auditing Existing Teams Event Policies
Before implementing modifications, inspect the existing global policy and any custom event policies defined in the tenant:
# Query all Teams event policies
Get-CsTeamsEventsPolicy
# Inspect detailed town hall parameters in the Global policy
Get-CsTeamsEventsPolicy -Identity Global | Format-List Identity, AllowTownhalls, EventAccessType, AllowWebinars
Key configuration attributes include:
- AllowTownhalls: Dictates whether town hall creation is
EnabledorDisabled. - EventAccessType: Controls audience reach. Options include
Everyone(public access allowing external anonymous attendees) orEveryoneInCompanyExcludingGuests(internal corporate personnel only).
Hardening the Global Default Policy
In security-conscious organizations, default users should not possess the ability to create public-facing broadcasts that allow unauthenticated anonymous guests. Restrict the Global policy to internal-only attendance:
# Restrict the Global default policy to internal company personnel
Set-CsTeamsEventsPolicy -Identity Global `
-AllowTownhalls Enabled `
-EventAccessType EveryoneInCompanyExcludingGuests
Alternatively, if you wish to prevent standard users from organizing town halls entirely:
# Disable town hall creation for standard users
Set-CsTeamsEventsPolicy -Identity Global -AllowTownhalls Disabled
Creating a Custom Policy for Executive and Communications Teams
To grant designated departments (such as Executive Leadership or Internal Communications) the ability to host public town halls with external attendee support, create a dedicated custom policy:
# Create an executive town hall policy allowing public external access
New-CsTeamsEventsPolicy -Identity "Exec-TownHall-Public" `
-AllowTownhalls Enabled `
-EventAccessType Everyone `
-Description "Allows Executive and Comms teams to host public town halls"
Assigning Custom Policies to Users and Security Groups
Once created, assign the custom policy to specific organizers or Microsoft 365 security groups using the Grant-CsTeamsEventsPolicy cmdlet:
# Grant the policy to an individual organizer
Grant-CsTeamsEventsPolicy -Identity "[email protected]" -PolicyName "Exec-TownHall-Public"
# Grant the policy to an entire security group using its Azure AD Object ID
Grant-CsTeamsEventsPolicy -Group "a823d789-42b1-4f0e-bc21-0814981df983" -PolicyName "Exec-TownHall-Public" -Rank 1
Verifying User Policy Effective State
To confirm that a user has successfully inherited the intended event permissions:
# Inspect effective Teams policies assigned to a user
Get-CsUserPolicyAssignment -Identity "[email protected]" -PolicyType TeamsEventsPolicy
Policy changes propagate across Microsoft Teams desktop, web, and mobile clients within a few hours. Once active, the user will observe the appropriate Town Hall scheduling options within their Teams calendar interface.
Removing Custom Event Policies
To revert a user back to the default Global tenant policy or decommission an obsolete custom policy:
# Revert an individual user back to tenant default
Grant-CsTeamsEventsPolicy -Identity "[email protected]" -PolicyName $null
# Remove a custom policy from the tenant
Remove-CsTeamsEventsPolicy -Identity "Exec-TownHall-Public"