Export (0) Print
Expand All
Expand Minimize

Move-CsManagementServer

 

Topic Last Modified: 2012-04-23

Moves the Central Management Server from one pool to another.

Move-CsManagementServer [-ConfigurationFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-LisConfigurationFileName <String>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

The Move-CsManagementServer cmdlet enables administrators to move the Central Management Server (and the accompanying Central Management store) from one pool to another. Because there is always the potential for data loss, not to mention service interruption, any time you move the Central Management Server, it is recommended that you do not make such a transfer unless:

1. You need to decommission the existing management pool, and must transfer the Central Management Server before doing so.

2. You’ve encountered a disaster recovery scenario in which the existing Central Management Server is no longer accessible.

Before you move the Central Management Server, you must do the following:

1. Verify that you have created the new Central Management store. This is done by running the Install-CsDatabase cmdlet and using the CentralManagementDatabase parameter.

2. If you are moving the Central Management Server to a Standard Edition server, verify that you have used local setup to run the Prepare Standard Edition server option. This advance preparation is required to add firewall rules that will allow Windows PowerShell to remotely access the new Central Management store.

3. Verify that there is enough free disk space on the computer where Move-CsManagementServer is being run to accommodate the Central Management Server.

4. Verify that the Front End Server service has been installed on the computer where Move-CsManagementServer is being run. If this service is not installed, and running, then the move will fail.

5. Verify that you can successfully run the Enable-CsTopology cmdlet on the computer where Move-CsManagementServer is going to be run. If Enable-CsTopology cannot be run on that computer then the move will fail and you will no longer have a functioning Central Management store.

After you have completed these steps, all you need to do to move the Central Management Server from Pool A to Pool B is log on to a computer in Pool B and then call Move-CsManagementServer without any additional parameters:

Move-CsManagementServer

When you do that, Move-CsManagementServer will consult the topology to determine the prior location of the Central Management Server (Pool A), and then transfer the Central Management Server and the Central Management store to the current pool (Pool B).

If the move succeeds, Move-CsManagementServer will display a list of computers on the screen. In order to finish the move, you must run local setup on each of these computers. Computers in Pool A will still be running an inactive version of the Central Management service; running local setup will delete that service. The computer in Pool B where the Central Management Server was moved will be running the Central Management service; however, other computers in the pool will not. Running local setup on these computers will install the Central Management service.

To transfer the Central Management Server in a disaster recovery scenario you should have, ideally, used the Export-CsConfiguration and Export-CsLisConfiguration cmdlets to create backup files of your Microsoft Lync Server 2010 configuration and your Enhanced 9-1-1 (E9-1-1) configuration, respectively. (Because disasters typically occur without warning, you should routinely run these cmdlets and make backup files of your configuration settings.) When calling Move-CsManagementServer you should include both the ConfigurationFileName and LisConfigurationFileName parameters in order to read in these backup files.

You must also include the Force parameter any time you are trying to move a Central Management Server that is offline or otherwise inaccessible. When you call Move-CsManagementServer, the cmdlet temporarily sets the Central Management store to read-only before the move takes place; that helps guard against data loss. In a disaster recovery scenario, however, the Central Management store cannot be marked as read-only. The Force parameter instructs the cmdlet to move the Central Management store even though it has not been configured as read-only.

If Move-CsManagementServer fails then you might find yourself in a situation where you no longer have a functioning Central Management Server. To restore the Central Management Server, you will need to fix the problem that caused Move-CsManagementServer to fail, and then re-run the cmdlet. This re-run can take place either on a new pool or on the old pool. If you run Move-CsManagementServer on the old pool, that will effectively cancel the move and leave you with your original configuration.

Note that the Move-CsManagementServer cmdlet must be run locally; it cannot be called from a remote management session.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Move-CsManagementServer cmdlet locally: RTCUniversalServerAdmins. You must also be a local administrator on the computer where the cmdlet is being run.

 

Parameter Required Type Description

ConfigurationFileName

Optional

String

Full path to the Lync Server 2010 configuration backup file created by running the Export-CsConfiguration cmdlet. This parameter should only be used in a disaster recovery scenario.

LisConfigurationFileName

Optional

String

Full path to the E9-1-1 backup file created by running the Export-CsLisConfiguration cmdlet. This parameter should only be used in a disaster recovery scenario.

Force

Optional

Switch Parameter

Forces the Central Management Server move even if the existing store is offline; this parameter is required in a disaster recovery scenario. Note that there is the potential for some data loss any time you force the movement of the Central Management Server.

The Force parameter can also be used if your previous attempts at calling Move-CsManagementServer have failed.

Report

Optional

String

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

WhatIf

Optional

Switch Parameter

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

Confirm

Optional

Switch Parameter

Prompts you for confirmation before executing the command.

None. Move-CsManagementServer does not accept pipelined input.

Move-CsManagementServer does not return any objects.

-------------------------- Example 1 ------------------------

Move-CsManagementServer

The command shown in Example 1 moves the Central Management Server from its existing pool to a new pool. To perform this live migration (that is, to move a Central Management Server that is online and accessible), you must run the command from a computer located in the pool where the server is to be moved.

-------------------------- Example 2 ------------------------

Move-CsManagementServer -ConfigurationFileName "C:\CsConfiguration.zip" -LisConfigurationFileName "C:\CsLisConfiguration.zip" -Force

Example 2 moves the Central Management Server in a disaster recovery scenario; that is, in a scenario where the existing management server is offline or otherwise inaccessible. To perform this type of migration, you must run the preceding command from a computer located in the pool where the server is to be moved. In addition, you must include the ConfigurationFileName parameter to import your previously saved configuration backup file; the LisConfigurationFileName parameter, to import your previously saved E9-1-1 backup file (if you are using E9-11); and the Force parameter to force the transfer of the Central Management Server even though the existing server cannot be contacted.

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft