Topic Last Modified: 2013-03-07

Resets the Registrar and Windows fabric services for the specified Registrar pool. This cmdlet was introduced in Lync Server 2013.

Syntax

Reset-CsPoolRegistrarState -PoolFqdn <Fqdn> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MachineFqdn <Fqdn>] [-NoReStart <SwitchParameter>] [-ResetLocalDatabases <SwitchParameter>] [-ResetType <ServiceReset | QuorumLossRecovery | FullReset | MachineStateRemoved>] [-WhatIf [<SwitchParameter>]]

Examples

Example 1

The command shown in Example 1 performs a service reset for the Registrar pool atl-cs-001.litwareinc.com. Note that, after issuing this command, you will be prompted as to whether or not you want to proceed with the service reset.

Copy Code
Reset-CsPoolRegistrarState -PoolFqdn "atl-cs-001.litwareinc.com" -ResetType ServiceReset

Example 2

Example 2 also performs a service reset for the Registrar pool atl-cs-001.litwareinc.com. In this case, however, the Confirm parameter has been included along with the parameter value $False (-Confirm:$False). This causes the confirmation prompt which generally appears when you call the Reset-CsPoolRegistrarState cmdlet to be suppressed. As a result, you will not be prompted as to whether or not you want to proceed with the service reset. Instead, the command will run as soon as you press ENTER.

Copy Code
Reset-CsPoolRegistrarState -PoolFqdn "atl-cs-001.litwareinc.com" -ResetType ServiceReset -Confirm:$False

Example 3

In Example 3, a quorum loss recovery reset is carried on the pool atl-cs-001.litwareinc.com. A quorum loss recovery is reset is typically used when the number of active Front End servers in a pool falls below the quorum state (that is, when fewer than 85% of the Front End servers in a pool are currently active). Note that only those services that are in a quorum loss will have to reload user data from the backup store. Other services will be unaffected by this command/

Copy Code
Reset-CsPoolRegistrarState -PoolFqdn "atl-cs-001.litwareinc.com" -ResetType QuorumLossRecovery

Example 4

In Example 4, a full reset is done for the pool atl-cs-001.litwareinc.com. In a full reset, the Front End and Windows Fabric services are stopped and a set of items (including the files LyncServer-MachineSet.xml and Settings.xml) are removed. After these items have been removed, the Front End and Windows Fabric services are restarted. The FullReset option is typically used after topology changes or it unrecoverable errors occur when a pool is started.

Copy Code
Reset-CsPoolRegistrarState -PoolFqdn "atl-cs-001.litwareinc.com" -ResetType FullReset

Example 5

Example 5 is a variation of the command shown in Example 4. In this case, however, the NoReStart parameter is included; this prevents the Reset-CsPoolRegistrarState cmdlet from restarting the services (such as the Windows Fabric service) that are stopped when the pool is reset. It will be up to administrators to manually restart these services.

Copy Code
Reset-CsPoolRegistrarState -PoolFqdn "atl-cs-001.litwareinc.com" -ResetType FullReset -NoReStart

Detailed Description

The Reset-CsPoolRegistrarState cmdlet enables you to reset the Windows Fabric service (FabricHostSvc) and the Lync Server Registrar service (RtcSrv) for a Registrar pool; this might be required if the pool has become non-responsive or fails to start. (Typically that means that the Registrar service will remain stuck in the Start Pending state.) Running this cmdlet will, by default, stop and then restart all the relevant services on the pool. However, you can use the NoReStart parameter to cause the Reset-CsPooRegistrarState cmdlet to stop those the services without restarting them. You can then choose to manually restart all (or some) of those services.

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 command-line interface prompt:

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

Lync Server Control Panel: The functions carried out by the Reset-CsPoolRegistrarState 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 Registrar pool being reset. 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 occur when running the command.

MachineFqdn

Optional

Microsoft.Rtc.Management.Deploy.Fqdn

Fully qualified domain name of the computer to be removed from the pool. This parameter is only used when performing a MachineStateRemoved reset.

NoReStart

Optional

System.Management.Automation.SwitchParameter

When specified, services (such as RtcSrv and FabricHostSvc) that are stopped when the cmdlet runs are not restarted.

ResetLocalDatabases

Optional

System.Management.Automation.SwitchParameter

When specified, stops and restarts the local Lync Server databases in addition to the local Lync Server services.

ResetType

Optional

Microsoft.Rtc.Management.Hadr.ResetPoolFabricStateCmdlet+PoolResetType

Type of reset to be performed. Allowed values are:

* ServiceReset – The RtcSrv and fabricHostSvc services are stopped and restarted. A service reset will be performed if the ResetType is not specified.

* QuorumLossRecovery – Reloads user data from the backup store for any routing groups currently in quorum loss. (A quorum loss occurs when neither a database nor its replicas are available.) Data not yet written to the database could be lost when you do this type of reset.

* FullReset – performs the same type of reset as QuorumLossRecovery but, in addition, rebuilds the local Lync Server databases. This type of reset can be potentially long and resource-intensive.

* MachineStateRemoved -- Removes the specified server from the pool. This type of reset should be used only when the server in question (or its databases) have been permanently lost.

WhatIf

Optional

System.Management.Automation.SwitchParameter

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

Input Types

None. The Reset-CsPoolRegistrarState cmdlet does not accept pipelined input.

Return Types

String values. The Reset-CsPoolRegistrarState cmdlet does not return objects.

See Also