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>]
[-MediaBitRateKb <UInt32>]
[-MeetingChatEnabledType <String>]
[-MeetingInviteLanguages <String>]
[-NewMeetingRecordingExpirationDays <Int32>]
[-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 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.
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 |
-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.
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 |
-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 Particpant 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
- On
On - Policy value allows People recognition option on Microsoft Teams Rooms under call control bar.
Off - No People Recognition option on Microsoft Teams Room (Default).
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