Parameters

Address Book servers are intermediaries between Active Directory Domain Services (AD DS) and Microsoft Lync Server 2010. The Address Book server ensures that the user information stored in Lync Server 2010 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 2010. 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 2010, 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"}

None. Get-CsAddressBookConfiguration does not accept pipelined input.

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

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

	Copy Code
Get-CsAddressBookConfiguration

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

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

	Copy Code
Get-CsAddressBookConfiguration -Identity site:Redmond

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

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

	Copy Code
Get-CsAddressBookConfiguration -Filter site:*

In the preceding 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:".

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

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

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

Other Resources