Get-CsDialInConferencingAccessNumber

Syntax

Get-CsDialInConferencingAccessNumber
   [[-Identity] <UserIdParameter>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-OU <OUIdParameter>]
   [-ResultSize <Microsoft.Rtc.Management.ADConnect.Core.Unlimited`1[System.UInt32]>]
   [<CommonParameters>]

Get-CsDialInConferencingAccessNumber
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-EmptyRegion]
   [-Filter <String>]
   [-OU <OUIdParameter>]
   [-ResultSize <Microsoft.Rtc.Management.ADConnect.Core.Unlimited`1[System.UInt32]>]
   [<CommonParameters>]

Get-CsDialInConferencingAccessNumber
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-OU <OUIdParameter>]
   [-Region <String>]
   [-ResultSize <Microsoft.Rtc.Management.ADConnect.Core.Unlimited`1[System.UInt32]>]
   [<CommonParameters>]

Description

Dial-in conferencing enables users to use any kind of telephone (such as a standard "land line", a mobile phone, or a Voice over Internet Protocol (VoIP) phone) to join the audio portion of an online conference. This enables users to 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 that takes place. However, they won't be 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 that users can call in order to be connected to a meeting. Dial-in conferencing access numbers are created by 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 Domain Services; this contact object is used to represent the access number and all its properties. Contact numbers can be retrieved by using the Get-CsDialInConferencingAccessNumber cmdlet.

If you have imported dial-in conferencing access numbers from Microsoft Office Communications Server 2007 these numbers will also be retrieved by running the Get-CsDialInConferencingAccessNumber cmdlet and including the Region parameter. (Imported numbers will not be displayed unless you use the Region parameter.) Note, however, that a warning message will be displayed alongside the imported number's Uniform Resource Identifiers (URIs). This is simply the way the cmdlet handles imported dial-in conferencing access numbers.

Examples

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

Get-CsDialInConferencingAccessNumber

The command shown in Example 1 returns a collection of all the dial-in conferencing access numbers configured for use in the organization. Calling the Get-CsDialInConferencingAccessNumber cmdlet without any additional parameters always returns a collection of all the available dial-in access numbers.

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

Get-CsDialInConferencingAccessNumber -Identity sip:RedmondDialIn@litwareinc.com

In Example 2, the dial-in conferencing access number with the Identity sip:RedmondDialIn@litwareinc.com is returned. Because identities must be unique, this command will never return more than one access number.

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

Get-CsDialInConferencingAccessNumber -Region "Redmond"

Example 3 uses the Region parameter to return all the dial-in conferencing access numbers associated with the Redmond region. To do this, the Get-CsDialInConferencingAccessNumber cmdlet is called along with the Region parameter. Specifying "Redmond" as the parameter value causes the Get-CsDialInConferencingAccessNumber cmdlet to return all the numbers where "Redmond" appears in the list of associated regions. For example, an access number that only listed Redmond as a region would be returned, as would an access number that listed both Redmond and Portland.

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

Get-CsDialInConferencingAccessNumber -Region $Null

Example 4 returns all the dial-in conferencing access numbers that are not associated with a region (that is, where the Regions property is empty).

-------------------------- Example 5 --------------------------

Get-CsDialInConferencingAccessNumber -Region site:USA/Redmond

The command shown in Example 5 returns all the dial-in conferencing access numbers for the Redmond region that have been scoped to the USA site (that is, the site with the SiteId site:USA).

-------------------------- Example 6 --------------------------

Get-CsDialInConferencingAccessNumber -Filter {DisplayName -like "*Seattle*"}

In Example 6, the Filter parameter is used in order to return a collection of all the dial-in conferencing access numbers that include the string value "Seattle" somewhere in their DisplayName. The filter value {DisplayName -like "Seattle"} limits the returned data to access numbers where the DisplayName includes the word "Seattle" (for example, Seattle Access Number; Dial-In Number for Seattle; Tacoma/Seattle Access Number; etc.).

-------------------------- Example 7 --------------------------

Get-CsDialInConferencingAccessNumber -Filter {LineUri -like "tel:+1425*"}

Example 7 returns all the dial-in conferencing access numbers where the line Uri begins with +1425; that effectively returns all the access numbers in the U.S. area code 425. To do this, the Get-CsDialInConferencingAccessNumber cmdlet is called along with the Filter parameter; the filter value {LineUri -like "tel:+1425*"} limits the returned data to line Uris that begin with the string value "tel:+1425". To return all the phone numbers for area code 425 or for the area code 206, use this filter value:

{LineUri -like "tel:+1425*" -or LineUri -like "tel:+1206*"}

-------------------------- Example 8 --------------------------

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "it-IT"}

Example 8 returns a collection of all the dial-in conferencing access numbers where the primary language is set to Italian. To carry out this task, the Get-CsDialInConferencingAccessNumber cmdlet is first called in order to return a collection of all the access numbers configured for use in the organization. This collection is then piped to the Where-Object cmdlet, which selects only those numbers where the PrimaryLanguage property is equal to Italian ("it-It").

-------------------------- Example 9 --------------------------

Get-CsDialInConferencingAccessNumber | Where-Object {$_.SecondaryLanguages -contains "fr-FR"}

The command shown in Example 9 returns all the dial-in conferencing access numbers where French is listed as one of the secondary languages. To accomplish this task, the Get-CsDialInConferencingAccessNumber cmdlet is first called without any parameters; that returns a complete collection of the access numbers configured for use in the organization. This collection is then piped to the Where-Object cmdlet, which selects only those numbers where the SecondaryLanguages property includes a listing for French (fr-FR).

Parameters

-Credential

-DomainController

-EmptyRegion

-Filter

-Identity

-OU

-Region

-ResultSize

Inputs

String

The Get-CsDialInConferencingAccessNumber cmdlet accepts a string value representing the Identity of the access number.

Outputs

Microsoft.Rtc.Management.Xds.AccessNumber

Related Links

• New-CsDialInConferencingAccessNumber
• Remove-CsDialInConferencingAccessNumber
• Set-CsDialInConferencingAccessNumber