Parameters

Microsoft Lync Server 2010 enables users to join conferences by dialing in over the telephone. Dial-in users are not able to view video or exchange instant messages with other conference attendees, but they are able to fully participate in the audio portion of the meeting.

In addition to being able to join a conference, users are also able to manage selected portions of that conference by using their telephone keypad. (The specific conference settings users can and cannot manage depend on whether or not the user is a presenter.) For example, by default users can press the 6 key on their keypad to mute or unmute themselves. Participants can privately play the names of all the other people attending the meeting, while presenters can do such things as mute and unmute all the meeting participants and enable or disable the announcement that is played any time someone joins or leaves a conference.

The ability to make selections like these using a telephone keypad is known as dual-tone multifrequency (DTMF) signaling: if you have ever dialed a phone number and been instructed to do something along the order of "Press 1 for English or press 2 for Spanish," then you have used DTMF signaling.

The Set-CsDialInConferencingDtmfConfiguration cmdlet enables you to modify the keys used to trigger the commands supported in a Lync Server 2010 dial-in conference.

When modifying the DTMF commands keep two things in mind. First, you can only use the numeric keys 0 through 9; any other keys that might be found on your keypad (such as the # key) are not allowed. There is one exception to that rule: the CommandCharacter parameter allows you to use only the asterisk key (*), or the pound key (#); you cannot assign a numeric value to the CommandCharacter parameter. However, all the other command parameters will only accept numeric values.

Second, commands must be assigned unique keys; for example, the 4 key cannot be used both to mute and unmute yourself and to lock and unlock a conference. That means that, when modifying the keys assigned to a command, you might want to swap the keys used by two different commands. For example, if you want to assign the 4 key to EnableDisableAnnouncementsCommand (default value: 9) you should, in the same command, assign the 9 key to AudienceMuteCommand.

To disable a command, set its value to Null ($Null).

Who can run this cmdlet: By default, members of the following groups are authorized to run the Set-CsDialInConferencingDtmfConfiguration cmdlet locally: RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDialInConferencingDtmfConfiguration"}

Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration object. Set-CsDialInConferencingDtmfConfiguration accepts pipelined instances of the dial-in conference DTMF configuration object.

Set-CsDialInConferencingDtmfConfiguration does not return a value or object. Instead, the cmdlet configures instances of the Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration object.

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

	Copy Code
Set-CsDialInConferencingDtmfConfiguration -Identity global -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9

The command shown in Example 1 swaps the keys assigned to the command for enabling and disabling announcements (default value: 9) and the command for muting and unmuting all participants (default value: 4) for the global DTMF settings. To do this two different parameters are used: EnableDisableAnnoucementsCommand, which is given the parameter value 4; and AudienceMuteCommand, which is given the value 9. Because no Identity is specified, these changes will affect the global DTMF settings.

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

	Copy Code
Set-CsDialInConferencingDtmfConfiguration -Identity site:Redmond -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9

The command shown in Example 2 is a variation of the command shown in the first example. In this case, however, the changes affect the DTMF settings that have the Identity site:Redmond.

-------------------------- Example 3 ------------------------

	Copy Code
Set-CsDialInConferencingDtmfConfiguration -Identity "site:Redmond" -PrivateRollCallCommand $Null

The command shown in Example 3 disables the roll call command (the ability to play back a list of all the people participating in the conference) for the Redmond site. To disable this command, the PrivateRollCallCommand parameter is included, with the parameter value set to $Null. This means that no keypad key will be associated with the command, which makes the command unavailable to users.

-------------------------- Example 4 ------------------------

	Copy Code
Get-CsDialInConferencingDtmfConfiguration -Filter "site:*" | Set-CsDialInConferencingDtmfConfiguration -PrivateRollCallCommand $Null

Example 4 is a variation on Example 3: in this example, the roll call command is disabled for all the DTMF settings configured at the site scope. To do this, the command first uses Get-CsDialInConferencingDtmfConfiguration and the Filter parameter to return a collection of all the settings configured at the site scope; the filter value "site:*" limits the returned data to those settings where the Identity begins with the characters "site:". This filtered collection is then piped to Set-CsDialInConferencingDtmfConfiguration, which sets the value of the PrivateRollCallCommand property to null ($Null).

Other Resources