Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
New-CsTeamsMeetingPolicy
- Module:
- MicrosoftTeams PowerShell module
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.
Syntax
Default (Default)
New-CsTeamsMeetingPolicy
[-Identity] <XdsIdentity>
[-AIInterpreter <string>]
[-AllowAnonymousUsersToDialOut <Boolean>]
[-AllowAnonymousUsersToJoinMeeting <Boolean>]
[-AllowAnonymousUsersToStartMeeting <Boolean>]
[-AllowAnnotations <Boolean>]
[-AllowAvatarsInGallery <Boolean>]
[-AllowBreakoutRooms <String>]
[-AllowCartCaptionsScheduling <string>]
[-AllowChannelMeetingScheduling <Boolean>]
[-AllowCloudRecording <Boolean>]
[-AllowDocumentCollaboration <String>]
[-AllowedUsersForMeetingContext <String>]
[-AllowEngagementReport <String>]
[-AllowExternalNonTrustedMeetingChat <Boolean>]
[-AllowExternalParticipantGiveRequestControl <Boolean>]
[-AllowImmersiveView <Boolean>]
[-AllowIPAudio <Boolean>]
[-AllowIPVideo <Boolean>]
[-AllowLocalRecording]
[-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>]
[-AllowUserToJoinExternalMeeting <String>]
[-AllowWatermarkCustomizationForCameraVideo <Boolean>]
[-AllowWatermarkCustomizationForScreenSharing <Boolean>]
[-AllowWatermarkForCameraVideo <Boolean>]
[-AllowWatermarkForScreenSharing <Boolean>]
[-AllowWhiteboard <Boolean>]
[-AllowedStreamingMediaInput <String>]
[-AnonymousUserAuthenticationMethod <String>]
[-AttendeeIdentityMasking <String>]
[-AudibleRecordingNotification <String>]
[-AutoAdmittedUsers <String>]
[-AutomaticallyStartCopilot <String>]
[-BlockedAnonymousJoinClientTypes <List>]
[-CaptchaVerificationForMeetingJoin <String>]
[-ChannelRecordingDownload <String>]
[-ConnectToMeetingControls <String>]
[-Confirm]
[-ContentSharingInExternalMeetings <String>]
[-Copilot <String>]
[-CopyRestriction <Boolean>]
[-Description <String>]
[-DesignatedPresenterRoleMode <String>]
[-DetectSensitiveContentDuringScreenSharing <Boolean>]
[-EnrollUserOverride <String>]
[-ExplicitRecordingConsent <String>]
[-ExternalMeetingJoin <String>]
[-ExternalBotAccessMode <String>]
[-Force]
[-IPAudioMode <String>]
[-IPVideoMode <String>]
[-InfoShownInReportMode <String>]
[-InMemory]
[-LiveCaptionsEnabledType <String>]
[-LiveInterpretationEnabledType <String>]
[-LiveStreamingMode <String>]
[-LobbyChat <string>]
[-MediaBitRateKb <UInt32>]
[-MeetingChatEnabledType <String>]
[-MeetingInviteLanguages <String>]
[-NewMeetingRecordingExpirationDays <Int32>]
[-NoiseSuppressionForDialInParticipants <String>]
[-ParticipantNameChange <String>]
[-PasscodeComplexity <String>]
[-PreferredMeetingProviderForIslandsMode <String>]
[-PreventComplianceRecording <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>]
[-VoiceSimulationInInterpreter <string>]
[-WatermarkForAnonymousUsers <String>]
[-WatermarkForCameraVideoOpacity <Int64>]
[-WatermarkForCameraVideoPattern <String>]
[-WatermarkForScreenSharingOpacity <Int64>]
[-WatermarkForScreenSharingPattern <String>]
[-AllowedUsersForMeetingDetails <String>]
[-RealTimeText <String>]
[-ParticipantSlideControl <string>]
[-WhatIf]
[-WhoCanRegister <Object>]
[-EnableRecordingAndTranscriptionCustomMessage <Boolean>]
[-RecordingAndTranscriptionCustomMessageIdentifier <Guid>]
[<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.
Note
The AllowCarbonSummary parameter is no longer supported and blocked by the service, though it may appear in older documentation or scripts. It can no longer be set using this cmdlet.
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
-AIInterpreter
Applicable: Microsoft Teams
Note
This feature has not been released yet and will have no changes if it is enabled or disabled.
Enables the user to use the AI Interpreter related features
Possible values:
- Disabled
- Enabled
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowAnnotations
This setting will allow admins to choose which users will be able to use the Annotation feature.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | Boolean |
| Default value: | True |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowBreakoutRooms
Set to true to enable Breakout Rooms, set to false to disable the Breakout Rooms functionality.
Parameter properties
| Type: | Boolean |
| Default value: | True |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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 are available by default but you can disable them.
- DisabledUserOverride: If you would like users to be able to use CART captions in meetings but they are disabled by default.
- Disabled: If you do not want to allow CART captions in meetings.
Parameter properties
| Type: | String |
| Default value: | DisabledUserOverride |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowDocumentCollaboration
This setting will allow admins to choose which users will be able to use the Document Collaboration feature.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowedStreamingMediaInput
Enables the use of RTMP-In or SRT-In in Teams meetings, webinars or town halls.
Possible values are:
"" - this setting will not allow the user access to any streaming encoders.
RTMP - this setting will allow the user access to RTMP-In streaming encoders during a Teams meeting, webinar or town hall.
SRT - this setting will allow the user access to SRT-In streaming encoders during a Teams meeting, webinar or town hall.
RTMP, SRT - this setting will allow the user access to RTMP-In or SRT-In streaming encoders during a Teams meeting, webinar or town hall.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowedUsersForMeetingDetails
Controls which users should have ability to see the meeting info details on join screen. 'None' option should disable the feature completely.
Possible Values:
- UsersAllowedToByPassTheLobby: Users who are able to bypass lobby can see the meeting info details.
- Everyone: All meeting participants can see the meeting info details.
Parameter properties
| Type: | String |
| Default value: | UsersAllowedToByPassTheLobby |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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. ForceEnabled will enable attendee report generation and prohibit meeting organizer from disabling it.
Possible values:
- Enabled
- Disabled
- ForceEnabled
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowExternalNonTrustedMeetingChat
This field controls whether a user is allowed to chat in external meetings with users from non trusted organizations.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | Boolean |
| Default value: | True |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowLocalRecording
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowMeetingReactions
Set to false to disable Meeting Reactions.
Parameter properties
| Type: | Boolean |
| Default value: | True |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowMeetingRegistration
Controls if a user can create a webinar meeting. The default value is True.
Possible values:
- true
- false
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowMeetNow
Determines whether a user can start ad-hoc meetings in a channel. Set this to TRUE to allow a user to start ad-hoc meetings in a channel. Set this to FALSE to prohibit the user from starting ad-hoc meetings in a channel.
Parameter properties
| Type: | Boolean |
| Default value: | TRUE |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowNDIStreaming
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowNetworkConfigurationSettingsLookup
Determines whether network configuration setting lookups can be made by users who are not Enterprise Voice enabled. It is used to enable Network Roaming policies.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowOrganizersToOverrideLobbySettings
Set this parameter to true to enable Organizers to override lobby settings.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowPowerPointSharing
Determines whether Powerpoint sharing is allowed in a user's meetings. Set this to TRUE to allow. Set this to FALSE to prohibit
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowPrivateMeetNow
Determines whether a user can start ad-hoc meetings. Set this to TRUE to allow a user to start ad-hoc private meetings. Set this to FALSE to prohibit the user from starting ad-hoc private meetings.
Parameter properties
| Type: | Boolean |
| Default value: | TRUE |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowRecordingStorageOutsideRegion
Allow storing recording outside of region. All meeting recordings will be permanently stored in another region, and can't be migrated. For more info, see https://aka.ms/in-region.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowScreenContentDigitization
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowSharedNotes
Determines whether users are allowed to take shared notes. Set this to TRUE to allow. Set this to FALSE to prohibit
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowTasksFromTranscript
This policy setting allows for the extraction of AI-Assisted Action Items/Tasks from the Meeting Transcript.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowTrackingInReport
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowUserToJoinExternalMeeting
Possible values are:
- Enabled
- FederatedOnly
- Disabled
Parameter properties
| Type: | String |
| Default value: | Disabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowWatermarkCustomizationForCameraVideo
Allows the admin to grant customization permissions to a meeting organizer
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowWatermarkCustomizationForScreenSharing
Allows the admin to grant customization permissions to a meeting organizer
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowWatermarkForCameraVideo
This setting allows scheduling meetings with watermarking for video enabled.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowWatermarkForScreenSharing
This setting allows scheduling meetings with watermarking for screen sharing enabled.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AllowWhiteboard
Determines whether whiteboard is allowed in a user's meetings. Set this to TRUE to allow. Set this to FALSE to prohibit
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AnonymousUserAuthenticationMethod
Determines how anonymous users will be authenticated when joining a meeting.
Possible values are:
- OneTimePasscode, if you would like anonymous users to be sent a one time passcode to their email when joining a meeting
- None, if you would like to disable authentication for anonymous users joining a meeting
Parameter properties
| Type: | String |
| Default value: | OneTimePasscode |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AudibleRecordingNotification
The setting controls whether recording notification is played to all attendees or just PSTN users.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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).
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | String |
| Default value: | Disabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | List |
| Default value: | Empty List |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-CaptchaVerificationForMeetingJoin
Require a verification check for meeting join.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
-ConnectToMeetingControls
Allows external connections of thirdparty apps to Microsoft Teams
Possible values are:
Enabled Disabled
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | String |
| Default value: | EnabledWithTranscript |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-CopyRestriction
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.
Parameter properties
| Type: | Boolean |
| Default value: | TRUE |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | EveryoneUserOverride |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-DetectSensitiveContentDuringScreenSharing
Allows the admin to enable sensitive content detection during screen share.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableRecordingAndTranscriptionCustomMessage
Note
This feature has not been fully released yet, so the setting will have no effect. This policy controls whether custom strings can be shown for recording and transcription in user's Teams meetings. It need to work with RecordingAndTranscriptionCustomMessageIdentifier.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnrollUserOverride
Possible values are:
- Disabled
- Enabled
Parameter properties
| Type: | String |
| Default value: | Disabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ExplicitRecordingConsent
Set participant agreement and notification for Recording, Transcript, Copilot in Teams meetings.
Possible Values:
- Enabled: Explicit consent, requires participant agreement.
- Disabled: Implicit consent, does not require participant agreement.
- LegitimateInterest: Legitimate interest, less restrictive consent to meet legitimate interest without requiring explicit agreement from participants.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ExternalBotAccessMode
Controls how external third-party automated bots and meeting assistants are handled when they attempt to join meetings. This policy provides predictable behavior and helps organizers apply intentional control for bot participation.
Possible Values:
- AllowAllBots: Don't detect bots; allow them to join meetings directly.
- RequireApprovalWhenDetected: When detected, require approval before joining by routing detected bots to the meeting lobby. This is the default value.
- BlockDetectedBots: Block detected bots from joining meetings.
Parameter properties
| Type: | String |
| Default value: | RequireApprovalWhenDetected |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ExternalMeetingJoin
Possible values are:
- EnabledForAnyone
- EnabledForTrustedOrgs
- Disabled
Parameter properties
| Type: | String |
| Default value: | EnabledForAnyone |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Identity
Specify the name of the policy being created.
Parameter properties
| Type: | XdsIdentity |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-InfoShownInReportMode
This policy controls what kind of information get shown for the user's attendance in attendance report/dashboard.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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-.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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 (default)
- Enabled
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MediaBitRateKb
Determines the media bit rate for audio/video/app sharing transmissions in meetings.
Parameter properties
| Type: | UInt32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MeetingChatEnabledType
Specifies if users will be able to chat in meetings. Possible values are: Disabled, Enabled, and EnabledExceptAnonymous.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-MeetingInviteLanguages
Applicable: Microsoft Teams
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Note
You may opt to set Meeting Recordings to never expire by entering the value -1.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NoiseSuppressionForDialInParticipants
Applicable: Microsoft Teams
Note
This feature has not been released yet and will have no changes if it is enabled or disabled.
Control Noise Suppression Feature for PSTN legs joining a meeting.
Possible Values:
- MicrosoftDefault
- Enabled
- Disabled
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ParticipantSlideControl
Applicable: Microsoft Teams
Note
This feature has not been released yet and will have no changes if it is enabled or disabled.
Determines whether participants can give control of presentation slides during meetings scheduled by this user. Set the type of users you want to be able to give control and be given control of presentation slides in meetings. Users excluded from the selected group will be prohibited from giving control, or being given control, in a meeting.
Possible Values:
- Everyone: Anyone in the meeting can give or take control
- EveryoneInOrganization: Only internal AAD users and Multi-Tenant Organization (MTO) users can give or take control
- EveryoneInOrganizationAndGuests: Only those who are Guests to the tenant, MTO users, and internal AAD users can give or take control
- None: No one in the meeting can give or take control
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PasscodeComplexity
Applicable: Microsoft Teams
Controls whether meeting passcodes use the system‑default complexity or a reduced complexity using numeric‑only digits. When enabled, meetings scheduled by users to whom this policy applies will use 8‑digit numeric‑only passcodes. Changes apply only to meetings scheduled after the setting is enabled. Existing meetings are not affected. This setting is disabled by default.
Possible Values:
- Default: Alphanumeric passcodes with 8 characters (system default).
- NumericOnly: 8‑digit numeric‑only passcodes with lower complexity for meetings scheduled by users to whom this policy applies. Numeric‑only passcodes increase the risk of unauthorized access compared to the default setting and do not align with Microsoft’s recommended meeting security best practices.
Parameter properties
| Type: | String |
| Default value: | Default |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | TeamsAndSfb |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PreventComplianceRecording
Applicable: Microsoft Teams
Note
This feature has not been released yet and will have no changes if it is enabled or disabled.
Controls whether Compliance Recording (CR)-enabled users are blocked from joining meetings organized by the policy-assigned user. When set to None, no restriction is applied and compliance recording operates as configured for the tenant. When set to All, CR-enabled users are blocked from joining meetings organized by the policy-assigned user. This applies to both internal and external CR-enabled users (including federated and B2B guests). Anonymous and PSTN users are unaffected as they cannot be assigned compliance recording.
Possible values:
- None: Compliance recording is not prevented. The tenant's compliance recording configuration applies normally. This is the default value.
- All: CR-enabled users are blocked from joining meetings organized by the policy-assigned user. This applies to all CR-enabled users regardless of whether they are internal or external to the tenant.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-RealTimeText
Applicable: Microsoft Teams
Allows users to use real time text during a meeting, allowing them to communicate by typing their messages in real time.
Possible Values:
- Enabled: User is allowed to turn on real time text.
- Disabled: User is not allowed to turn on real time text.
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-RecordingAndTranscriptionCustomMessageIdentifier
Note
This feature has not been fully released yet, so the setting will have no effect. This attribute holds the unique identifier for the custom recording and transcription meeting message. It stores a GUID that points to the CustomMessage in TeamsCustomMessageConfiguration.
Parameter properties
| Type: | Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-RoomAttributeUserOverride
Possible values:
- Off
- Distinguish
- Attribute
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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:
- On
- Off
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SmsNotifications
Participants can sign up for text message meeting reminders.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SpeakerAttributionMode
Possible values:
- EnabledUserOverride
- Disabled
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-StreamingAttendeeMode
Possible values are:
- Disabled
- Enabled
Parameter properties
| Type: | String |
| Default value: | Enabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-TeamsCameraFarEndPTZMode
Possible values are:
- Disabled
- AutoAcceptInTenant
- AutoAcceptAll
Parameter properties
| Type: | String |
| Default value: | Disabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-UsersCanAdmitFromLobby
This policy controls who can admit from the lobby.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-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.
Parameter properties
| Type: | String |
| Default value: | AllFilters |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-VoiceIsolation
Determines whether you provide support for your users to enable voice isolation in Teams meeting calls.
Possible values are:
- Enabled (default)
- Disabled
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-VoiceSimulationInInterpreter
Applicable: Microsoft Teams
Note
This feature has not been released yet and will have no changes if it is enabled or disabled.
Enables the user to use the voice simulation feature while being AI interpreted.
Possible Values:
- Disabled
- Enabled
Parameter properties
| Type: | String |
| Default value: | Disabled |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-WatermarkForAnonymousUsers
Determines the meeting experience and watermark content of an anonymous user.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-WatermarkForCameraVideoOpacity
Allows the transparency of watermark to be customizable.
Parameter properties
| Type: | Int64 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-WatermarkForCameraVideoPattern
Allows the pattern design of watermark to be customizable.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-WatermarkForScreenSharingOpacity
Allows the transparency of watermark to be customizable.
Parameter properties
| Type: | Int64 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-WatermarkForScreenSharingPattern
Allows the pattern design of watermark to be customizable.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
-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
Parameter properties
| Type: | Object |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
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
Feedback
Was this page helpful?
