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

Modifies settings that determine how Microsoft Communications Server 2010 responds when users join or leave a dial-in conference.


Set-CsDialInConferencingConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableNameRecording <$true | $false>] [-EntryExitAnnouncementsEnabledByDefault <$true | $false>] [-EntryExitAnnouncementsType <UseNames | ToneOnly>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingConfiguration [-Confirm [<SwitchParameter>]] [-EnableNameRecording <$true | $false>] [-EntryExitAnnouncementsEnabledByDefault <$true | $false>] [-EntryExitAnnouncementsType <UseNames | ToneOnly>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]


Parameter Required Type Description



Indicates the Identity of the dial-in conferencing configuration settings to be modified. To refer to the global settings, use this syntax: -Identity global. To refer to site settings, use syntax similar to this: -Identity site:Redmond. Note that you cannot use wildcards when specifying an Identity.



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



If set to True announcements will be played each time a participant enters or exits a conference. If set to False (the default value), entry and exit announcements will not be played.



Indicates the action taken by the system any time a participant enters or leaves a conference. Valid values are:

UseNames. The person's name is announced any time her or she enters or leaves a conference (e.g., "Ken Myer is exiting the conference").

ToneOnly. A tone is played any time a participant enters or leaves a conference.

The default value is UseNames.



Determines whether or not users are asked to record their name before entering the conference. Set to True ($True) to require name recording; set to False ($False) to skip name recording. The default value is True.


Switch Parameter

Suppresses the display of any non-fatal error message that might arise when running the command.


Switch Parameter

Describes what would happen if you executed the command without actually executing the command.


Switch Parameter

Prompts you for confirmation before executing the command.

Detailed Description

When users join (or leave) a dial-in conference, Communications Server 2010 can respond in different ways. For example, participants might be asked to record their name before they can enter the conference itself. Likewise, administrators can decide whether they want to have Communications Server announce that dial-in participants have either left or joined a conference.

These conference "join behaviors" are managed using dial-in conferencing configuration settings; these settings can be configured at the global scope or at the site scope. When you first install Communications Server 2010, the only dial-in conferencing configuration settings you will have are the ones at the global scope; however, you can create new settings at the site scope by using the New-CsDialInConfigurationSettings cmdlet. In addition, you can modify any of these configuration settings (at either the global or site scopes) by using the Set-CsDialInConfiguration cmdlet.

Return Types


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

Copy Code
Set-CsDialInConferencingConfiguration -Identity site:Redmond -EntryExitAnnouncementsType "ToneOnly"

The command shown in Example 1 modifies the EntryExitAnnoucements property for the dial-in configuration settings with the Identity site:Redmond. In this case, the EntryExitAnnouncementsType property is set to ToneOnly.

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

Copy Code
Get-CsDialInConferencingConfiguration | Set-CsDialInConferencingConfiguration -EnableNameRecording $True

Example 2 modifies all the dial-in conferencing configurations settings in use in the organization. To do this, the command first uses Get-CsDialInConferencingConfiguration to return all collection of all dial-in conferencing settings. That collection is then piped to Set-CsDialInConferencingConfiguration, which sets the EnableNameRecording property for each item in the collection to True ($True).

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

Copy Code
Get-CsDialInConferencingConfiguration -Filter "site:*" | Set-CsDialInConferencingConfiguration -EnableNameRecording $True -EntryExitAnnouncementsType "UseNames"

The preceding command modifies all the dial-in conferencing settings that have been configured at the site scope. To carry out this task, the command first uses Get-CsDialInConferencingConfiguration and the -Filter parameter to return a collection of all the settings configured at the site scope; the filter value "site:*" restricts returned data to settings that have an Identity beginning with the string value "site:". That filtered collection is then piped to Set-CsDialInConferencingConfiguration which, in turn, modifies the EnableNameRecording property and the EntryExitAnnouncementsType property for each item in the collection. When the command finishes running, all the dial-in conferencing settings configured at the site scope with have EnableNameRecording set to True and EntryExitAnnoucements set to "UseNames".