Move-CsRgsConfiguration

 

Topic Last Modified: 2012-03-23

Enables you to migrate Response Group configuration settings from Microsoft Office Communications Server 2007 R2 to Microsoft Lync Server 2010.

Syntax

Move-CsRgsConfiguration -Source <String> -Destination <String> [-Force <SwitchParameter>]

Detailed Description

The Response Group application provides a way for you to automatically route phone calls to entities such as a help desk or customer support line. When someone calls a designated phone number, that call can be automatically routed to the appropriate set of Response Group agents. Alternatively, the call might be routed to an interactive voice response (IVR) queue. In that queue, the caller would be asked a series of questions (for example, "Are you calling about an existing order?") and then, based on the answers to those questions, be given the asked-for information or be routed to a Response Group agent.

If you are currently running the Response Group application on Office Communications Server 2007 R2, the Move-CsRgsConfiguration cmdlet provides a way for you to migrate this service to Lync Server 2010. To migrate the service, you need to call the Move-CsRgsConfiguration cmdlet and specify: 1) the fully qualified domain name (FQDN) for the Communications Server 2007 R2 version of the Response Group application (the Source); and, 2) the FQDN for the new Lync Server version of the service (the Destination). Move-CsRgsConfiguration will then move all the configuration settings, audio files, and contact objects from Communications Server 2007 R2 to Lync Server. After the service has been migrated, all calls to a Response Group phone number will be handled by Lync Server. Calls will no longer be handled by the Communications Server 2007 R2 version of the service.

Before you can run Move-CsRgsConfiguration, you must first install the Windows Management Instrumentation (WMI) Backward Compatibility interfaces package; this application is installed by running OCSWMIBC.msi. The file OCSWMIBC.msi can be found on the installation DVD in the Setup folder.

If Office Communications Server 2007 is running Microsoft SQL Server 2005 then, before you attempt to migrate the Response Group application, you must install the Microsoft SQL Server 2005 Native Client on the computer where you will be running the Move-CsRgsConfiguration cmdlet. If the Native Client is not installed you will receive the error message "Cannot access WMI settings" when you call Move-CsRgsConfiguration.

The Move-CsRgsConfiguration cmdlet is only for migrating from Office Communications Server 2007 R2 to Lync Server 2010; you cannot use this cmdlet to migrate from one instance of Lync Server to a new instance of Lync Server. That type of migration can only be done by using the Lync Server Resource Kit cmdlets Import-CsRgsConfiguration and Export-CsRgsConfiguration.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Move-CsRgsConfiguration cmdlet locally: RTCUniversalServerAdmins. 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 prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsRgsConfiguration"}

Parameters

Parameter Required Type Description

Destination

Required

Full qualified domain name

FQDN of the computer where the Lync Server 2010 Response Group application is to be hosted (the "copy to" location).

Source

Required

FQDN

FQDN of the pool where the Office Communications Server 2007 R2 Response Group application is currently hosted (the "copy from" location).

Force

Optional

Switch Parameter

Suppresses the display of any non-fatal error message that might occur when running the command.

Input Types

None. Move-CsRgsConfiguration does not accept pipelined input.

Return Types

Move-CsRgsConfiguration moves instances of the Microsoft.Rtc.Management.WritableSettings.ServiceSettings from one service to another.

Example

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

Move-CsRgsConfiguration -Source atl-ocsrgs-001.litwareinc.com -Destination redmond-lyncrgs-001.litwareinc.com 

The command shown in Example 1 migrates the Response Group application from atl-ocsrgs-001.litwareinc.com to redmond-lyncrgs-001.litwareinc.com.