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 ServiceResetThe 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:$FalseExample 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 QuorumLossRecoveryIn 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 FullResetIn 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 -NoReStartExample 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.