Invoke-CsPoolFailBack

Invokes the failback process for a Skype for Business Server pool. Failback is used after a pool has failed over and the users of that pool have been "failed over" to a backup pool. (That simply means users who were signed on to the failed pool are automatically signed on to the backup pool.) When the failed pool has been restored, the fail back process signs the failed-over users back to their original pool. This cmdlet was introduced in Lync Server 2013.

Syntax

Invoke-CsPoolFailBack
      -PoolFqdn <Fqdn>
      [-Confirm]
      [-DisasterMode]
      [-Force]
      [-WaitTime <TimeSpan>]
      [-WhatIf]
      [-DatabaseCommandTimeoutInSeconds <Int32>]
      [-SkipDataVerification]
      [<CommonParameters>]

Description

The pool failover process provides a way for administrators to quickly restore service to users if the Registrar pool they have logged on to should suddenly become unavailable. If a pool fails, users will automatically be signed off from Skype for Business Server; if they immediately try to log back on, they will be redirected to their specified backup pool.

To restore service to these users, administrators can run the Invoke-CsPoolFailOver cmdlet against the pool that is not currently available. Doing this will allow users to sign on to Skype for Business Server using the designated backup pool, and give these users access to all Skype for Business Server services and functionality. Note that users will not be rehomed on the backup pool; they will simply be allowed to log on and make use of that pool until their home pool has been restored. For example, if Pool A fails, users will be able to log on to Pool B (with complete functionality) until Pool A has been restored.

When the failed pool is once more up and running, administrators can then run the Invoke-CsPoolFailBack cmdlet in order to "fail back" users of that pool. If a user is currently logged on to the backup pool then he or she will be redirected back to their home pool after service has been restored.

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

Examples

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

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

In Example 1, failback is invoked for the pool atl-cs-001.litwareinc.com.

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

-DatabaseCommandTimeoutInSeconds

The amount of time, in seconds, to wait for database commands to time out.

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

-DisasterMode

Enables administrators to invoke pool failback even if the backup pool is currently unavailable. When you use this parameter, data generated by the failed-over users on the backup pool will be lost.

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

-Force

Suppresses the display of any non-fatal error message that might arise 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

-PoolFqdn

Fully qualified domain name of the pool being failed back. For example:

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

The pool FQDN used during failback must be the same FQDN used during failover.

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

-SkipDataVerification

When included in a command, Invoke-CsPoolFailover will proceed with the failover operation without first verifying data integrity.

Type:SwitchParameter
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

-WaitTime

Specifies the maximum amount of time the cmdlet should wait before synching data. Time values must be express using the format hours:minutes:seconds; for example, the following syntax sets the wait time to 1 minute and 30 seconds (00 hours:01:minutes:30 seconds):

00:01:30

The default value is 15 seconds.

Type:TimeSpan
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

-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 Invoke-CsPoolFailBack cmdlet does not accept pipelined input.

Outputs

None.