New-CsTeamsMeetingPolicy

The CsTeamsMeetingPolicy cmdlets enable administrators to control the type of meetings that users can create or the features that they can access while in a meeting. It also helps determine how meetings deal with anonymous or external users.

Syntax

New-CsTeamsMeetingPolicy
   [-Tenant <Guid>]
   [-Description <String>]
   [-AllowChannelMeetingScheduling <Boolean>]
   [-AllowMeetNow <Boolean>]
   [-AllowIPVideo <Boolean>]
   [-IPAudioMode <String>]
   [-IPVideoMode <String>]
   [-AllowAnonymousUsersToDialOut <Boolean>]
   [-AllowAnonymousUsersToStartMeeting <Boolean>]
   [-AllowPrivateMeetingScheduling <Boolean>]
   [-AutoAdmittedUsers <String>]
   [-AllowCloudRecording <Boolean>]
   [-AllowOutlookAddIn <Boolean>]
   [-AllowPowerPointSharing <Boolean>]
   [-AllowParticipantGiveRequestControl <Boolean>]
   [-AllowExternalParticipantGiveRequestControl <Boolean>]
   [-AllowSharedNotes <Boolean>]
   [-AllowWhiteboard <Boolean>]
   [-AllowTranscription <Boolean>]
   [-MediaBitRateKb <UInt32>]
   [-ScreenSharingMode <String>]
   [-PreferredMeetingProviderForIslandsMode <String>]
   [-VideoFiltersMode <String>]
   [-Identity] <XdsIdentity>
   [-AllowEngagementReport <String>]
   [-AllowNDIStreaming <Boolean>]
   [-DesignatedPresenterRoleMode <String>]
   [-AllowPSTNUsersToBypassLobby <Boolean>]
    [-AllowIPAudio <Boolean>]
   [-AllowOrganizersToOverrideLobbySettings <Boolean>][-AllowUserToJoinExternalMeeting <String>]
   [-EnrollUserOverride <String>]
   [-StreamingAttendeeMode <String]
   [-AllowBreakoutRooms <String]
   [-TeamsCameraFarEndPTZMode <String>]
   [-AllowMeetingReactions <Boolean>]
   [-MeetingChatEnabledType <String>]
   [-InMemory]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The CsTeamsMeetingPolicy cmdlets enable administrators to control the type of meetings that users can create or the features that they can access while in a meeting. It also helps determine how meetings deal with anonymous or external users.

The New-CsTeamsMeetingPolicy cmdlet allows administrators to define new meeting policies that can be assigned to particular users to control Teams features related to meetings.

Examples

-------------------------- EXAMPLE 1 --------------------------

New-CsTeamsMeetingPolicy -Identity SalesMeetingPolicy -AllowTranscription $True

The command shown in Example 1 uses the New-CsTeamsMeetingPolicy cmdlet to create a new meeting policy with the Identity SalesMeetingPolicy. This policy will use all the default values for a meeting policy except one: AllowTranscription; in this example, meetings for users with this policy can include real time or post meeting captions and transcriptions.

-------------------------- EXAMPLE 2 --------------------------

New-CsTeamsMeetingPolicy -Identity HrMeetingPolicy -AutoAdmittedUsers "Everyone" -AllowMeetNow $False

In Example 2, the New-CsTeamsMeetingPolicy cmdlet is used to create a meeting policy with the Identity HrMeetingPolicy. In this example two different property values are configured: AutoAdmittedUsers is set to Everyone and AllowMeetNow is set to False. All other policy properties will use the default values.

Parameters

-AllowAnonymousUsersToDialOut

Determines whether anonymous users are allowed to dial out to a PSTN number. Set this to TRUE to allow anonymous users to dial out. Set this to FALSE to prohibit anonymous users from dialing out.

Note

This parameter is temporarily disabled.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowAnonymousUsersToStartMeeting

Determines whether anonymous users can initiate a meeting. Set this to TRUE to allow anonymous users to initiate a meeting. Set this to FALSE to prohibit them from initiating a meeting

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowBreakoutRooms

Set to true to enable Breakout Rooms, set to false to disable the Breakout Rooms functionality.

Type:Boolean
Position:Named
Default value:True
Accept pipeline input:False
Accept wildcard characters:False
-AllowChannelMeetingScheduling

