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 events optimized for large audiences 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 events up to 1,000 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 their 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 an event optimized for large audiences using Teams Events.
Possible values are:
Enabled: Enables the Optimize for Large Audience option for organizers when scheduling an event.
Disabled: Disables the Optimize for Large Audience option for organizers scheduling an 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
-AllowWebinars
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: Disables creating events up to 1,000 attendees (previously 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 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 AI Producer and Custom Streaming Apps) that are only accessible by the Event group.
Please note, only certain apps, such as Polls, are supported for everyone in events optimized for large audiences.
Possible values are:
Enabled: An organizer of a broadcast style event can add Apps such as Polls
Disabled: An organizer of a broadcast style event CANNOT add Apps as Polls
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
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.
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 events optimized for a large audience.
Possible values are:
Enabled: Enables high bitrate for events optimized for a large audience.
Disabled: Disables high bitrate for events optimized for a large audience.
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
-RecordingForTownhall
Determines whether recording is allowed in an event optimized for a large audience.
Possible values are:
Enabled: Allow recording in events optimized for large audiences.
Disabled: Prohibit recording in events optimized for large audiences.
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 events up to 1,000 attendees.
Possible values are:
Enabled: Allow recording in events up to 1,000 attendees.
Disabled: Prohibit recording in events up to 1,000 attendees.
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 an event optimized for a large audience.
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 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:
Everyone: Anyone with the join link may enter or register for the event.
EveryoneInOrganizationAndGuests: Only those who are Guests to the tenant, MTO users, and internal AAD users may enter or register for 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
-TownhallMaxResolution
This policy sets the maximum video resolution supported in events optimized for a large audience.
Possible values are:
Max720p: Events optimized for a large audience support video resolution up to 720p.
Max1080p: Events optimized for a large audience support video resolution up to 1080p.
MicrosoftManaged: Events optimized for a large audience will support video resolution up to 720p except for those customers whose networks have been assessed by Microsoft to support up to 1080p."
Parameter properties
Type:
String
Default value:
MicrosoftManaged
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 events optimized for a large audience.
Possible values are:
Enabled: Allow transcriptions in events optimized for a large audience.
Disabled: Prohibit transcriptions in events optimized for a large audience.
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 events up to 1,000 attendees.
Possible values are:
Enabled: Allow transcriptions in events up to 1,000 attendees.
Disabled: Prohibit transcriptions in events up to 1,000 attendees.
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 events optimized for a large audience 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.
Inputs
None
Outputs
System.Object
Feedback
Was this page helpful?
No
Need help with this topic?
Want to try using Ask Learn to clarify or guide you through this topic?