Topic Last Modified: 2013-02-22

Imports user data previously exported by using the Export-CsUserData cmdlet. This cmdlet was introduced in Lync Server 2013.

Syntax

Import-CsUserData -PoolFqdn <Fqdn> <COMMON PARAMETERS>
Import-CsUserData -Identity <String> <COMMON PARAMETERS>
COMMON PARAMETERS: -FileName <String> [-ConfDirectoryFilter <String>] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-LegacyFormat <SwitchParameter>] [-RoutingGroupFilter <String>] [-UserFilter <String>]

Examples

Example 1

The command shown in Example 1 imports user data from a file named C:\Logs\ExportedUserData.zip to the pool atl-cs-001.litwareinc.com.

Copy Code 
Import-CsUserData -PoolFqdn "atl-cs-001.litwareinc.com" -FileName "C:\Logs\ExportedUserData.zip"

Detailed Description

The Import-CsUserData cmdlet is used to import previously-saved user data and/or conference directory data to Lync Server. Note that this data must have been exported by using the Export-CsUserData cmdlet.

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

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

Parameters

Parameter Required Type Description

FileName

Required

System.String

Full path to the input file containing the exported user data. For example:

-InputFile "C:\Data\ExportedUsers.xml"

Identity

Required

System.String

Service Identity of the user database where the data should be imported. For example:

-Identity "UserDatabase:atl-sql-001.litwareinc.com"

You cannot use both the Identity and the PoolFqdn parameters in the same command.

PoolFqdn

Required

Microsoft.Rtc.Management.Deploy.Fqdn

Fully qualified domain name of the Registrar pool for the user data being imported. For example:

–PoolFqdn "atl-cs-001.litwareinc.com"

ConfDirectoryFilter

Optional

System.String

When specified, allows you to import conference directory information for the specified conference directory. For example, to import data from the conference directory with the ID 13 use this syntax:

-ConfDirectoryFilter 13

You can return conference directory IDs by using this command:

Get-CsConferenceDirectory

DomainController

Optional

Microsoft.Rtc.Management.Deploy.Fqdn

Enables administrators to specify the FQDN of the domain controller to be used when running the Import-CsUserData cmdlet. If not specified, the cmdlet will use the first available domain controller.

Force

Optional

System.Management.Automation.SwitchParameter

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

LegacyFormat

Optional

System.Management.Automation.SwitchParameter

Indicates that the data to be imported was exported from a previous version of Lync Server or Office Communications Server.

RoutingGroupFilter

Optional

System.String

Enables you to limit the imported data to users who belong to the same routing group. Routing groups are used by Lync Server to determine the Front End server that users register with.

UserFilter

Optional

System.String

Enables you to import user data for a single user. To convert data for a specified user (and only for that user), set the UserFilter parameter to the SIP address of that user, being sure to omit the sip: prefix. For example:

-UserFilter "kenmyer@litwareinc.com"

This parameter allows you to import data one user at a time.

Input Types

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

Return Types

None.

See Also