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.

Syntax

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

Examples

Example 1

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.

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

Example 2

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).

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

Detailed Description

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.

Parameters

Parameter Required Type Description

InputFile

Required

System.String

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

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

OutputFile

Required

System.String

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"

TargetVersion

Required

Microsoft.Rtc.Management.BlobStore.Cmdlets.ConvertTarget

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

Lync2010

Current

ConfDirectoryFilter

Optional

System.String

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

Force

Optional

System.Management.Automation.SwitchParameter

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

UserFilter

Optional

System.String

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"

Input Types

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

Return Types

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.

See Also