Topic Last Modified: 2013-02-20

Returns information about Address Book configuration settings. This cmdlet was introduced in Lync Server 2010.

Syntax

Get-CsAddressBookConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsAddressBookConfiguration [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>]

Examples

EXAMPLE 1

Example 1 returns information about all the Address Book configuration settings in use in your organization. This is the default behavior if you call the Get-CsAddressBookConfiguration cmdlet without any additional parameters.

Copy Code
Get-CsAddressBookConfiguration

EXAMPLE 2

Example 2 returns information for the Address Book configuration settings with the Identity site:Redmond.

Copy Code
Get-CsAddressBookConfiguration -Identity site:Redmond

EXAMPLE 3

In this example, the Filter parameter and the filter value "site:*" are used to return information about all the Address Book configuration settings that have been applied at the site scope. The supplied filter value returns information for all the Address Book settings that have an Identity that begins with the string value "site:".

Copy Code
Get-CsAddressBookConfiguration -Filter site:*

EXAMPLE 4

In Example 4, information is returned for all the Address Book configuration settings where the settings uses normalization rules when parsing phone numbers. To do this, the command first uses the Get-CsAddressBookConfiguration cmdlet to return a collection of all the Address Book settings in the organization. That collection is then piped to the Where-Object cmdlet, which selects only those settings where the UseNormalizationRules property is equal to True.

Copy Code
Get-CsAddressBookConfiguration | Where-Object {$_.UseNormalizationRules -eq $True}

Detailed Description

Address Book servers are intermediaries between Active Directory Domain Services and Lync Server. The Address Book server ensures that the user information stored in Lync Server is in synch with the user information stored in Active Directory. This is done by periodically synching Address Book files with information stored in the User database.

In addition, Address Book servers periodically generate index files that are downloaded to computers running Lync. When a user searches for contacts, he or she either search through these index files or search the Address Book index files stored in the Central Management store.

Address Book servers are governed using Address Book configuration settings; these settings determine such things as how often Address Book files are synchronized with the user database and how often these Address Book index files are generated. When you install Lync Server, a set of global Address Book settings is created for you. You can also create custom configuration settings that can be applied to individual sites. These settings, if they exist, apply to any Address Book servers operating in the site, and take precedence over the global settings.

You can use the Get-CsAddressBookConfiguration cmdlet to return information about any (or all) of the Address Book settings currently in use in your organization.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsAddressBookConfiguration cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAddressBookConfiguration"}

Parameters

Parameter Required Type Description

Filter

Optional

System.String

Enables you to use wildcard characters in order to return a collection (or multiple collections) of Address Book settings. For example, to return a collection of all the settings configured at the site scope, use this syntax: -Filter site:*. To return a collection of all the settings that have the string value "EMEA" somewhere in their Identity, use this syntax: -Filter *EMEA*.

Identity

Optional

Microsoft.Rtc.Management.Xds.XdsIdentity

Unique identifier for the collection of Address Book settings to be returned. To refer to the global settings, use this syntax: -Identity global. To refer to a collection configured at the site scope, use syntax similar to this: -Identity site:Redmond.

Note that you cannot use wildcards when specifying an Identity. If you need to use wildcards, then include the Filter parameter instead.

If this parameter is not specified, then the Get-CsAddressBookConfiguration cmdlet returns a collection of all the Address Book settings in use in the organization.

LocalStore

Optional

System.Management.Automation.SwitchParameter

Retrieves the Address Book configuration data from the local replica of the Central Management store rather than from the Central Management store itself.

Input Types

None. The Get-CsAddressBookConfiguration cmdlet does not accept pipelined input.

Return Types

The Get-CsAddressBookConfiguration cmdlet returns instances of the Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings object.

See Also