Set-CsOnlineDialInConferencingTenantSettings

Use the Set-CsOnlineDialInConferencingTenantSettings to modify the tenant level settings of dial-in conferencing. Dial-in conferencing tenant settings control the conference experience of users and manage some conferencing administrative functions.

Syntax

Set-CsOnlineDialInConferencingTenantSettings
   [-Tenant <Guid>]
   [-EnableEntryExitNotifications <Boolean>]
   [-EntryExitAnnouncementsType <EntryExitAnnouncementsType>]
   [-EnableNameRecording <Boolean>]
   [-IncludeTollFreeNumberInMeetingInvites <Boolean>]
   [-PinLength <UInt32>]
   [-AllowPSTNOnlyMeetingsByDefault <Boolean>]
   [-AutomaticallySendEmailsToUsers <Boolean>]
   [-SendEmailFromOverride <Boolean>]
   [-SendEmailFromAddress <String>]
   [-SendEmailFromDisplayName <String>]
   [-AutomaticallyReplaceAcpProvider <Boolean>]
   [-UseUniqueConferenceIds <Boolean>]
   [-AutomaticallyMigrateUserMeetings <Boolean>]
   [-MigrateServiceNumbersOnCrossForestMove <Boolean>]
   [-EnableDialOutJoinConfirmation <Boolean>]
   [[-Identity] <XdsIdentity>]
   [-MaskPstnNumbersType <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CsOnlineDialInConferencingTenantSettings
   [-Tenant <Guid>]
   [-EnableEntryExitNotifications <Boolean>]
   [-EntryExitAnnouncementsType <EntryExitAnnouncementsType>]
   [-EnableNameRecording <Boolean>]
   [-IncludeTollFreeNumberInMeetingInvites <Boolean>]
   [-PinLength <UInt32>]
   [-AllowPSTNOnlyMeetingsByDefault <Boolean>]
   [-AutomaticallySendEmailsToUsers <Boolean>]
   [-SendEmailFromOverride <Boolean>]
   [-SendEmailFromAddress <String>]
   [-SendEmailFromDisplayName <String>]
   [-AutomaticallyReplaceAcpProvider <Boolean>]
   [-UseUniqueConferenceIds <Boolean>]
   [-AutomaticallyMigrateUserMeetings <Boolean>]
   [-MigrateServiceNumbersOnCrossForestMove <Boolean>]
   [-EnableDialOutJoinConfirmation <Boolean>]
   [-Instance <PSObject>]
   [-MaskPstnNumbersType <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Dial-in conferencing tenant settings control what functions are available during a conference call. For example, whether or not entries and exits from the call are announced. The settings also manage some of the administrative functions, such as when users get notification of administrative actions, like a PIN change. By contrast, the higher level dial-in conferencing configuration only maintains a flag for whether dial-in conferencing is enabled for your organization. For more information, see Get-CsOnlineDialinConferencingTenantConfiguration.

There is always a single instance of the dial-in conferencing settings per tenant. You can modify the settings using Set-CsOnlineDialInConferencingTenantSettings and revert those settings to their defaults by using Remove-CsOnlineDialInConferencingTenantSettings.

The following parameters are not applicable to Teams: EnableDialOutJoinConfirmation, IncludeTollFreeNumberInMeetingInvites, MigrateServiceNumbersOnCrossForestMove, and UseUniqueConferenceIds

Examples

-------------------------- Example 1 --------------------------

Set-CsOnlineDialInConferencingTenantSettings -EnableEntryExitNotifications $True -EnableNameRecording $True -PinLength 7

This example sets the tenant's conferencing settings to enable entry and exit notifications supported by name recording. The PIN length is set to 7.

-------------------------- Example 2 --------------------------

Set-CsOnlineDialInConferencingTenantSettings -SendEmailFromOverride $true -SendEmailFromAddress admin@contoso.com -SendEmailFromDisplayName "Conferencing Administrator"

This example defines the contact information to be used in dial-in conferencing email notifications and enables the default address to be overridden.

Parameters

-AllowPSTNOnlyMeetingsByDefault

Specifies the default value that gets assigned to the "AllowPSTNOnlyMeetings" setting of users when they are enabled for dial-in conferencing, or when a user's dial-in conferencing provider is set to Microsoft. If set to $true, the "AllowPSTNOnlyMeetings" setting of the user will also be set to true. If $false, the user setting will be false. The default value for AllowPSTNOnlyMeetingsByDefault is $false.

When AllowPSTNOnlyMeetingsByDefault is changed, the value of the "AllowPSTNOnlyMeetings" setting of currently enabled users doesn't change. The new default value will only be applied to users that are subsequently enabled for dial-in conferencing, or whose provider is changed to Microsoft.

The "AllowPSTNOnlyMeetings" setting of a user defines if unauthenticated callers can start a meeting if they are the first person to join. An unauthenticated caller is defined as a participant who joins a meeting over the phone and doesn't provide the organizer PIN when joining the meeting.

For more information on the "AllowPSTNOnlyMeetings" user setting, see Set-CsOnlineDialInConferencingUser.

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

-AutomaticallyMigrateUserMeetings

PARAMVALUE: $true | $false

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

-AutomaticallyReplaceAcpProvider

PARAMVALUE: $true | $false

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

-AutomaticallySendEmailsToUsers

Specifies whether advisory emails will be sent to users when the events listed below occur. Setting the parameter to $true enables the emails to be sent, $false disables the emails. The default is $true.

User is enabled or disabled for dial-in conferencing.

The dial-in conferencing provider is changed either to Microsoft, or from Microsoft to another provider, or none.

The dial-in conferencing PIN is reset by the tenant administrator.

Changes to either the user's conference ID, or the user's default dial-in conference number.

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

-Confirm

The Confirm switch causes the command to pause processing and requires confirmation to proceed.

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

-EnableEntryExitNotifications

Specifies if, by default, announcements are made as users enter and exit a conference call. Set to $true to enable notifications, $false to disable notifications. The default is $true.

This setting can be overridden on a meeting by meeting basis when a user joins a meeting via a Skype for Business client and modifies the Announce when people enter or leave setting on the Skype Meeting Options menu of a meeting.

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

-EnableNameRecording

Specifies whether the name of a user is recorded on entry to the conference. This recording is used during entry and exit notifications. Set to $true to enable name recording, set to $false to bypass name recording. The default is $true.

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

-EntryExitAnnouncementsType

PARAMVALUE: UseNames | ToneOnly

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

-Force

The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force 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
Applies to:Microsoft Teams

-Identity

This parameter is reserved for internal Microsoft use.

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

-IncludeTollFreeNumberInMeetingInvites

This parameter is obsolete and not functional.

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

-Instance

Allows you to pass a reference to an object to the cmdlet rather than set individual parameter values.

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

-MaskPstnNumbersType

This parameter allows tenant administrators to configure masking of PSTN participant phone numbers in the roster view for Microsoft Teams meetings enabled for Audio Conferencing, scheduled within the organization.

Possible values are:

  • MaskedForExternalUsers (masked to external users)
  • MaskedForAllUsers (masked for everyone)
  • NoMasking (visible to everyone)
Type:String
Position:Named
Default value:MaskedForExternalUsers
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MigrateServiceNumbersOnCrossForestMove

PARAMVALUE: $true | $false

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

-PinLength

Specifies the number of digits in the automatically generated PINs. Organizers can enter their PIN to start a meeting they scheduled if they join via phone and are the first person to join. The minimum value is 4, the maximum is 12, and the default is 5.

A user's PIN will only authenticate them as leaders for a meeting they scheduled. The PIN of a user that did not schedule the meeting will not enable that user to lead the meeting.

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

-SendEmailFromAddress

Specifies the email address to use in the "From" contact information on emails that are sent to users to notify them of their dial-in conferencing settings, or when their settings change. The email address needs to be in the form <UserAlias>@<Domain>. For example, "KenMyer@Contoso.com" or "Admin@Contoso.com".

The SendEmailFromAddress value is used only if the SendEmailFromDisplayName setting is specified, and the SendEmailFromOverride setting is $true.

Note: The parameter has been deprecated and may be removed in future versions.

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

-SendEmailFromDisplayName

Specifies the display name to use in the "From" contact information on emails that are sent to users to notify them of their dial-in conferencing settings, or when their settings change.

The SendEmailFromDisplayName value is used only if the SendEmailFromDisplayName setting is specified, and the SendEmailFromOverride setting is $true.

Note: The parameter has been deprecated and may be removed in future versions.

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

-SendEmailFromOverride

Specifies if the contact information on dial-in conferencing notifications will be the default generated by Office 365, or administrator defined values. Setting SendEmailFromOverride to $true enables the system to use the SendEmailFromAddress and SendEmailFromDisplayName parameter inputs as the "From" contact information. Setting this parameter to $false will cause email notifications to be sent with the system generated default. The default is $false.

SendEmailFromOverride can't be $true if SendEmailFromAddress and SendEmailFromDisplayName aren't specified.

If you want to change the email address information, you need to make sure that your inbound email policies allow for emails that come from the address specified by the SendEmailFromAddress parameter.

Note: The parameter has been deprecated and may be removed in future versions.

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

-Tenant

This parameter is reserved for internal Microsoft use.

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

-UseUniqueConferenceIds

PARAMVALUE: $true | $false

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

-WhatIf

The WhatIf switch causes the command to simulate its results. By using this switch, you can view what changes would occur without having to commit those changes.

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

Inputs

None

Outputs

None.