Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
New-CsTeamsEventsPolicy
- Module:
- MicrosoftTeams PowerShell module
This cmdlet allows you to create a new TeamsEventsPolicy instance and set its properties. Note that this policy is currently still in preview.
Syntax
Default (Default)
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>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
TeamsEventsPolicy is used to configure options for customizing Teams Events experiences.
Examples
Example 1
PS C:\> New-CsTeamsEventsPolicy -Identity DisablePublicWebinars -AllowWebinars Enabled -EventAccessType EveryoneInCompanyExcludingGuests
The command shown in Example 1 creates a new per-user Teams Events policy with the Identity DisablePublicWebinars. This policy disables a user from creating public webinars.
Example 2
PS C:\> New-CsTeamsEventsPolicy -Identity DisableWebinars -AllowWebinars Disabled
The command shown in Example 2 creates a new per-user Teams Events policy with the Identity DisableWebinars. This policy disables a user from creating webinars.
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
-AllowedTownhallTypesForRecordingPublish
This setting governs which types of town halls 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
-AllowedWebinarTypesForRecordingPublish
This setting governs which types of webinars 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
-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: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowEventIntegrations
This setting governs the access to the integrations tab in the event creation workflow.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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 hall.
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
-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
-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
-EventAccessType
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 sessions in the event for both event types.
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: For Webinar - enables creating events to allow only in-tenant users to register and join the event. For Town hall - enables creating events to allow only in-tenant users to join the event (Note: for Town hall, in-tenant users include guests; this parameter will disable public Town halls).
Parameter properties
| Type: | String |
| Default value: | Everyone |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
-Identity
Unique identifier assigned to the Teams Events policy.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
-RecordingForTownhall
Determines whether recording is allowed in a user's townhall. Possible values are:
- Enabled: Allow recording in user's townhalls.
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-RecordingForWebinar
Determines whether recording is allowed in a user's webinar. Possible values are:
- Enabled: Allow recording in user's webinars.
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-TownhallChatExperience
This setting governs if the user can enable the Comment Stream chat experience for Townhalls.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
-TownhallMaxResolution
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.
- MicrosoftManaged: Town halls 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
-TranscriptionForTownhall
Determines whether transcriptions are allowed in a user's townhall. Possible values are:
- Enabled: Allow transcriptions in user's townhalls.
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-TranscriptionForWebinar
Determines whether transcriptions are allowed in a user's webinar. Possible values are:
- Enabled: Allow transcriptions in user's webinars.
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
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?