Invoke-CsComputerFailBack

Use the Invoke-CsComputerFailBack to flag a server as available for load balancing in a Skype for Business Server pool. To successfully run this cmdlet you need to run it using an account that has administrator privileges on each server in the source and target pools.

Syntax

Invoke-CsComputerFailBack
      [[-ComputerName] <String>]
      [-Confirm]
      [-NoStart]
      [-Report <String>]
      [-WaitTime <TimeSpan>]
      [-WhatIf]
      [-SkipFabricHealthCheck]
      [<CommonParameters>]

Description

The Invoke-CsComputerFailBack cmdlet functionality is not available in the Skype for Business Server Control Panel.

To return a list of all the Role-Based Access Control (RBAC) roles a cmdlet has been assigned to (including any custom RBAC roles you have created), run the following command from the Windows PowerShell prompt.

Get-CsAdminRole | Where-Object {$_.Cmdlets -Match "\<DesiredCmdletName\>"}

Examples

-------------------------- Example 1 -------------------------- (Skype for Business Server 2015)

Invoke-CsComputerFailBack -ComputerName "atl-mcs-001.litwareinc.com" -NoStart

This example marks the computer "atl-mcs-001.litwareinc.com" as available to the pool and enables the services, but does not start them.

Optional Parameters

-ComputerName

Specifies the computer name to fail back. The computer should be referenced by using its fully qualified domain name (FQDN). For example, -ComputerName "atl-mcs-001.litwareinc.com". The computer name used during failback must be the same name used during failover.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015
-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015
-NoStart

If the NoStart parameter is specified, the Skype for Business server is added back into the pool and marked as available, but all the Skype for Business services are not started. Only the Skype for Business service (rtcsrv) is verified by the cmdlet. This allows for follow-up scripting to start the remaining services and configure the server for your environment before users and data are assigned.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015
-Report

Specifies the file path for the log file created when the cmdlet runs. For example: -Report "C:\Logs\Server1FailbackLog.html". If this file already exists, it will be overwritten. By default, reports are written to the AppData\Local\Temp folder in your user profile.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015
-SkipFabricHealthCheck

{{Fill SkipFabricHealthCheck Description}}

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015
-WaitTime

Specifies the amount of time in TimeSpan format that the cmdlet will wait for a confirmation of failback success. If the time is exceeded, the cmdlet will fail and Skype for Business services will not be started or enabled. The default is one hour.

Type:TimeSpan
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015
-WhatIf

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

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

Inputs

None. The Invoke-CsComputerFailBack cmdlet does not accept pipelined input.

Outputs

None.