Determines whether a user can schedule channel meetings. Set this to TRUE to allow a user to schedule channel meetings. Set this to FALSE to prohibit the user from scheduling channel meetings. Note this only restricts from scheduling and not from joining a meeting scheduled by another user.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowCloudRecording

Determines whether cloud recording is allowed in a user's meetings. Set this to TRUE to allow the user to be able to record meetings. Set this to FALSE to prohibit the user from recording meetings

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowEngagementReport

Determines whether users are allowed to download the attendee engagement report. Set this to Enabled to allow the user to download the report. Set this to Disabled to prohibit the user to download it.

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

Determines whether external participants can request or give control of screen sharing during meetings scheduled by this user. Set this to TRUE to allow the user to be able to give or request control. Set this to FALSE to prohibit an external user from giving or requesting control in a meeting

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowIPAudio

Determines whether audio is enabled in a user's meetings or calls. Set this to TRUE to allow the user to share their audio. Set this to FALSE to prohibit the user from sharing their audio.

Type:Boolean
Position:Named
Default value:True
Accept pipeline input:False
Accept wildcard characters:False
-AllowIPVideo

Determines whether video is enabled in a user's meetings or calls. Set this to TRUE to allow the user to share their video. Set this to FALSE to prohibit the user from sharing their video

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowMeetingReactions

Set to false to disable Meeting Reactions.

Type:Boolean
Position:Named
Default value:True
Accept pipeline input:False
Accept wildcard characters:False
-AllowMeetNow

Determines whether a user can start ad-hoc meetings. Set this to TRUE to allow a user to start ad-hoc meetings. Set this to FALSE to prohibit the user from starting ad-hoc meetings.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowNDIStreaming

This parameter is reserved for internal Microsoft use.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowOrganizersToOverrideLobbySettings

Set this parameter to true to enable Organizers to override lobby settings.

Type:Boolean
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-AllowOutlookAddIn

Determines whether a user can schedule Teams Meetings in Outlook desktop client. Set this to TRUE to allow the user to be able to schedule Teams meetings in Outlook client. Set this to FALSE to prohibit a user from scheduling Teams meeting in Outlook client

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowParticipantGiveRequestControl

Determines whether participants can request or give control of screen sharing during meetings scheduled by this user. Set this to TRUE to allow the user to be able to give or request control. Set this to FALSE to prohibit the user from giving, requesting control in a meeting

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowPowerPointSharing

Determines whether Powerpoint sharing is allowed in a user's meetings. Set this to TRUE to allow. Set this to FALSE to prohibit

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowPrivateMeetingScheduling

Determines whether a user can schedule private meetings. Set this to TRUE to allow a user to schedule private meetings. Set this to FALSE to prohibit the user from scheduling private meetings. Note this only restricts from scheduling and not from joining a meeting scheduled by another user

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowPSTNUsersToBypassLobby

Determines whether a PSTN user joining the meeting is allowed or not to bypass the lobby. If you set this parameter to True, PSTN users are allowed to bypass the lobby as long as an authenticated user is joined to the meeting.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowSharedNotes

Determines whether users are allowed to take shared notes. Set this to TRUE to allow. Set this to FALSE to prohibit

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowTranscription

Determines whether real-time and/or post-meeting captions and transcriptions are allowed in a user's meetings. Set this to TRUE to allow. Set this to FALSE to prohibit

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowUserToJoinExternalMeeting

Possible values are:

  • Enabled
  • FederatedOnly
  • Disabled
Type:String
Position:Named
Default value:Disabled
Accept pipeline input:False
Accept wildcard characters:False
-AllowWhiteboard

Determines whether whiteboard is allowed in a user's meetings. Set this to TRUE to allow. Set this to FALSE to prohibit

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AutoAdmittedUsers

Determines what types of participants will automatically be added to meetings organized by this user. Set this to EveryoneInCompany if you would like meetings to place every external user in the lobby but allow all users in the company to join the meeting immediately. Set this to Everyone if you'd like to admit anonymous users by default. Set this to EveryoneInSameAndFederatedCompany if you would like meetings to allow federated users to join like your company's users, but place all other external users in a lobby.

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

Prompts you for confirmation before running the cmdlet.

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

