Export (0) Print
Expand All
Expand Minimize



Topic Last Modified: 2013-02-22

Converts exported user data to the data format used by either Microsoft Lync Server 2010 or Lync Server 2013. This cmdlet was introduced in Lync Server 2013.

Convert-CsUserData -InputFile <String> -OutputFile <String> -TargetVersion <Lync2010 | Current> [-ConfDirectoryFilter <String>] [-Force <SwitchParameter>] [-UserFilter <String>]

The command shown in Example 1 converts the user data stored in the file C:\Logs\Lync2013Data.zip to the user data format used in Lync Server 2010. The converted data is stored in the XML file C:\Logs\Lync2010Data.xml.

Convert-CsUserData -InputFile "C:\Logs\Lync2013Data.Zip" -OutputFile "C:\Logs\Lync2010Data.xml" -TargetVersion Lync2010

Example 2 shows how you can convert data for a single user; in this example, the user with the SIP address kenmyer@litwareinc.com. This is done by including the UserFilter parameter followed by the user’s SIP address (minus the sip: prefix).

Convert-CsUserData -InputFile "C:\Logs\Lync2013Data.Zip" -OutputFile "C:\Logs\Lync2010data.xml" -TargetVersion Lync2010 -UserFilter "kenmyer@litwareinc.com"

The Convert-CsUserData cmdlet takes data exported by using the Export-CsUserData cmdlet and then converts that data to the user data format used by either Microsoft Lync Server 2010 or Lync Server 2013. In turn, that enables the Import-CsUserData cmdlet to import that data to the appropriate version of Lync Server.

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 "Convert-CsUserData"}

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


Parameter Required Type Description




Full path to the .ZIP file or .XML file containing the user data to be converted. For example:

-InputFile “C:\Data\Lync2010.zip"




Full path to the file that will store the converted data. If you are outputting the data using the Microsoft Lync Server 2010 format then the output file must use a .XML file extension; for example:

-OutputFile "C:\Data\ConvertedLync2010Data.xml"

If you are using the Lync Server 2013 format, the output file must use a .ZIP file extension:

-OutputFile "C:\Data\ConvertedLyncData.zip"




Indicates the format for the converted data. Allowed values are:






Enables you to convert conference directory data. To do this, include the ConfDirectoryFilter parameter and specify the Identity of the conference directory:

-ConfDirectoryFilter 13

You can retrieve conference directory Identities by using this command:

Get-CsConferenceDirectory | Select-Object Identity, ServiceId




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




Enables you to convert data for a single user. That user specified by using his or her SIP address, minus the sip: prefix. For example:

-UserFilter "kenmyer@litwareinc.com"

None. The Convert-CsUserData cmdlet does not accept pipelined input.

The Convert-CsUserData cmdlet creates either XML or ZIP files, depending on whether the converted data is to be used with Lync Server 2010 or with Lync Server 2013.

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