[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Returns the DTMF (Dual Tone Multi-Frequency) signaling settings used for dial-in conferencing. DTMF enables users who dial in to a conference to control conference settings (such as muting and unmuting themselves or locking and unlocking the conference) by using the keypad on their telephone.

Syntax

Get-CsDialInConferencingDtmfConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDialInConferencingDtmfConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Parameters

Parameter Required Type Description

Identity

Optional

String

Indicates the unique identifier for the collection of DTMF settings you want to return. To refer to the global settings use this syntax: -Identity global. To refer to a collection configured at the site scope, use syntax similar to this: -Identity site:Redmond. Note that you cannot use wildcards when specifying an Identity. If you need to use wildcards then include the -Filter parameter instead.

If this parameter is not specified then Get-CsDialInConferencingDtmfConfiguration will return a collection of all the DTMF configuration settings in use in the organization.

Filter

Optional

String

Enables you to use wildcard characters in order to return a collection (or multiple collections) of DTMG configuration settings. To return a collection of all the settings configured at the site scope, use this syntax: -Filter site:*. To return a collection of all the settings that have the string value "EMEA" somewhere in their Identity (the only property you can filter on) use this syntax: -Filter *EMEA*.

LocalStore

Optional

Switch Parameter

Detailed Description

Microsoft Communications 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 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 like these using a telephone keypad is known as DTMF (dual-tone multi-frequency) 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.

Return Types

Get-CsDialInConferencingDtmfConfiguration returns instances of the Microsoft.Rtc.Management.WriteableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration object.

Examples

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

Copy Code
Get-CsDialInConferencingDtmfConfiguration -Identity site:Redmond

The command show in Example 1 returns the DTMF settings for the Redmond site. Because DTMF settings can only be configured at the global level you will never get back more than one set of property values.

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

Copy Code
Get-CsDialInConferencingDtmfConfiguration | Select-Object HelpCommand

Example 2 returns a collection of all the DTMF settings, then displays the value of the key to be pressed in order to privately play a description of DTMF commands. To do this, Get-CsDialInConferencingDtmfConfiguration 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 out a single property (HelpCommand) to be displayed on screen.

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

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

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.

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

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

The preceding command returns all the DTMF configuration settings where the AdmitAll property is not equal to 8 (the default value). To accomplish this task, Get-CsDialInConferencingDtmfConfiguration 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 (-ne) 8.