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

Set-CsTeamsMeetingPolicy
   [[-Identity] <XdsIdentity>]
   [-AllowAnnotations <Boolean>]
   [-AllowAnonymousUsersToDialOut <Boolean>]
   [-AllowAnonymousUsersToJoinMeeting <Boolean>]
   [-AllowAnonymousUsersToStartMeeting <Boolean>]
   [-AllowAvatarsInGallery <Boolean>]
   [-AllowBreakoutRooms <Boolean>]
   [-AllowCarbonSummary <Boolean>]
   [-AllowCartCaptionsScheduling <String>]
   [-AllowChannelMeetingScheduling <Boolean>]
   [-AllowCloudRecording <Boolean>]
   [-AllowDocumentCollaboration <String>]
   [-AllowEngagementReport <String>]
   [-AllowExternalNonTrustedMeetingChat <Boolean>]
   [-AllowExternalParticipantGiveRequestControl <Boolean>]
   [-AllowImmersiveView <Boolean>]
   [-AllowIPAudio <Boolean>]
   [-AllowIPVideo <Boolean>]
   [-AllowLocalRecording <Boolean>]
   [-AllowMeetingCoach <Boolean>]
   [-AllowMeetNow <Boolean>]
   [-AllowMeetingReactions <Boolean>]
   [-AllowMeetingRegistration <Boolean>]
   [-AllowNDIStreaming <Boolean>]
   [-AllowNetworkConfigurationSettingsLookup <Boolean>]
   [-AllowOrganizersToOverrideLobbySettings <Boolean>]
   [-AllowOutlookAddIn <Boolean>]
   [-AllowPSTNUsersToBypassLobby <Boolean>]
   [-AllowParticipantGiveRequestControl <Boolean>]
   [-AllowPowerPointSharing <Boolean>]
   [-AllowPrivateMeetNow <Boolean>]
   [-AllowPrivateMeetingScheduling <Boolean>]
   [-AllowRecordingStorageOutsideRegion <Boolean>]
   [-AllowScreenContentDigitization <Boolean>]
   [-AllowSharedNotes <Boolean>]
   [-AllowTasksFromTranscript <String>]
   [-AllowTrackingInReport <Boolean>]
   [-AllowTranscription <Boolean>]
   [-AllowedUsersForMeetingContext <String>]
   [-AllowUserToJoinExternalMeeting <String>]
   [-AllowWatermarkCustomizationForCameraVideo <Boolean>]
   [-AllowWatermarkCustomizationForScreenSharing <Boolean>]
   [-AllowWatermarkForCameraVideo <Boolean>]
   [-AllowWatermarkForScreenSharing <Boolean>]
   [-AllowWhiteboard <Boolean>]
   [-AllowedStreamingMediaInput <String>]
   [-AttendeeIdentityMasking <String>]
   [-AudibleRecordingNotification <String>]
   [-AutoAdmittedUsers <String>]
   [-AutoRecording <String>]
   [-AutomaticallyStartCopilot <String>]
   [-BlockedAnonymousJoinClientTypes <List>]
   [-CaptchaVerificationForMeetingJoin <String>]
   [-ChannelRecordingDownload <String>]
   [-Confirm]
   [-ConnectToMeetingControls <String>]
   [-ContentSharingInExternalMeetings <String>]
   [-Copilot <String>]
   [-CopyRestriction <Boolean>]
   [-Description <String>]
   [-DesignatedPresenterRoleMode <String>]
   [-DetectSensitiveContentDuringScreenSharing <Boolean>]
   [-EnrollUserOverride <String>]
   [-ExplicitRecordingConsent <String>]
   [-ExternalMeetingJoin <String>]
   [-Force]
   [-InfoShownInReportMode <String>]
   [-IPAudioMode <String>]
   [-IPVideoMode <String>]
   [-LiveCaptionsEnabledType <String>]
   [-LiveInterpretationEnabledType <String>]
   [-LiveStreamingMode <String>]
   [-LobbyChat <String> ]
   [-MediaBitRateKb <UInt32>]
   [-MeetingChatEnabledType <String>]
   [-MeetingInviteLanguages <String>]
   [-NewMeetingRecordingExpirationDays <Int32>]
   [-NoiseSuppressionForDialInParticipants <String>]
   [-ParticipantNameChange <String>]
   [-PreferredMeetingProviderForIslandsMode <String>]
   [-QnAEngagementMode <String>]
   [-RecordingStorageMode <String>]
   [-RoomAttributeUserOverride <String>]
   [-RoomPeopleNameUserOverride <String>]
   [-ScreenSharingMode <String>]
   [-SmsNotifications <String>]
   [-SpeakerAttributionMode <String>]
   [-StreamingAttendeeMode <String>]
   [-TeamsCameraFarEndPTZMode <String>]
   [-Tenant <Guid>]
   [-UsersCanAdmitFromLobby <String>]
   [-VideoFiltersMode <String>]
   [-VoiceIsolation <String>]
   [-WatermarkForAnonymousUsers <String>]
   [-WatermarkForCameraVideoOpacity <Int32>]
   [-WatermarkForCameraVideoPattern <String>]
   [-WatermarkForScreenSharingOpacity <Int32>]
   [-WatermarkForScreenSharingPattern <String>]
   [-WhatIf]
   [-WhoCanRegister <String>]
   [<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 Set-CsTeamsMeetingPolicy cmdlet allows administrators to update existing meeting policies that can be assigned to particular users to control Teams features related to meetings.

Examples

EXAMPLE 1

Set-CsTeamsMeetingPolicy -Identity SalesMeetingPolicy -AllowTranscription $True

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

EXAMPLE 2

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

In Example 2, the Set-CsTeamsMeetingPolicy cmdlet is used to update 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 existing values.

EXAMPLE 3

Set-CsTeamsMeetingPolicy -Identity NonEVNetworkRoamingPolicy -AllowNetworkConfigurationSettingsLookup $True

In Example 3, the Set-CsTeamsMeetingPolicy cmdlet is used to update an existing meeting policy with the Identity NonEVNetworkRoamingPolicy. This policy will use all the existing values except one: AllowNetworkConfigurationSettingsLookup; in this example, we will fetch network roaming policy for the non-EV user with NonEVNetworkRoamingPolicy based on his current network location.

Parameters

-AllowAnnotations

This setting will allow admins to choose which users will be able to use the Annotation feature.

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

-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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowAnonymousUsersToJoinMeeting

Note

The experience for users is dependent on both the value of -DisableAnonymousJoin (the old tenant-wide setting) and -AllowAnonymousUsersToJoinMeeting (the new per-organizer policy). Please check /microsoftteams/meeting-settings-in-teams for details.

Determines whether anonymous users can join the meetings that impacted users organize. Set this to TRUE to allow anonymous users to join a meeting. Set this to FALSE to prohibit them from joining a meeting.

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

-AllowAvatarsInGallery

If admins disable avatars in 2D meetings, then users cannot represent themselves as avatars in the Gallery view. This does not disable avatars in Immersive view.

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

-AllowCarbonSummary

This setting will enable Tenant Admins to enable/disable the sharing of location data necessary to provide the end of meeting carbon summary screen for either the entire tenant or for a particular user. If set to True the meeting organizer will share their location to the client of the participant to enable the calculation of distance and the resulting carbon.

Note

Location data will not be visible to the organizer or participants in this case and only carbon avoided will be shown. If set to False then organizer location data will not be shown and no carbon summary screen will be displayed to the participants.

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

-AllowCartCaptionsScheduling

Determines whether a user can add a URL for captions from a Communications Access Real-Time Translation (CART) captioner for providing real time captions in meetings. Possible values are:

  • EnabledUserOverride, CART captions is available by default but a user can disable.
  • DisabledUserOverride, if you would like users to be able to use CART captions in meetings but by default it is disabled.
  • Disabled, if you'd like to not allow CART captions in meeting.
Type:String
Position:Named
Default value:DisabledUserOverride
Required:False
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowDocumentCollaboration

This setting will allow admins to choose which users will be able to use the Document Collaboration feature.

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

-AllowedStreamingMediaInput

Enables the use of RTMP-In in Teams meetings.

Possible values are:

  • <blank>
  • RTMP
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowedUsersForMeetingContext

This policy controls which users should have the ability to see the meeting info details on the join screen. 'None' option should disable the feature completely.

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

-AllowEngagementReport

Determines whether meeting organizers are allowed to download the attendee engagement report. Possible values are:

  • Enabled: allow the meeting organizer to download the report.
  • Disabled: disable attendee report generation and prohibit meeting organizer from downloading it.
  • ForceEnabled: enable attendee report generation and prohibit meeting organizer from disabling it.

If set to Enabled or ForceEnabled, only meeting organizers and co-organizers will get a link to download the report in Teams. Regular attendees will have no access to it.

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

-AllowExternalNonTrustedMeetingChat

This field controls whether a user is allowed to chat in external meetings with users from non trusted organizations.

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

-AllowImmersiveView

If admins have disabled avatars, this does not disable using avatars in Immersive view on Teams desktop or web. Additionally, it does not prevent users from joining the Teams meeting on VR headsets.

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

-AllowLocalRecording

This parameter is reserved for internal Microsoft use.

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

-AllowMeetingCoach

This setting will allow admins to allow users the option of turning on Meeting Coach during meetings, which provides users with private personalized feedback on their communication and inclusivity. If set to True, then users will see and be able to click the option for turning on Meeting Coach during calls. If set to False, then users will not have the option to turn on Meeting Coach during calls.

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

-AllowMeetingReactions

Set to false to disable Meeting Reactions.

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

-AllowMeetingRegistration

Controls if a user can create a webinar meeting. The default value is True.

Possible values:

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

-AllowNDIStreaming

This parameter enables the use of NDI technology to capture and deliver broadcast-quality audio and video over your network.

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

-AllowNetworkConfigurationSettingsLookup

Determines whether network configuration setting lookup can be made for users who are not Enterprise Voice enabled. It is used to enable Network Roaming policy.

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

-AllowOrganizersToOverrideLobbySettings

This parameter has been deprecated and currently has no effect.

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

-AllowPrivateMeetNow

This setting controls whether a user can start an ad hoc private meeting.

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

-AllowRecordingStorageOutsideRegion

Allows storing recordings outside of the region. All meeting recordings will be permanently stored in another region, and can't be migrated. This does not apply to recordings saved in OneDrive or SharePoint.

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

-AllowScreenContentDigitization

This parameter is reserved for internal Microsoft use.

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

-AllowSharedNotes

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

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

-AllowTasksFromTranscript

This policy setting allows for the extraction of AI-Assisted Action Items/Tasks from the Meeting Transcript.

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

-AllowTrackingInReport

This parameter is reserved for internal Microsoft use.

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

-AllowTranscription

Determines whether 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowUserToJoinExternalMeeting

Currently, this parameter has no effect.

Possible values are:

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

-AllowWatermarkForCameraVideo

This setting allows scheduling meetings with watermarking for video enabled.

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

-AllowWatermarkForScreenSharing

This setting allows scheduling meetings with watermarking for screen sharing enabled.

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

-AttendeeIdentityMasking

This setting will allow admins to enable or disable Masked Attendee mode in Meetings. Masked Attendee meetings will hide attendees' identifying information (e.g., name, contact information, profile photo).

Possible Values: Enabled: Hides attendees' identifying information in meetings. Disabled: Does not allow attendees' to hide identifying information in meetings

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

-AudibleRecordingNotification

The setting controls whether recording notification is played to all attendees or just PSTN users.

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

-AutoAdmittedUsers

Determines what types of participants will automatically be added to meetings organized by this user. Possible values are:

  • 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.
  • 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.
  • Everyone, if you'd like to admit anonymous users by default.
  • OrganizerOnly, if you would like that only meeting organizers can bypass the lobby.
  • EveryoneInCompanyExcludingGuests, if you would like meetings to place every external and guest users in the lobby but allow all other users in the company to join the meeting immediately.
  • InvitedUsers, if you would like that only meeting organizers and invited users can bypass the lobby.

This setting also applies to participants joining via a PSTN device (i.e. a traditional phone).

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

-AutomaticallyStartCopilot

Note

This feature has not been fully released yet, so the setting will have no effect.

This setting gives admins the ability to auto-start Copilot.

Possible values are:

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

-AutoRecording

This setting will enable Tenant Admins to turn on/off the auto recording feature.

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

-BlockedAnonymousJoinClientTypes

A user can join a Teams meeting anonymously using a Teams client or using a custom application built using Azure Communication Services. When anonymous meeting join is enabled, both types of clients may be used by default. This optional parameter can be used to block one of the client types that can be used.

The allowed values are ACS (to block the use of Azure Communication Services clients) or Teams (to block the use of Teams clients). Both can also be specified, separated by a comma, but this is equivalent to disabling anonymous join completely.

Type:List
Position:Named
Default value:Empty List
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CaptchaVerificationForMeetingJoin

Require a verification check for meeting join.

Possible values:

  • NotRequired, CAPTCHA not required to join the meeting
  • AnonymousUsersAndUntrustedOrganizations, Anonymous users and people from untrusted organizations must complete a CAPTCHA challenge to join the meeting.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ChannelRecordingDownload

Controls how channel meeting recordings are saved, permissioned, and who can download them.

Possible values:

  • Allow - Saves channel meeting recordings to a "Recordings" folder in the channel. The permissions on the recording files will be based on the Channel SharePoint permissions. This is the same as any other file uploaded for the channel.
  • Block - Saves channel meeting recordings to a "Recordings\View only" folder in the channel. Channel owners will have full rights to the recordings in this folder, but channel members will have read access without the ability to download.
Type:String
Position:Named
Default value:Allow
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectToMeetingControls

Allows external connections of thirdparty apps to Microsoft Teams

Possible values are:

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

-ContentSharingInExternalMeetings

This policy allows admins to determine whether the user can share content in meetings organized by external organizations. The user should have a Teams Premium license to be protected under this policy.

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

-Copilot

This setting allows the admin to choose whether Copilot will be enabled with a persisted transcript or a non-persisted transcript.

Possible values are:

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

-CopyRestriction

This parameter enables a setting that controls a meeting option which allows users to disable right-click or Ctrl+C to copy, Copy link, Forward message, and Share to Outlook for meeting chat messages.

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

-DetectSensitiveContentDuringScreenSharing

Allows the admin to enable sensitive content detection during screen share.

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

-EnrollUserOverride

Turn on/off Biometric enrollment Possible values are:

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

-ExplicitRecordingConsent

This setting will enable Tenant Admins to turn on/off Explicit Recording Consent feature.

Possible Values: Enabled: Turns on the Explicit Recording Consent feature. Disabled: Turns off the Explicit Recording Consent feature.

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

-ExternalMeetingJoin

Determines whether the user is allowed to join external meetings.

Possible values are:

  • EnabledForAnyone
  • EnabledForTrustedOrgs
  • Disabled
Type:String
Position:Named
Default value:EnabledForAnyone
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Identity

Specify the name of the policy being created.

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

-InfoShownInReportMode

This policy controls what kind of information get shown for the user's attendance in attendance report/dashboard.

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
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.

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

-LiveCaptionsEnabledType

Determines whether real-time captions are available for the user in Teams meetings. Set this to DisabledUserOverride to allow user to turn on live captions. Set this to Disabled to prohibit.

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

-LiveInterpretationEnabledType

Allows meeting organizers to configure a meeting for language interpretation, selecting attendees of the meeting to become interpreters that other attendees can select and listen to the real-time translation they provide. Possible values are:

  • DisabledUserOverride, if you would like users to be able to use interpretation in meetings but by default it is disabled.
  • Disabled, prevents the option to be enabled in Meeting Options.
Type:String
Position:Named
Default value:DisabledUserOverride
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiveStreamingMode

Determines whether you provide support for your users to stream their Teams meetings to large audiences through Real-Time Messaging Protocol (RTMP).

Possible values are:

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

-LobbyChat

Note

This feature has not been released yet and will have no changes if it is enabled or disabled.

Determines whether chat messages are allowed in the lobby.

Possible values are:

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

-MeetingChatEnabledType

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

Note

Due to a new feature rollout, in order to set the value of MeetingChatEnabledType to Disabled, you will need to also set the value of LobbyChat to disabled. e.g., Install-Module MicrosoftTeams -RequiredVersion 6.6.1-preview -Force -AllowClobber -AllowPrereleaseConnect-MicrosoftTeams Set-CsTeamsMeetingPolicy -Identity Global -MeetingChatEnabledType Disabled -LobbyChat Disabled

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

-MeetingInviteLanguages

Controls how the join information in meeting invitations is displayed by enforcing a common language or enabling up to two languages to be displayed.

Note

All Teams supported languages can be specified using language codes. For more information about its delivery date, see the roadmap (Feature ID: 81521).

The preliminary list of available languages is shown below:

ar-SA,az-Latn-AZ,bg-BG,ca-ES,cs-CZ,cy-GB,da-DK,de-DE,el-GR,en-GB,en-US,es-ES,es-MX,et-EE,eu-ES,fi-FI,fil-PH,fr-CA,fr-FR,gl-ES,he-IL,hi-IN,hr-HR,hu-HU,id-ID,is-IS,it-IT,ja-JP,ka-GE,kk-KZ,ko-KR,lt-LT,lv-LV,mk-MK,ms-MY,nb-NO,nl-NL,nn-NO,pl-PL,pt-BR,pt-PT,ro-RO,ru-RU,sk-SK,sl-SL,sq-AL,sr-Latn-RS,sv-SE,th-TH,tr-TR,uk-UA,vi-VN,zh-CN,zh-TW.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-NewMeetingRecordingExpirationDays

Specifies the number of days before meeting recordings will expire and move to the recycle bin. Value can be from 1 to 99,999 days. Value can also be -1 to set meeting recordings to never expire.

Note

You may opt to set Meeting Recordings to never expire by entering the value -1.

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

-NoiseSuppressionForDialInParticipants

Note

This feature has not been released yet and will have no changes if it is enabled or disabled.

Control Noises Supression Feature for PST legs joining a meeting.

Possible Values:

  • MicrosoftDefault
  • Enabled
  • Disabled
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams

-ParticipantNameChange

This setting will enable Tenant Admins to turn on/off participant renaming feature.

Possible Values: Enabled: Turns on the Participant Renaming feature. Disabled: Turns off the Participant Renaming feature.

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

-QnAEngagementMode

This setting enables Microsoft 365 Tenant Admins to Enable or Disable the Questions and Answers experience (Q+A). When Enabled, Organizers can turn on Q+A for their meetings. When Disabled, Organizers cannot turn on Q+A in their meetings. The setting is enforced when a meeting is created or is updated by Organizers. Attendees can use Q+A in meetings where it was previously added. Organizers can remove Q+A for those meetings through Teams and Outlook Meeting Options. Possible values: Enabled, Disabled

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

-RecordingStorageMode

This parameter can take two possible values:

  • Stream
  • OneDriveForBusiness

Note

The change of storing Teams meeting recordings from Classic Stream to OneDrive and SharePoint (ODSP) has been completed as of August 30th, 2021. All recordings are now stored in ODSP. This change overrides the RecordingStorageMode parameter, and modifying the setting in PowerShell no longer has any impact.

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

-RoomAttributeUserOverride

Possible values:

  • Off
  • Distinguish
  • Attribute
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RoomPeopleNameUserOverride

Enabling people recognition requires the tenant CsTeamsMeetingPolicy roomPeopleNameUserOverride to be "On" and roomAttributeUserOverride to be Attribute for allowing individual voice and face profiles to be used for recognition in meetings.

Note

In some locations, people recognition can't be used due to local laws or regulations. Possible values:

  • Off: No People Recognition option on Microsoft Teams Room (Default).
  • On: Policy value allows People recognition option on Microsoft Teams Rooms under call control bar.
Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SmsNotifications

Participants can sign up for text message meeting reminders.

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

-SpeakerAttributionMode

Determines if users are identified in transcriptions and if they can change the value of the Automatically identify me in meeting captions and transcripts setting.

Possible values:

  • Enabled: Speakers are identified in transcription.
  • EnabledUserOverride: Speakers are identified in transcription. If enabled, users can override this setting and choose not to be identified in their Teams profile settings.
  • DisabledUserOverride: Speakers are not identified in transcription. If enabled, users can override this setting and choose to be identified in their Teams profile settings.
  • Disabled: Speakers are not identified in transcription.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StreamingAttendeeMode

Controls if Teams uses overflow capability once a meeting reaches its capacity (1,000 users with full functionality).

Possible values are:

  • Disabled
  • Enabled

Set this to Enabled to allow up to 20,000 extra view-only attendees to join.

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

-TeamsCameraFarEndPTZMode

Possible values are:

  • Disabled
  • AutoAcceptInTenant
  • AutoAcceptAll
Type:String
Position:Named
Default value:Disabled
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UsersCanAdmitFromLobby

This policy controls who can admit from the lobby.

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

-VoiceIsolation

Determines whether you provide support for your users to enable voice isolation in Teams meeting calls.

Possible values are:

  • Enabled (default)
  • Disabled
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WatermarkForAnonymousUsers

Determines the meeting experience and watermark content of an anonymous user.

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

-WatermarkForCameraVideoOpacity

Allows the transparency of watermark to be customizable.

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

-WatermarkForCameraVideoPattern

Allows the pattern design of watermark to be customizable.

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

-WatermarkForScreenSharingOpacity

Allows the transparency of watermark to be customizable.

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

-WatermarkForScreenSharingPattern

Allows the pattern design of watermark to be customizable.

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

-WhoCanRegister

Controls the attendees who can attend a webinar meeting. The default is Everyone, meaning that everyone can register. If you want to restrict registration to internal accounts set the value to 'EveryoneInCompany'.

Possible values:

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

Inputs

System.Management.Automation.PSObject

Outputs

System.Object