EXAMPLE 1

The command show in Example 1 returns the DTMF settings for the Redmond site.

	Copy Code
Get-CsDialInConferencingDtmfConfiguration -Identity site:Redmond

EXAMPLE 2

Example 2 returns a collection of all the DTMF settings, and then, for each item in the collection, displays the value of the key to be pressed in order to privately play a description of DTMF commands. To do this, the Get-CsDialInConferencingDtmfConfiguration cmdlet is called in order to return a collection of all the property values for all the DTMF settings currently in use in the organization. That collection is then piped to the Select-Object cmdlet, which picks two properties (Identity and HelpCommand) to be displayed on the screen.

	Copy Code
Get-CsDialInConferencingDtmfConfiguration | Select-Object Identity, HelpCommand

EXAMPLE 3

The command shown in Example 3 returns all the DTMF settings that have been configured at the site scope. This is done by including the Filter parameter and the filter value "site:*". That filter value limits the returned data to settings that have an Identity that begins with the characters "site:". By definition, those are settings configured at the site scope.

	Copy Code
Get-CsDialInConferencingDtmfConfiguration -Filter "site:*"

EXAMPLE 4

Example 4 returns all the DTMF configuration settings where the AdmitAll property is not equal to 8 (the default value). To accomplish this task, the Get-CsDialInConferencingDtmfConfiguration cmdlet is first called without any parameters in order to return a collection of all the DTMF settings currently in use. This collection is then piped to the Where-Object cmdlet, which picks out only those settings where the AdmitAll property is not equal to 8.

	Copy Code
Get-CsDialInConferencingDtmfConfiguration | Where-Object {$_.AdmitAll -ne 8}

Lync Server 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/disable the announcement that is played any time someone joins or leaves a conference.

The ability to make selections 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 Get-CsDialInConferencingDtmfConfiguration cmdlet enables you to retrieve a list of all the available DTMF commands as well as the keys used to carry out those commands.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsDialInConferencingDtmfConfiguration cmdlet locally: RTCUniversalUserAdmins, 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 "Get-CsDialInConferencingDtmfConfiguration"}

None. The Get-CsDialInConferencingDtmfConfiguration cmdlet does not accept pipelined input.

The Get-CsDialInConferencingDtmfConfiguration cmdlet returns instances of the Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration object.