Edit

Share via

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>]
    [-MaxResolutionForTownhall <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

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-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

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-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

(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:Enabled
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-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

(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 hall.

Parameter properties

Type:String
Default value:Enabled
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
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:Enabled
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
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

-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 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

(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:True
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.

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.

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 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

(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.

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.

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: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

-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