Topic Last Modified: 2013-02-22

Invokes the process by which the Lync Server 2013 Central Management store is failed over. When the Central Management store is failed over the primary database will be replaced by either a pre-assigned mirror database or a specified backup database. This cmdlet was introduced in Lync Server 2013.

Syntax

Invoke-CsManagementServerFailover -BackupSqlServerFqdn <Fqdn> -Force <SwitchParameter> [-BackupMirrorSqlInstanceName <String>] [-BackupMirrorSqlServerFqdn <Fqdn>] [-BackupSqlInstanceName <String>] <COMMON PARAMETERS>
Invoke-CsManagementServerFailover [-Restore <SwitchParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Examples

Example 1

The command shown in Example 1 fails over the Central Management store for Lync Server 2013. In this case, the existing management store will be replaced by the RTC database instance found on the computer redmond-cs-001.litwareinc.com.

Copy Code
Invoke-CsManagementServerFailover -BackupSqlServerFqdn "redmond-cs-001.litwareinc.com" - BackupSqlInstanceName "RTC" -Force

Detailed Description

The Invoke-CsManagementServerFailover cmdlet enables administrators to "failover" the Central Managament Server (CMS). The Invoke-CsManagementServerFailover cmdlet provides two different methods for failing over the CMS: 1) you can failover to a specified backup instance of SQL Server, or, 2) you can failover to a preassigned mirror database. To failover to a specified backup instance, use the BackupSqlServerFqdn and BackupSqlInstanceName parameters. To failover to the mirror database, use the BackupMirrorSqlServerFqdn and BackupMirrorSqlInstanceName parameters.

To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell command-line interface prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Invoke-CsManagementServerFailover"}

Lync Server Control Panel: The functions carried out by the Invoke-CsManagementServerFailover cmdlet are not available in the Lync Server Control Panel.

Parameters

Parameter Required Type Description

BackupSqlServerFqdn

Optional

Microsoft.Rtc.Management.Deploy.Fqdn

Fully qualified domain name of the computer hosting the SQL Server backup database. This parameter is required if you are running the Invoke-CsManagementServerFailover cmdlet in disaster recovery mode.

Force

Optional

System.Management.Automation.SwitchParameter

Suppresses the display of any non-fatal error message that might occur when running the command. This parameter is required if you are running the Invoke-CsManagementServerFailover cmdlet in disaster recovery mode.

BackupMirrorSqlInstanceName

Optional

System.String

SQL Server instance for the mirror database.

BackupMirrorSqlServerFqdn

Optional

Microsoft.Rtc.Management.Deploy.Fqdn

Fully qualified domain name of the computer hosting the SQL Server mirror database.

BackupSqlInstanceName

Optional

System.String

SQL Server instance for the backup database.

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command.

Report

Optional

System.String

Enables you to specify a file path for the log file created when the cmdlet runs. For example: -Report "C:\Logs\CMSFailover.html"

Restore

Optional

System.Management.Automation.SwitchParameter

When specified, restores the existing Central Management Server database.

WhatIf

Optional

System.Management.Automation.SwitchParameter

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

Input Types

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

Return Types

None.

See Also