Moving the Response Group configuration data from one pool to another and restoring it after a disaster are uncommon but vital scenarios to ensure business continuity. Although Windows PowerShell command-line interface provides all the pieces to perform these tasks, it still requires advanced scripting. The Response Group Export-Import tool simplifies these scenarios. You can download this tool and other Microsoft Lync Server 2010 communications software Resource Kit tools from the Download Center.

Author: Frédéric Dubut, Tommy Larsson

Publication date: January 2011

Product version: Microsoft Lync 2010, Microsoft Lync Server 2010, Windows PowerShell

Introduction

Moving the Response Group configuration data from one pool to another and restoring it after a disaster are uncommon but vital scenarios to ensure business continuity. Although Windows PowerShell provides all the pieces to perform these tasks, it still requires advanced scripting. The Response Group Export-Import tool simplifies these scenarios. You can download this tool and other Microsoft Lync Server 2010 Resource Kit tools from the Download Center.

Description

Response Group Export-Import is a Windows PowerShell script that enhances the Lync Server 2010 Management Shell by adding two additional cmdlets to export the complete Response Group configuration from a given pool and import this configuration to another (or same) pool.

The Response Group Export-Import script populates the Lync Server 2010 Management Shell with two new cmdlets: Export-CsRgsConfiguration and Import-CsRgsConfiguration.

Output

The Export-CsRgsConfiguration cmdlet outputs a .zip archive that contains a dump of the Response Group configuration for a given pool (passed as a parameter).

The Import-CsRgsConfiguration cmdlet indicates success or failure when importing the Response Group configuration that was generated by Export-CsRgsConfiguration to a specified pool (passed as a parameter).

Purpose

The Response Group Export-Import cmdlets can be used in three scenarios:

  • Data migration: Fabrikam is in the process of replacing all the computers from one pool with newer computers. Fabrikam's strategy is to deploy a new Lync Server 2010 pool, move all the data from the old to the new pool, and then to deprecate the old pool. For the Response Group configuration to be moved, it is exported from the old pool and imported to the new pool.

Note   Export-CsRgsConfiguration does not delete the Response Group configuration from the old pool. Because some of the workflow properties must be unique across the organization (such as SIP URI or telephone number), Fabrikam will have to clean the Response Group configuration from the old pool before being able to re-import it to the new pool (by using the standard Remove-CsRgsWorkflow cmdlet, for instance).

  • Disaster recovery: To prevent major outages in case of a disaster, Fabrikam performs a daily back up of the Response Group configuration. In the case of a dramatic event that destroys all the Lync Server 2010 data, the administrator can restore the full Response Group configuration as soon as the replacement servers are functional.
  • Troubleshooting: Fabrikam encounters a Response Group issue and calls Microsoft support. Fabrikam exports the Response Group configuration from the pool that is exhibiting the issue and sends it to Microsoft support for troubleshooting. Microsoft support imports the configuration to replicate Fabrikam's environment to troubleshoot the issue.

Requirements

The script must be run from a computer that has Lync Server 2010 Management Shell installed.

Export-CsRgsConfiguration

The Export-CsRgsConfiguration cmdlet requires the two parameters that are described in Table 1.

Table 1. Export-CsRgsConfiguration parameters

 

Import-CsRgsConfiguration

The Import-CsRgsConfiguration cmdlet requires the two parameters that are described in Table 2.

Table 2. Import-CsRgsConfiguration parameters

Examples

Running the Response Group Export-Import Script

The following is the first command you should run from the Lync Server 2010 Management Shell to populate the console with the Export-CsRgsConfiguration and Import-CsRgsConfiguration cmdlets:

Import-Module .\RgsImportExport.ps1

Exporting the Response Group Configuration

The following command exports the Response Group configuration for the pool that has the FQDN rtc.fabrikam.com. The configuration is exported to the file c:\Temp\RgExport.zip:

Importing the Response Group Configuration

The following command imports the Response Group configuration from the file c:\Temp\RgExport.zip to the pool that has the FQDN rtc.fabrikam.com:

Summary

The Response Group Export-Import tool helps make it both easy and convenient to export and import your Response Group configuration data.

Lync Server Resources

We Want to Hear from You

Keywords: Response Group, Windows PowerShell, export, import, backup, back up, restore