Skip to content

TeamsMeetingConfiguration

Parameters

Parameter Attribute DataType Description Allowed Values
IsSingleInstance Key String Only valid value is 'Yes'. Yes
LogoURL Write String URL to a logo image. This would be included in the meeting invite. Please ensure this URL is publicly accessible for invites that go beyond your federation boundaries.
LegalURL Write String URL to a website containing legal information and meeting disclaimers. This would be included in the meeting invite. Please ensure this URL is publicly accessible for invites that go beyond your federation boundaries.
HelpURL Write String URL to a website where users can obtain assistance on joining the meeting.This would be included in the meeting invite. Please ensure this URL is publicly accessible for invites that go beyond your federation boundaries.
CustomFooterText Write String Text to be used on custom meeting invitations.
DisableAnonymousJoin Write Boolean Determines whether anonymous users are blocked from joining meetings in the tenant. Set this to TRUE to block anonymous users from joining. Set this to FALSE to allow anonymous users to join meetings.
DisableAppInteractionForAnonymousUsers Write Boolean Determines if anonymous users can interact with apps in meetings. Set to TRUE to disable App interaction.
EnableAttributedTranscripts Write Boolean Determines whether transcripts accessed through the Microsoft Graph API can include speaker attribution in the tenant. Set this to TRUE to allow speaker-attributed transcript formats and FALSE to block them. When FALSE, callers can still retrieve transcripts in an unattributed format.
EnableGraphTranscriptAccess Write Boolean Determines whether transcripts can be accessed through the Microsoft Graph API in the tenant. Set this to TRUE to allow the access and FALSE to block all Microsoft Graph API access to transcripts.
EnableQoS Write Boolean Determines whether Quality of Service Marking for real-time media (audio, video, screen/app sharing) is enabled in the tenant. Set this to TRUE to enable and FALSE to disable.
FeedbackSurveyForAnonymousUsers Write String Determines if anonymous participants receive surveys to provide feedback about their meeting experience. Set to Disabled to disable anonymous meeting participants to receive surveys. Set to Enabled to allow anonymous meeting participants to receive surveys. Possible values: Enabled, Disabled Disabled, Enabled
LimitPresenterRolePermissions Write Boolean When set to True, users within the Tenant will have their presenter role capabilities limited. When set to False, the presenter role capabilities will not be impacted and will remain as is.
PublishedEntraAuthenticationContexts Write MSFT_TeamsPublishedEntraAuthenticationContext[] List of Microsoft Entra ID authentication contexts that can be applied to Teams meetings for conditional access scenarios.
ReportMeeting Write String Determines whether users can report meetings they believe involve security risks, such as phishing, vishing or impersonation, through the Report a concern and Report as not a concern options in the meeting experience. Possible values are Enabled and Disabled. Disabled, Enabled
ClientAudioPort Write UInt32 Determines the starting port number for client audio. Minimum allowed value: 1024 Maximum allowed value: 65535 Default value: 50000.
ClientAudioPortRange Write UInt32 Determines the total number of ports available for client audio. Default value is 20.
ClientVideoPort Write UInt32 Determines the starting port number for client video. Minimum allowed value: 1024 Maximum allowed value: 65535 Default value: 50020.
ClientVideoPortRange Write UInt32 Determines the total number of ports available for client video. Default value is 20.
ClientAppSharingPort Write UInt32 Determines the starting port number for client screen sharing or application sharing. Minimum allowed value: 1024 Maximum allowed value: 65535 Default value: 50040.
ClientMediaPortRangeEnabled Write Boolean Determines whether custom media port and range selections need to be enforced. When set to True, clients will use the specified port range for media traffic. When set to False (the default value) for any available port (from port 1024 through port 65535) will be used to accommodate media traffic.
ClientAppSharingPortRange Write UInt32 Determines the total number of ports available for client sharing or application sharing. Default value is 20.
Credential Write PSCredential Credentials of the Teams Admin
ApplicationId Write String Id of the Azure Active Directory application to authenticate with.
TenantId Write String Name of the Azure Active Directory tenant used for authentication. Format contoso.onmicrosoft.com
CertificateThumbprint Write String Thumbprint of the Azure Active Directory application's authentication certificate to use for authentication.
CertificatePassword Write PSCredential Username can be made up to anything but password will be used for CertificatePassword
CertificatePath Write String Path to certificate used in service principal usually a PFX file.
ManagedIdentity Write Boolean Managed ID being used for authentication.
AccessTokens Write String[] Access token used for authentication.

Embedded Instances

MSFT_TeamsPublishedEntraAuthenticationContext

Parameters

Parameter Attribute DataType Description Allowed Values
Id Required String Identifier of the Microsoft Entra ID authentication context, from c1 to c99.
PublishedName Write String Name under which the authentication context is published to Teams meetings, up to 50 characters.
PublishedDescription Write String Description under which the authentication context is published to Teams meetings, up to 150 characters.

Description

This resource is used to configure the Teams Meeting Configuration.

More information: https://docs.microsoft.com/en-us/microsoftteams/meeting-settings-in-teams/

Permissions

Examples

Example 1

This examples sets the Teams Meeting Configuration.

Configuration Example
{
    param
    (
        [Parameter()]
        [System.String]
        $ApplicationId,

        [Parameter()]
        [System.String]
        $TenantId,

        [Parameter()]
        [System.String]
        $CertificateThumbprint
    )

    Import-DscResource -ModuleName Microsoft365DSC

    Node localhost
    {
        TeamsMeetingConfiguration 'TeamsMeetingConfiguration-Example'
        {
            IsSingleInstance                     = 'Yes'
            ClientAppSharingPort                 = 50040
            ClientAppSharingPortRange            = 20
            ClientAudioPort                      = 50000
            ClientAudioPortRange                 = 20
            ClientMediaPortRangeEnabled          = $True
            ClientVideoPort                      = 50020
            ClientVideoPortRange                 = 20
            CustomFooterText                     = "This is some custom footer text"
            DisableAnonymousJoin                 = $False
            EnableAttributedTranscripts          = $false
            EnableGraphTranscriptAccess          = $false
            EnableQoS                            = $False
            HelpURL                              = "https://contoso.com/teams/help"
            LegalURL                             = "https://contoso.com/teams/legal"
            LogoURL                              = "https://contoso.com/teams/logo.png"
            PublishedEntraAuthenticationContexts = @(
                MSFT_TeamsPublishedEntraAuthenticationContext{
                    Id                   = "c3"
                    PublishedName        = "Confidential meetings"
                    PublishedDescription = "Requires step-up authentication to join confidential meetings"
                }
            )
            ReportMeeting                        = "Enabled"
            ApplicationId                        = $ApplicationId
            TenantId                             = $TenantId
            CertificateThumbprint                = $CertificateThumbprint
        }
    }
}