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

Parameters

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.

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

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