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" -NoStartThis example marks the computer "atl-mcs-001.litwareinc.com" as available to the pool and enables the services, but does not start them.
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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-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: | Skype for Business Server 2015, Skype for Business Server 2019 |
-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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-SkipFabricHealthCheck
{{Fill SkipFabricHealthCheck Description}}
| 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 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 |
| 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: | Skype for Business Server 2015, Skype for Business Server 2019 |
Inputs
None. The Invoke-CsComputerFailBack cmdlet does not accept pipelined input.
Outputs
None.