Invoke-CsComputerFailOver

Syntax

Invoke-CsComputerFailOver
      [[-ComputerName] <String>]
      [-Confirm]
      [-Force]
      [-NoStop]
      [-Report <String>]
      [-WaitTime <TimeSpan>]
      [-WhatIf]
      [-DrainingTimeout <TimeSpan>]
      [-SkipFabricHealthCheck]
      [<CommonParameters>]

Description

The Invoke-CsComputerFailOver cmdlet migrates the users and data, and drains the existing conferences and sessions before the Skype for Business services are stopped and disabled to prevent accidental restart when computer is rebooted.

The Invoke-CsComputerFailOver 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-CsComputerFailOver -ComputerName "atl-mcs-001.litwareinc.com" -Report "C:\Logs\S1_FailOverLog.html" -WaitTime 1:30:00

This example directs that the users assigned to server "atl-mcs-001.litwareinc.com" will be moved to other servers in the pool. The log output path is specified and the cmdlet will wait 1 hour 30 minutes before timing out.

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

$TimeSpan = New-TimeSpan -Minutes 30
Invoke-CsComputerFailOver -ComputerName "atl-mcs-001.litwareinc.com" -DrainingTimeout $TimeSpan

This example force to drain all conferences and sessions after 30 minutes. If users aren't moved to different front end after 30 minutes, it will drain all conferences and sessions and stop all services in the front end.

Parameters

Inputs

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

Outputs

None.

Related Links

• Invoke-CsComputerFailBack