Topic Last Modified: 2013-02-22

Removes outdated information from the specified user store. "Outdated information" refers user data from a Registrar pool no longer paired with the specified user store. For example, suppose Pools A and B were once paired; now, however, that association has been changed, and Pools A and C are paired. When run against Pool A, the Remove-CsUserStoreBackupData cmdlet will remove information about users from Pool B. This cmdlet was introduced in Lync Server 2013.

Syntax

Remove-CsUserStoreBackupData -PoolFqdn <Fqdn> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Examples

Example 1

The command shown in Example 1 removes outdated user store information stored by the pool atl-cs-001.litwareinc.com and its associated backup pool.

Copy Code
Remove-CsUserStoreBackupData -PoolFqdn "atl-cs-001.litwareinc.com"

Detailed Description

Lync Server 2013 enables you to associate a pair of pools. When you do this, each pool maintains two sets of user information: information about the users homed on the pool in question and information about the users homed on the associated pool. Maintaining both sets of user information allows Pool B to register and service the users from Pool A should Pool A need to be failed over.

If you later change the association between these two pools, the "extra" user data is not automatically deleted from the two pools; for example, Pool A will continue to store user data for Pool B. (However, this data will no longer be updated and replicated.) The Remove-CsUserStoreBackupData cmdlet enables you to delete the data from Pool B that is no longer needed on Pool A.

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 "Remove-CsUserStoreBackupData"}

Lync Server Control Panel: The functions carried out by the Remove-CsUserStoreBackupData cmdlet are not available in the Lync Server Control Panel.

Parameters

Parameter Required Type Description

PoolFqdn

Required

Microsoft.Rtc.Management.Deploy.Fqdn

Fully qualified domain name of the pool where "outdated" user information should be removed. For example:

–PoolFqdn "atl-cs-001.litwareinc.com"

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command.

Force

Optional

System.Management.Automation.SwitchParameter

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

WhatIf

Optional

System.Management.Automation.SwitchParameter

Describes what would happen if you executed the command without actually executing the command.

Input Types

None. The Remove-CsUserStoreBackupData cmdlet does not accept pipelined input.

Return Types

None.

See Also