Enables administrators to provide explanatory text about the meeting policy. For example, the Description might indicate the users the policy should be assigned to.

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

Determines if users can change the default value of the Who can present? setting in Meeting options in the Teams client. This policy setting affects all meetings, including Meet Now meetings.

Possible values are:

  • EveryoneUserOverride: All meeting participants can be presenters. This is the default value. This parameter corresponds to the Everyone setting in Teams.
  • EveryoneInCompanyUserOverride: Authenticated users in the organization, including guest users, can be presenters. This parameter corresponds to the People in my organization setting in Teams.
  • EveryoneInSameAndFederatedCompanyUserOverride: Authenticated users in the organization, including guest users and users from federated organizations, can be presenters. This parameter corresponds to the People in my organization and trusted organizations setting in Teams.
  • OrganizerOnlyUserOverride: Only the meeting organizer can be a presenter and all meeting participants are designated as attendees. This parameter corresponds to the Only me setting in Teams.
Type:String
Position:Named
Default value:EveryoneUserOverride
Accept pipeline input:False
Accept wildcard characters:False
-EnrollUserOverride

Possible values are:

  • Disabled
  • Enabled
Type:String
Position:Named
Default value:Disabled
Accept pipeline input:False
Accept wildcard characters:False
-Force

Specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the switch isn't provided in the command, you're prompted for administrative input if required.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Identity

Specify the name of the policy being created.

Type:XdsIdentity
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InMemory

Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set-.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IPAudioMode

Determines whether audio can be turned on in meetings and group calls. Set this to ENABLEDOUTGOINGINCOMING to allow outgoing and incoming audio in the meeting. Set this to DISABLED to prohibit outgoing and incoming audio in the meeting.

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

Determines whether video can be turned on in meetings and group calls. Set this to ENABLEDOUTGOINGINCOMING to allow outgoing and incoming video in the meeting. Set this to DISABLED to prohibit outgoing and incoming video in the meeting. Invalid value combination IPVideoMode: EnabledOutgoingIncoming and IPAudioMode: Disabled

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

Determines the media bit rate for audio/video/app sharing transmissions in meetings.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MeetingChatEnabledType

Specify if users will be able to chat in meetings. Possible values are: Disabled, Enabled.

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

Determines the Outlook meeting add-in available to users on Islands mode. By default, this is set to TeamsAndSfb, and the users sees both the Skype for Business and Teams add-ins. Set this to Teams to remove the Skype for Business add-in and only show the Teams add-in.

Type:String
Position:Named
Default value:TeamsAndSfb
Accept pipeline input:False
Accept wildcard characters:False
-ScreenSharingMode

Determines the mode in which a user can share a screen in calls or meetings. Set this to SingleApplication to allow the user to share an application at a given point in time. Set this to EntireScreen to allow the user to share anything on their screens. Set this to Disabled to prohibit the user from sharing their screens.

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

Possible values are:

  • Disabled
  • Enabled
Type:String
Position:Named
Default value:Enabled
Accept pipeline input:False
Accept wildcard characters:False
-TeamsCameraFarEndPTZMode

Possible values are:

  • Disabled
  • AutoAcceptInTenant
  • AutoAcceptAll
Type:String
Position:Named
Default value:Disabled
Accept pipeline input:False
Accept wildcard characters:False
-Tenant

Globally unique identifier (GUID) of the tenant account whose external user communication policy are being created. For example:

-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

You can return your tenant ID by running this command:

Get-CsTenant | Select-Object DisplayName, TenantID

If you are using a remote session of Windows PowerShell and are connected only to Skype for Business Online you do not have to include the Tenant parameter. Instead, the tenant ID will automatically be filled in for you based on your connection information. The Tenant parameter is primarily for use in a hybrid deployment.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VideoFiltersMode

Determines the background effects that a user can configure in the Teams client. Possible values are:

  • NoFilters: No filters are available.
  • BlurOnly: Background blur is the only option available (requires a processor with AVX2 support, see Hardware requirements for Microsoft Teams for more information).
  • BlurAndDefaultBackgrounds: Background blur and a list of pre-selected images are available.
  • AllFilters: All filters are available, including custom images. This is the default value.
Type:String
Position:Named
Default value:AllFilters
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Inputs

None

Outputs

System.Object