Import-CsUserData
Imports user data previously exported by using the Export-CsUserData cmdlet. This cmdlet was introduced in Lync Server 2013.
Syntax
Import-CsUserData
-FileName <String>
-Identity <String>
[-ConfDirectoryFilter <String>]
[-DomainController <Fqdn>]
[-Force]
[-LegacyFormat]
[-RoutingGroupFilter <String>]
[-UserFilter <String>]
[<CommonParameters>] Import-CsUserData
-FileName <String>
-PoolFqdn <Fqdn>
[-ConfDirectoryFilter <String>]
[-DomainController <Fqdn>]
[-Force]
[-LegacyFormat]
[-RoutingGroupFilter <String>]
[-UserFilter <String>]
[<CommonParameters>] Description
The Import-CsUserData cmdlet is used to import previously-saved user data and/or conference directory data to Skype for Business Server. Note that this data must have been exported by using the Export-CsUserData cmdlet.
To make sure changes happen after this cmdlet, FE services need to be stopped in all FE servers in the pool firstly then be restarted at the same time after executing Import-CsUserdata cmdlet.
Skype for Business Server Control Panel: The functions carried out by the Import-CsUserData cmdlet are not available in the Skype for Business Server Control Panel.
Examples
-------------------------- Example 1 --------------------------
Import-CsUserData -PoolFqdn "atl-cs-001.litwareinc.com" -FileName "C:\Logs\ExportedUserData.zip"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.
Parameters
-ConfDirectoryFilter
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
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-DomainController
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.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-FileName
Full path to the input file containing the exported user data. For example:
-InputFile "C:\Data\ExportedUsers.xml"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Force
Suppresses the display of any non-fatal error message that might arise when running the command.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Identity
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-LegacyFormat
Indicates that the data to be imported was exported from a previous version of Lync Server or Office Communications Server.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-PoolFqdn
Fully qualified domain name of the Registrar pool for the user data being imported. For example:
-PoolFqdn "atl-cs-001.litwareinc.com"
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-RoutingGroupFilter
Enables you to limit the imported data to users who belong to the same routing group. Routing groups are used by Skype for Business Server to determine the Front End server that users register with.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-UserFilter
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
Inputs
None. The Import-CsUserData cmdlet does not accept pipelined input.
Outputs
None.