Topic Last Modified: 2010-12-06

Forces the specified Address Book servers to synchronize their contents with the User database.

Syntax

Update-CsAddressBook [-Fqdn <Fqdn>] [-Force <SwitchParameter>]

Parameters

Parameter Required Type Description

Fqdn

Optional

String

Enables you to specify an individual Address Book to be updated. If this parameter is not included then all of your Address Book servers will be synchronized with the User database. Individual Address Book servers should be referenced by their fully qualified domain name (FQDN); for example, atl-abs-001.litwareinc.com.

Detailed Description

Address Book servers are intermediaries between Active Directory 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 the information stored in the User database. By default, this synchronization takes place every five minutes. (However, that time interval can be modified by using the Set-CsAddressBookConfiguration cmdlet.)

If you can’t wait for synchronization to take place or if it appears that, for some reason, synchronization isn’t taking place, you can use the Update-CsAddressBook cmdlet to force an Address Book server to immediately synch with the user information stored in the User database.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Update-CsAddressBook 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 custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

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

Input Types

None. Update-CsAddressBook does not accept pipelined input.

Return Types

None. Instead, Update-CsAddressBook updates existing instances of the Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings object.

Example

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

Copy Code
Update-CsAddressBook

In Example 1, Update-CsAddressBook is called without any parameters. This synchronizes all the Address Book servers in the organization.

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

Copy Code
Update-CsAddressBook -Fqdn atl-abs-001.litwareinc.com

In Example 2, only a single Address Book server is synchronized: the server with the FQDN atl-abs-001.litwareinc.com.

See Also