New-CsTeamsEventsPolicy

Reference

Module:: MicrosoftTeamsPowerShell

This cmdlet allows you to create a new TeamsEventsPolicy instance and set its properties. Note that this policy is currently still in preview.

Syntax

New-CsTeamsEventsPolicy
   [-Identity] <String>
   [-AllowWebinars <String>]
   [-AllowTownhalls <String>]
   [-AllowEmailEditing <String>]
   [-Description <String>][-UseMicrosoftECDN <String>]
   [-EventAccessType <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

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

Type:	String
Position:	Named
Default value:	Enabled
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	Enabled
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	Enabled
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

The Confirm switch does not work with this cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Enables administrators to provide explanatory text to accompany a Teams Events policy.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	String
Position:	Named
Default value:	Everyone
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Identity

Unique identifier assigned to the Teams Events policy.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-UseMicrosoftECDN

This setting governs whether the global 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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

The WhatIf switch does not work with this cmdlet. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

None

Outputs

System.Object