external help file | online version | applicable | title | schema | manager | author | ms.author | ms.reviewer |
---|---|---|---|---|---|---|---|---|
Microsoft.Rtc.Management.dll-help.xml |
Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
Invoke-CsManagementServerFailover |
2.0.0 |
rogupta |
hirenshah1 |
hirshah |
Invokes the process by which the Skype for Business Server Central Management Store (CMS) is failed over to another pool. When the Central Management store is failed over the primary database will be replaced by either a preassigned database or a specified backup database. To run this cmdlet, you need to use an account that is a member of the RTCUniversalServerAdmins group. This cmdlet should be run on a server in the pool to which you want to failerover the CMS. This cmdlet was introduced in Lync Server 2013.
Invoke-CsManagementServerFailover -BackupSqlServerFqdn <Fqdn> [-Force] [-BackupMirrorSqlInstanceName <String>]
[-BackupMirrorSqlServerFqdn <Fqdn>] [-BackupSqlInstanceName <String>] [-Confirm] [-Report <String>] [-WhatIf]
[<CommonParameters>]
Invoke-CsManagementServerFailover [-Confirm] [-Report <String>] [-Restore] [-WhatIf] [<CommonParameters>]
The Invoke-CsManagementServerFailover cmdlet enables administrators to "failover" the Central Management Server (CMS). You can only invoke the failover to the database defined in the Topology Builder. The Invoke-CsManagementServerFailover cmdlet provides two methods for failing over the CMS:
Failover when the CMS is available by running the cmdlet without any target database parameters as in Example 1.
Failover when the CMS is unavailable (in disaster recovery mode) by specifying the BackupSqlServerFqdn parameter and the corresponding BackupSqlInstanceName parameter as in Example 2. If the database defined in the Topology Builder is mirrored, add the BackupMirrorSqlServerFqdn and BackupMirrorSqlInstanceName parameters.
Skype for Business Server Control Panel: The functions carried out by the Invoke-CsManagementServerFailover cmdlet are not available in the Skype for Business Server Control Panel.
Invoke-CsManagementServerFailover
The command shown in Example 1 fails over the Central Management store for Skype for Business Server. In this case, the existing management store will be replaced by the preassigned database specified in the topology.
Invoke-CsManagementServerFailover -BackupSqlServerFqdn "redmond-cs-001.litwareinc.com" - BackupSqlInstanceName "RTC" -Force
The command shown in Example 2 fails over the Central Management store for Skype for Business Server. In this case, the existing management store will be replaced by the RTC database instance found on the computer redmond-cs-001.litwareinc.com.
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.
Type: Fqdn
Parameter Sets: DisasterRecovery
Aliases:
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
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.
You should not use the Force parameter if you are running the cmdlet for purposes other than disaster recovery, as it will not account for replication during the failover. When the parameter is not used, the cmdlet will first make sure all replications are done, then set the source DB to read-only mode.
Type: SwitchParameter
Parameter Sets: DisasterRecovery
Aliases:
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
SQL Server instance for the mirror database.
Type: String
Parameter Sets: DisasterRecovery
Aliases:
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Fully qualified domain name of the computer hosting the SQL Server mirror database.
Type: Fqdn
Parameter Sets: DisasterRecovery
Aliases:
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
SQL Server instance for the backup database.
Type: String
Parameter Sets: DisasterRecovery
Aliases:
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Prompts you for confirmation before executing the command.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Enables you to specify a file path for the log file created when the cmdlet runs.
For example: -Report "C:\Logs\CMSFailover.html"
Type: String
Parameter Sets: (All)
Aliases:
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
When specified, restores the existing Central Management Server database.
Type: SwitchParameter
Parameter Sets: Normal
Aliases:
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Describes what would happen if you executed the command without actually executing the command.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
None. The Invoke-CsManagementServerFailover cmdlet does not accept pipelined input.
None.