Commands › Microsoft Teams
New-CsTeamsEventsPolicy
This cmdlet allows you to create a new TeamsEventsPolicy instance and set its properties. Note that this policy is currently still in preview.
Quick start script
# New-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)
New-CsTeamsEventsPolicy -AllowEmailEditing <String> -AllowTownhalls <String> -AllowWebinars <String> -WhatIf
New-CsTeamsEventsPolicy -AllowEmailEditing <String> -AllowTownhalls <String> -AllowWebinars <String>
# 4. Verify and diff
$after = Get-CsTeamsEventsPolicy
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
New-CsTeamsEventsPolicy [-Identity] <String> [-AllowWebinars <String>] [-AllowTownhalls <String>] [-ImmersiveEvents <String>] [-AllowEmailEditing <String>] [-Description <String>]
[-TownhallEventAttendeeAccess <String>] [-RecordingForTownhall <String>] [-RecordingForWebinar <String>]
[-TranscriptionForTownhall <String>] [-TranscriptionForWebinar <String>] [-AllowEventIntegrations <Boolean>] [-TownhallChatExperience <String>]
[-UseMicrosoftECDN <String>] [-EventAccessType <String>] [-BroadcastPremiumApps <String>] [-TownhallMaxResolution <String>] [-HighBitrateForTownhall <String>] [-AllowEngagementReport <String>]
[-InfoShownInReportMode <String>] [-Registration <String>] [-WhatIf] [-Confirm] [<CommonParameters>]Parameters (26)
| Parameter | Type | Required | What 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 governs which types of town halls can have their recordings published. | |
| -AllowedWebinarTypesForRecordingPublish | String | This setting governs which types of webinars can have their recordings published. | |
| -AllowEmailEditing | String | yes | This setting governs if a user is allowed to edit the communication emails in Teams Town Hall or Teams Webinar events. Possible values are: - **Enabled**: Enables editing of communication emails. - **Disabled**:... |
| -AllowEventIntegrations | Boolean | This setting governs the access to the integrations tab in the event creation workflow. | |
| -AllowTownhalls | String | yes | This setting governs if a user can create town halls using Teams Events. Possible values are: - **Enabled**: Enables creating town halls. - **Disabled**: Disables creating town hall. |
| -AllowWebinars | String | yes | This setting governs if a user can create webinars using Teams Events. Possible values are: - **Enabled**: Enables creating webinars. - **Disabled**: Disables creating webinars. |
| -BroadcastPremiumApps | String | This setting will enable Tenant Admins to specify if an organizer of a Teams Premium town hall may add an app that is accessible by everyone, including attendees, in a broadcast style Event including a Town hall.... | |
| -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. | |
| -EventAccessType | String | This setting governs which users can access the Town hall event and access the event registration page or the event site to register for a Webinar. It also governs which user type is allowed to join the session or... | |
| -Identity | String | yes | 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 a user's townhall. Possible values are: - **Enabled**: Allow recording in user's townhalls. - **Disabled**: Prohibit recording in user's townhalls. | |
| -RecordingForWebinar | String | Determines whether recording is allowed in a user's webinar. Possible values are: - **Enabled**: Allow recording in user's webinars. - **Disabled**: Prohibit recording in user's webinars. | |
| -TownhallChatExperience | String | This setting governs if the user can enable the Comment Stream chat experience for Townhalls. | |
| -TownhallEventAttendeeAccess | String | This setting governs what identity types may attend a Town hall that is scheduled by a particular person or group that is assigned this policy. Possible values are: - **Everyone**: Anyone with the join link may enter... | |
| -TranscriptionForTownhall | String | Determines whether transcriptions are allowed in a user's townhall. Possible values are: - **Enabled**: Allow transcriptions in user's townhalls. - **Disabled**: Prohibit transcriptions in user's townhalls. | |
| -TranscriptionForWebinar | String | Determines whether transcriptions are allowed in a user's webinar. Possible values are: - **Enabled**: Allow transcriptions in user's webinars. - **Disabled**: Prohibit transcriptions in user's webinars. | |
| -UseMicrosoftECDN | String | This setting governs whether the admin disables this property and prevents the organizers from creating town halls that use Microsoft eCDN even though they have been assigned a Teams Premium license. | |
| -TownhallMaxResolution | String | This policy sets the maximum video resolution supported in Town hall events. | |
| -HighBitrateForTownhall | String | This policy controls whether high-bitrate streaming is enabled for Town hall events. | |
| -AllowEngagementReport | String | Controls whether attendance and engagement reports are allowed for events. | |
| -InfoShownInReportMode | String | Controls what information is shown in attendance reports. | |
| -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. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.