Reset-CsPoolRegistrarState

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]
     [-Force]
     [-MachineFqdn <Fqdn>]
     [-NoReStart]
     [-ResetLocalDatabases]
     [-ResetType <PoolResetType>]
     [-WhatIf]
     [-ServicesStopDelayMins <Int32>]
     [<CommonParameters>]

Description

The Reset-CsPoolRegistrarState cmdlet enables you to reset the Windows Fabric service (FabricHostSvc) and the Skype for Business 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.

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

Examples

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

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

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.

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

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

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.

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

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

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.

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

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

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.

Note that using the FullReset option when attempting to restart a pool will sometimes result in failure and the pool will not actually restart. Because of that, it is recommended that you first try to restart the pool using one of the other ResetType options. If that fails, please consult Microsoft support personnel before using the FullReset option.

-------------------------- Example 5 --------------------------

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

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.

Note that using the FullReset option when attempting to restart a pool will sometimes result in failure and the pool will not actually restart. Because of that, it is recommended that you first try to restart the pool using one of the other ResetType options. If that fails, please consult Microsoft support personnel before using the FullReset option.

Parameters

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-MachineFqdn

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

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-NoReStart

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-PoolFqdn

Fully qualified domain name of the Registrar pool being reset. For example:

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

Type:Fqdn
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-ResetLocalDatabases

When specified, stops and restarts the local Skype for Business Server databases in addition to the local Skype for Business Server services.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-ResetType

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 Skype for Business Server databases. This type of reset can be potentially long and resource-intensive.

    Using the FullReset value can cause previously disabled nodes to be reenabled. For example, if you use the FullReset value while one of the Front End Servers in the pool is disabled, that Front End Server will be brought back online.

    Using the FullReset value when attempting to restart a pool will sometimes result in failure and the pool will not actually restart. Because of that, it is recommended that you first try to restart the pool using one of the other ResetType options. If that fails, please consult Microsoft support personnel before using the FullReset option. Typically FullReset is only used when changing a topology from a pool with a single Front End server to a pool with multiple Front End servers.

  • 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.
Type:PoolResetType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-ServicesStopDelayMins

PARAMVALUE: Int32

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Inputs

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

Outputs

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