Export (0) Print
Expand All
Collapse the table of content
Expand the table of content
Expand Minimize

Debug-CsAddressBookReplication

Skype for Business Server 2015
 

Topic Last Modified: 2015-03-27

Verifies replication between Active Directory and the Skype for Business Server 2015 Address book service. This cmdlet was introduced in Lync Server 2013.

Debug-CsAddressBookReplication [-DomainController <String>] [-User <String>] [-VerifyReplication <SwitchParameter>] [-AnalyzeFailures <SwitchParameter>] [-Force <SwitchParameter>] [-OutLoggerVariable <String>] [-OutVerboseVariable <String>] [-PoolFqdn <Fqdn>] [-StartDate <DateTime>] [-Tenant <Guid>] [-VerifyNormalization <SwitchParameter>]

The command shown in Example 1 verifies Address book replication for the current pool. To verify replication for a specified pool, include the PoolFqdn parameter followed by the fully qualified domain name of the pool to be verified.

Debug-CsAddressBookReplication

In Example 2, the User parameter is included when verifying Address book replication for the current pool. When the User parameter is included, additional related information is returned for the specified user.

Debug-CsAddressBookReplication -User "sip:kenmyer@litwareinc.com"

Example 3 uses the VerifyReplication parameter to make a change to the specified user account and then verify that this change can be successfully replicated to the Address Book.

Debug-CsAddressBookReplication -User "sip:kenmyer@litwareinc.com" -VerifyReplication 

The command shown in Example 4 uses the VerifyNormalization parameter to return information about user accounts where Address Book normalization rules could not be applied.

Debug-CsAddressBookReplication -VerifyNormalization

Address Book servers are intermediaries between Active Directory Domain Services (AD DS) and Microsoft 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.

The Debug-CsAddressBookReplication cmdlet enables administrators to verify that data is being replicated between Active Directory and Lync Server. Fully testing replication between Active Directory and the Address Book server can potentially be time-consuming and resource-intensive; because of that, it is recommended that Debug-CsAddressBookReplication only be used in troubleshooting scenarios. If you want to periodically "spot check" the functioning of your Address Book server you should use the Test-CsAddressBookService cmdlet and/or the Test-CsAddressBookWebQuery cmdlet instead.

Skype for Business Server Control Panel: The functions carried out by the Debug-CsAddressBookReplication cmdlet are not available in the Skype for Business Server Control Panel.

 

Parameter Required Type Description

AnalyzeFailures

Optional

System.Management.Automation.SwitchParameter

When included in a command, Debug-CsAddessBookReplication will return information about any SQL Server stored procedure errors (SprocExecuteErrors) associated with the Address Book. The returned data includes information about which stored procedure failed; when the procedure failed; and how many times the procedure has failed. Debug-CsAddressBookReplication will also return the SQL error code and provide the failed SQL statement. Among other things, that enables you to rerun the statement from within the SQL debugger.

DomainController

Optional

System.String

Enables you to specify a domain controller to connect to when verifying Address book replication. If this parameter is not included then the cmdlet will use the first available domain controller.

Force

Optional

System.Management.Automation.SwitchParameter

Suppresses the display of any non-fatal error message that might occur when running the command.

OutVerboseVariable

Optional

System.String

When present, detailed output from running the cmdlet will be stored in the specified variable. For example, to store output in a variable named $TestOutput use the following syntax

-OutVerboseVariable TestOutput

Do not prepend a $ character when specifying the variable name.

PoolFqdn

Optional

Microsoft.Rtc.Management.Deploy.Fqdn

Fully qualified domain name of the pool being checked. If this parameter is not included then the Debug-CsAddressBookReplication cmdlet will verify the current pool.

StartDate

Optional

System.DateTime

Indicates the earliest activity date for the errors returned by the AnalyzeFailures parameter. For example, if you set the start date to 3/1/2015 (Match 1, 2015, in U.S. English) any errors prior to that date (for example, errors recorded on February 21, 2015) will be excluded from the returned data.

Use the date-time formats specified by your Regional and Language Options settings when assigning values to the StartDate parameter.

Tenant

Optional

System.Guid

Globally unique identifier (GUID) of the Skype for Business Online tenant account for which address book replication is being verified. For example:

-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

You can return the tenant ID for each of your tenants by running this command:

Get-CsTenant | Select-Object DisplayName, TenantID

User

Optional

System.String

When included, returns detailed replication information for the specified user accounts. The user account to be verified can be specified by using the user’s SIP address, email address, or SamAccountName.

VerifyNormalization

Optional

System.Management.Automation.SwitchParameter

If specified, detailed information will be returned for any user accounts where Address book normalization failed. Normalization rules are used to convert phone numbers to the E.164 format used by Skype for Business Server 2015.

VerifyReplication

Optional

System.Management.Automation.SwitchParameter

When specified, the Debug-CsAddressBookReplication cmdlet will modify the specified user account in Active Directory and then verify that the changes are replicated to the Address book. Note that the user account modification is for testing purposes only, and will not actually change the property values of that account.

None. The Debug-CsAddressBookReplication cmdlet does not accept pipelined input.

The Debug-CsAddressBookReplication cmdlet returns instances of the Microsoft.Rtc.SyntheticTransactions.Activities.Database.AddressBookReplicationTaskOutput object.

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft