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