User-level policy for tenant admin to configure options for customizing Teams events experiences. Use this cmdlet to update an existing policy.
Examples
Example 1
Set-CsTeamsEventsPolicy -Identity Global -AllowWebinars Disabled
The command shown in Example 1 sets the value of the Default (Global) Events Policy in the organization to disable webinars, and leaves all other parameters the same.
Parameters
-AllowedQuestionTypesInRegistrationForm
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.
Possible values are:
DefaultOnly, DefaultAndPredefinedOnly, AllQuestions.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AllowedTownhallTypesForRecordingPublish
This setting describes how IT admins can control which types of Town Hall attendees can have their recordings published.
Possible values are:
None, InviteOnly, EveryoneInCompanyIncludingGuests, Everyone.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AllowedWebinarTypesForRecordingPublish
This setting describes how IT admins can control which types of webinar attendees can have their recordings published.
Possible values are:
None, InviteOnly, EveryoneInCompanyIncludingGuests, Everyone.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AllowEmailEditing
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: Disables editing of communication emails.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AllowEventIntegrations
This setting governs access to the integrations tab in the event creation workflow.
Possible values
true, false.
Parameter properties
Type:
Boolean
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AllowTownhalls
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 halls.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AllowWebinars
This setting governs if a user can create webinars using Teams Events.
Possible values are:
Enabled: Enables creating webinars.
Disabled: Disables creating webinars.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-BroadcastPremiumApps
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. This does not include control over apps (such as AI Producer and Custom Streaming Apps) that are only accessible by the Event group.
Possible values are:
Enabled: An organizer of a Premium town hall can add a Premium App such as Polls to the Town hall
Disabled: An organizer of a Premium town hall CANNOT add a Premium App such as Polls to the Town hall
Parameter properties
Type:
String
Default value:
Enabled
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Confirm
The Confirm switch does not work with this cmdlet.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
cf
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Confirm
The Confirm switch does not work with this cmdlet.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
cf
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Description
Enables administrators to provide explanatory text to accompany a Teams Events policy.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Description
Enables administrators to provide explanatory text to accompany a Teams Events policy.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Description
Enables administrators to provide explanatory text to accompany a Teams Events policy.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-EventAccessType
Note
Currently, webinar and town hall event access is managed together via EventAccessType.
This setting governs which users can access the event registration page or the event site to register. It also governs which user type is allowed to join the session/s in the event.
Possible values are:
Everyone: Enables creating events to allow in-tenant, guests, federated, and anonymous (external to the tenant) users to register and join the event.
EveryoneInCompanyExcludingGuests: Enables creating events to allow only in-tenant users to register and join the event.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-HighBitrateForTownhall
This policy controls whether high-bitrate streaming is enabled for Town hall events.
Possible values are:
Enabled: Enables high bitrate for Town hall events.
Disabled: Disables high bitrate for Town hall events.
Parameter properties
Type:
String
Default value:
Disabled
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Identity
Unique identifier assigned to the Teams Events policy.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
1
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ImmersiveEvents
This setting governs if a user can create Immersive Events using Teams Events.
Possible values are:
Enabled: Enables creating Immersive Events.
Parameter properties
Type:
String
Default value:
Enabled
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-MaxResolutionForTownhall
This policy sets the maximum video resolution supported in Town hall events.
Possible values are:
Max720p: Town halls support video resolution up to 720p.
Max1080p: Town halls support video resolution up to 1080p.
Parameter properties
Type:
String
Default value:
Max1080p
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-RecordingForTownhall
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.
Parameter properties
Type:
String
Default value:
Enabled
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-RecordingForWebinar
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.
Parameter properties
Type:
String
Default value:
Enabled
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-TownhallChatExperience
This setting governs whether the user can enable the Comment Stream chat experience for Town Halls.
Possible values are: Optimized, None.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-TownhallEventAttendeeAccess
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 the event.
EveryoneInOrganizationAndGuests: Only those who are Guests to the tenant, MTO users, and internal AAD users may enter the event.
Parameter properties
Type:
String
Default value:
Everyone
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-TranscriptionForTownhall
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.
Parameter properties
Type:
String
Default value:
Enabled
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-TranscriptionForWebinar
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.
Parameter properties
Type:
String
Default value:
Enabled
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-UseMicrosoftECDN
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.
Parameter properties
Type:
Boolean
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-WhatIf
The WhatIf switch does not work with this cmdlet.
The cmdlet is not run.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
wi
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.