Commands › Microsoft Teams

Set-CsTeamsEventsPolicy

Microsoft Teams MicrosoftTeams Set-*

This cmdlet allows you to configure options for customizing Teams events experiences. Note that this policy is currently still in preview.

Quick start script

# Set-CsTeamsEventsPolicy — 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-CsTeamsEventsPolicy
$before | Format-List

# 3. Make the change (dry run first)
Set-CsTeamsEventsPolicy  -WhatIf
Set-CsTeamsEventsPolicy

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

Syntax

Set-CsTeamsEventsPolicy [-AllowWebinars <String>] [-EventAccessType <String>] [-AllowTownhalls <String>] [-ImmersiveEvents <String>]
 [-TownhallEventAttendeeAccess <String>] [-AllowEmailEditing <String>] [-AllowedQuestionTypesInRegistrationForm <String>]
 [-AllowEventIntegrations <Boolean>] [-AllowedWebinarTypesForRecordingPublish <String>]
 [-AllowedTownhallTypesForRecordingPublish <String>] [-TownhallChatExperience <String>] [-Description <String>]
 [-RecordingForTownhall <String>] [-RecordingForWebinar <String>] [-TranscriptionForTownhall <String>] [-TranscriptionForWebinar <String>]
 [-UseMicrosoftECDN <Boolean>] [-BroadcastPremiumApps <String>] [-TownhallMaxResolution <String>] [-HighBitrateForTownhall <String>] [-AllowEngagementReport <String>]
 [-InfoShownInReportMode <String>] [-Registration <String>]

Parameters (29)

ParameterTypeRequiredWhat it controls
-AllowedQuestionTypesInRegistrationForm String This setting governs which users in a tenant can add which registration form questions to an event registration page for attendees to answer when registering for the event.
-AllowedTownhallTypesForRecordingPublish String This setting describes how IT admins can control which types of events optimized for large audiences can have their recordings published.
-AllowedWebinarTypesForRecordingPublish String This setting describes how IT admins can control which types of events up to 1,000 attendees can have their recordings published.
-AllowEmailEditing String This setting governs if a user is allowed to edit the communication emails in their events. Possible values are: - **Enabled**: Enables editing of communication emails. - **Disabled**: Disables editing of...
-AllowEventIntegrations Boolean This setting governs access to the integrations tab in the event creation workflow.
-AllowTownhalls String This setting governs if a user can create an event optimized for large audiences using Teams Events. Possible values are: - **Enabled**: Enables the **Optimize for Large Audience** option for organizers when...
-AllowWebinars String This setting governs if a user can create an event up to 1,000 attendees using Teams Events. Possible values are: - **Enabled**: Enables creating events up to 1,000 attendees (previously webinars). - **Disabled**:...
-BroadcastPremiumApps String This setting governs if an organizer of an event optimized for a large audience may add an app that is accessible by everyone, including attendees, to the event. This does not include control over apps (such as the...
-AllowEngagementReport String Controls whether attendance and engagement reports are allowed for events.
-InfoShownInReportMode String Controls what information is shown in attendance reports.
-Confirm SwitchParameter The Confirm switch does not work with this cmdlet.
-Confirm SwitchParameter The Confirm switch does not work with this cmdlet.
-Description String Enables administrators to provide explanatory text to accompany a Teams Events policy.
-Description String Enables administrators to provide explanatory text to accompany a Teams Events policy.
-Description String Enables administrators to provide explanatory text to accompany a Teams Events policy.
-EventAccessType String This setting governs which users can access the event registration page or the event site to register for events up to 1,000 attendees. It also governs which user type is allowed to join the session/s in the event....
-Identity String Unique identifier assigned to the Teams Events policy.
-ImmersiveEvents String This setting governs if a user can create Immersive Events using Teams Events. Possible values are: - **Enabled**: Enables creating Immersive Events. - **Disabled**: Disables creating Immersive Events.
-RecordingForTownhall String Determines whether recording is allowed in an event optimized for a large audience.
-RecordingForWebinar String Determines whether recording is allowed in events up to 1,000 attendees.
-TownhallChatExperience String This setting governs whether the user can enable the Comment Stream chat experience for an event optimized for a large audience.
-TownhallEventAttendeeAccess String This setting governs what identity types may attend or register for an event optimized for a large audience that is scheduled by a particular person or group that is assigned this policy. Possible values are: -...
-TranscriptionForTownhall String Determines whether transcriptions are allowed in a events optimized for a large audience.
-TranscriptionForWebinar String Determines whether transcriptions are allowed in events up to 1,000 attendees.
-UseMicrosoftECDN Boolean This setting governs whether the admin disables this property and prevents the organizers from creating events optimized for a large audience that use Microsoft eCDN even though they have been assigned a Teams...
-TownhallMaxResolution String This policy sets the maximum video resolution supported in events optimized for a large audience.
-HighBitrateForTownhall String This policy controls whether high-bitrate streaming is enabled for events optimized for a large audience.
-Registration String This setting governs whether registration is enabled or disabled for events.
-WhatIf SwitchParameter The WhatIf switch does not work with this cmdlet. The cmdlet is not run.

Message Center changes mentioning this command

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.