New-CsTeamsEventsPolicy
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>][-RecordingForTownhall <String>]
[-RecordingForWebinar <String>][-TranscriptionForTownhall <String>]
[-TranscriptionForWebinar <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 EveryoneInCompanyExcludingGuestsThe 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 DisabledThe 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowedTownhallTypesForRecordingPublish
This setting governs which types of town halls can have their recordings published.
Possible values are: None, InviteOnly, EveryoneInCompanyIncludingGuests, Everyone.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowedWebinarTypesForRecordingPublish
This setting governs which types of webinars can have their recordings published.
Possible values are: None, InviteOnly, EveryoneInCompanyIncludingGuests, Everyone.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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 |
-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.
| Type: | String |
| Position: | Named |
| Default value: | Enabled |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | Enabled |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | Enabled |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | Enabled |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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