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

Returns dial-in conferencing access numbers categorized by their assigned scope: global; site, or service. Dial-in conferencing provides a way for users to use a "regular" telephone or cell phone (that is, a device on the Public Switched Telephone Network) to join the audio portion of an online conference. To take advantage of this capability, users must call a predefined dial-in conferencing access number.

Syntax

add-attachmentfilterentry -Name <String> -Type <ContentType | FileName> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

Identity

Optional

Xds Identity

Unique identifier indicating the scope where dial-in access conferencing numbers have been assigned. To return all the numbers assigned to the global scope use this syntax: -Identity global. To return all the numbers assigned to a site (such as the Redmond site) use syntax similar to this: -Identity "site:Redmond". To return all the numbers assigned to a particular service, use syntax similar to this: -Identity "service:UserServer:atl-cs-litwareinc.com".

Filter

Optional

String

Enables you to use wildcards to return one or more collections of dial-in conferencing access numbers. To return all the numbers that have been configured at the site scope, use this syntax: -Filter "site:*". To return all the numbers that have been configured at the service scope, use this

LocalStore

Optional

Switch Parameter

Detailed Description

Dial-in conferencing enables users to use any kind of telephone - a standard "land line", a cell phone, a Voice over IP phone, etc. - to join the audio portion of an online conference. This lets users participate in the meeting even if they do not have a computer or an Internet connection. Users have full audio capabilities: they can speak to other participants and hear everything they takes place. They just aren’t able to see shared slides, video feeds, or other visual elements.

In order to provide users with dial-in conferencing capabilities you must create dial-in conferencing access numbers: phone numbers users can call in order to be connected to a meeting. Dial-in conferencing access numbers are created using the New-CsDialInConferencingAccessNumber cmdlet. When you create a new dial-in conferencing access number, you are actually creating a new contact object in Active Directory; this contact object is used to represent the access number and all its properties. Contact numbers can be retrieved using the Get-CsDialInConferencingAccessNumber cmdlet.

When you use Get-CsDialInConferencingAccessNumber to return dial-in conferencing numbers you get detailed information regarding those numbers; what you don’t get back, however, is information about the scope that each of these numbers have been assigned to. (Dial-in conferencing numbers can be assigned to the global scope, the site scope, or to the UserServices service scope.) If you want information about the different scopes, and the dial-in numbers assigned to each of these scopes, use the Get-CsConferenceAccessNumberList cmdlet. This cmdlet returns dial-in conferencing numbers grouped by scope: global, site, service. By using the -Identity and the -Filter parameters, you can zero in on numbers that have been configured for a given site, service, or scope.

Return Types

Get-CsConferenceAccessNumberList returns instances of the Microsoft.Rtc.Management.WritableConfig.Settings.ConferenceAccessNumbers.ConferenceAccessNumberList object.

Examples

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

Copy Code
Get-CsConferenceAccessNumberList -identity "site:Redmond"

The preceding command returns all the dial-in conferencing access numbers that have been configured for the Redmond site.

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

Copy Code
Get-CsConferenceAccessNumberList | Select-Object -ExpandProperty ConferenceAccessNumber | Select-Object -ExpandProperty AccessNumber

Example 2 displays detailed information for all the dial-in conferencing access numbers configured for use in the organization, sorted by the scope to which those numbers are assigned. To do this, Get-CsConferenceAccessNumberList is first called without any parameters; this returns a complete collection of dial-in conferencing access number information. The retrieved data is then piped to the Select-Object, which uses the –ExpandProperty parameter to expand the value of the ConferenceAccessNumber property. (Expanding a property value enables you to access the properties of an embedded object object.) The expanded ConferenceAccessNumber properties are then piped to Select-Object, which then expands the values of the AccessNumber property. The net result: you see values such a Number and LineUri for all the dial-in conferencing access numbers used in your organization.

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

Copy Code
Get-CsConferenceAccessNumberList | Where-Object {$_.ConferenceAccessNumber -like "*Region=NorthAmerica*"} | Select-Object -ExpandProperty ConferenceAccessNumber | Select-Object -ExpandProperty AccessNumber

The command shown in Example 3 is a variation of the command shown in Example 2; in this case, however, dial-in conferencing access numbers are displayed only if those numbers are used in the North America region. To do this, the command first calls Get-CsConferenceAccessNumberList to return a collection of all the dial-in conferencing access numbers in the organization. This collection is then piped to the Where-Object cmdlet, which picks out only those numbers where the ConferenceAccessNumber property includes the characters "Region=NorthAmerica". The -like operator and the string value "*Region=NorthAmerica*" enable you to do wildcard filtering for the NorthAmerica region.

The filtered collection is then piped to Select-Object, which expands the ConferenceAccessNumber property. This expanded property is then piped to Select-Object a second time, which then expands the AccessNumber property.

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

Copy Code
Get-CsConferenceAccessNumberList | Where-Object {$_.ConferenceAccessNumber -notlike "*Region=NorthAmerica*"} | Select-Object -ExpandProperty ConferenceAccessNumber | Select-Object -ExpandProperty AccessNumber

In Example 4, dial-in conferencing access numbers are returned only if those numbers are not used in the NorthAmerica region. To carry out this task, the command first calls Get-CsConferenceAccessNumberList to return a collection of all the dial-in conferencing access numbers in the organization. This collection is then piped to the Where-Object cmdlet, which picks out only those numbers where the ConferenceAccessNumber property does not the characters "Region=NorthAmerica". Note that, in order to do a search like this - one in which you are looking for items that do not contain the target value - you must use the -notlike operator.

The filtered collection is then piped to Select-Object, which expands the ConferenceAccessNumber property. This expanded property is then piped to Select-Object a second time, which then expands the AccessNumber property.