Import-CsLegacyConferenceDirectory
Topic Last Modified: 2012-03-23
Import-CsLegacyConferenceDirectory enables you to import conference directories from Microsoft Office Communications Server 2007 R2 to Microsoft Lync Server 2010. This helps provide interoperability between Lync Server 2010 and Office Communications Server 2007 R2.
Syntax
Import-CsLegacyConferenceDirectory [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Detailed Description
Import-CsLegacyConferenceDirectory is used in conjunction with the Merge-CsLegacyTopology cmdlet to enable organizations to migrate from Office Communications Server 2007 R2 to Lync Server 2010. Import-CsLegacyConfiguration imports conferencing directories from Communications Server 2007 R2 to Lync Server.
Before you can run Import-CsLegacyConferenceDirectory, you must first install the Windows Management Instrumentation (WMI) Backward Compatibility interfaces package; this application is installed by running OCSWMIBC.msi. (OCSWMIBC.msi can be found on the Lync Server 2010 installation DVD in the Setup folder.) After installing the Backward Compatibility interfaces package, you should next run Merge-CsLegacyTopology.
When Merge-CsLegacyTopology finishes running, you can call Import-CsLegacyConferenceDirectory. The Import-CsLegacyConferenceDirectory cmdlet first uses WMI to read legacy data from Communications Server 2007 R2, then takes the retrieved data and creates corresponding objects in Lync Server: for each conferencing directory found in your installation of Communications Server 2007 R2, a corresponding directory will be created in your new installation of Lync Server.
Import-CsLegacyConferenceDirectory should be rerun anytime conferences directories are added, deleted, or moved in the Communications Server 2007 R2 environment. Import-CsLegacyConferenceDirectory should also be run anytime Merge-CsLegacyTopology is run; this helps to ensure the conference directories and the topology remain in sync.
Who can run this cmdlet: By default, members of the following groups are authorized to run the Import-CsLegacyConferenceDirectory cmdlet locally: RTCUniversalServerAdmins. 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 prompt:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsLegacyConferenceDirectory"}
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
Report |
Optional |
String |
Enables you to specify a file path for the log file created when the cmdlet runs. For example: -Report "C:\Logs\ImportDirectories.html" |
Force |
Optional |
Switch Parameter |
Suppresses the display of any non-fatal error message that might occur when running the command. |
WhatIf |
Optional |
Switch Parameter |
Describes what would happen if you executed the command without actually executing the command. |
Confirm |
Optional |
Switch Parameter |
Prompts you for confirmation before executing the command. |
Input Types
None. Import-CsLegacyConferenceDirectory does not accept pipelined input.
Return Types
Import-CsLegacyConferenceDirectory does not return any objects or values.
Example
-------------------------- Example 1 ------------------------
Import-CsLegacyConferenceDirectory
The command shown in Example 1 imports conferencing directories from Communications Server 2007 R2 to Lync Server.