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

Creates a new collection of dial-in conferencing configuration settings. These settings determine how Microsoft Communications Server 2010 responds when users join or leave a dial-in conference. In particular, information is returned regarding whether or not participants are required to record their name when joining a conference, and how (or even if) the system announces that someone has joined or left the call.

Syntax

New-CSDialInConferencingConfiguration [-Identity <XdsIdentity>][-EntryExitAnnouncements <String>] [-EnableNameRecording <Boolean>] [-InMemory] [-Tenant <Guid>] [-LocalStore]  -[WhatIf] [-Confirm]

Parameters

Parameter Required Type Description

Identity

Required

XdsIdentity

Indicates the Identity of the dial-in conferencing configuration settings to be created. Because these settings can only be created at the site scope, use syntax similar to this, with the characters "site:" followed by the name of the site: -Identity site:Redmond.

Note that there can only be one set of dial-in conferencing configuration settings per site. The sample command will fail if a collection of settings with the Identity site:Redmond already exists.

EntryExitAnnouncementsType

Optional

String

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 he 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.

EntryExitAnnouncementsEnabledByDefault

Optional

Boolean

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.

EnableNameRecording

Optional

Boolean

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.

InMemory

Optional

DialInConferencingConfiguration object

Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet.

Force

Optional

SwitchParameter

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

LocalStore

Optional

SwitchParameter

WhatIf

Optional

SwitchParameter

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

Confirm

Optional

SwitchParameter

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. (Settings configured at the site scope take precedence over settings configured at the global 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.

Return Types

Creates new instances of the Microsoft.Rtc.Management.WriteableConfig.Settings.DialInConferencingSettings.DialInConferencingConfiguration object.

Examples

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

Copy Code
New-CSDialInConferencingConfiguration -Identity site:Redmond - EnableNameRecording $False

The command shown in Example 1 creates a new collection of dial-in conferencing configuration settings that are applied to the Redmond site (hence the Identity site:Redmond). In addition, the optional parameter –EnableNameRecording is included in order to set the EnableNameRecording property to False ($False).

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

Copy Code
$x = New-CSDialInConferencingConfiguration -Identity site:Redmond -InMemory
$x.EnableNameRecording = $False
Set-CSDialInConferencingConfiguration -Instance $x

In Example 2 the –InMemory parameter is used to create a new collection of dial-in conferencing configuration settings that, initially, exists only in memory. To do this, the example first calls New-CSDialInConferencingConfiguration, and the –InMemory, parameter to create a "virtual" settings collection that is stored in the variable $x. (Note that this collection is given the Identity site:Redmond.) After creating the virtual collection, line 2 is used to modify the value of the EnableNameRecording property. Finally, line 3 in the example calls Set-CSDialInConferencingConfiguration to transform the virtual configuration settings stored in $x into an actual collection of settings applied to the Redmond site.