Office 365 – Distribution List Migrations Version 2.0 – Part 2

Preparing to use the distribution list migration v2 module.

The distribution list migration module version 2 is now a published module in the PowerShell gallery. The module has several external dependencies required for it to complete a migration. These dependencies include the Exchange Online Management Module V3, the Azure Active Directory PowerShell Module, the TelemetryHelper PowerShell Module, and the Remote Server Administration Tools for Active Directory.

 

Administrator rights to the workstation or server where the migrations will be performed are also required to establish the initial pre-requisites.

 

The DLConversionV2 PowerShell Module now includes the necessary modules in the manifest file. When the DLConversionV2 module is installed all of the dependent modules available from the PowerShell Gallery are also installed. The script ensures the minimum tested versions of the modules are present.

 

RequiredModules = @(

    @{ModuleName = ‘ExchangeOnlineManagement’; ModuleVersion = ‘3.0.0’ },

    @{ModuleName = ‘AzureAD’; ModuleVersion = ‘2.0.2.140’},

    @{ModuleName = ‘TelemetryHelper’; ModuleVersion = ‘1.5.1’}

    ‘ActiveDirectory’

)

 

 

Administrators should use the UPDATE-MODULE command to ensure that each of the dependent modules are up to date. The DLConversionV2 module is tested and released using the latest versions of dependent modules.

 

To begin preparing to utilize the module open PowerShell as an administrator. The execution policy must be relaxed in order to allow the utilization of unsigned modules.

 

SET-EXECUTIONPOLICY UNRESTRICTED

 

The installation of the Exchange Online Management Module V2 is performed through PowerShell.

About the Exchange Online PowerShell V2 module | Microsoft Docs

 

INSTALL-MODULE EXCHANGEONLINEMANAGEMENT

OR

UPDATE-MODULE EXCHANGEONLINEMANAGEMENT

 

As of the time of publishing, the script was tested with Exchange Online Management Module v 2.4.

 

In order to interact with Active Directory, the Remote Server Administration Tools for Active Directory are required. If your client is a Windows Server the tools can be installed through PowerShell.

 

INSTALL-WINDOWSFEATURE RSAT-ADDS

 

If your client is a Windows 10 workstation, see the following to determine the correct installation instructions for your version of Windows 10.

Remote Server Administration Tools | Microsoft Docs

 

The final step is to install the DLConversionV2 PowerShell module. As with the Exchange module this module can either be installed of updated.

 

INSTALL-MODULE DLCONVERSIONV2

OR

UPDATE-MODULE DLCONVERSIONV2

 

With the module and pre-requisites installed, you are now ready to explore the commands for migrating distribution groups.

 

Command included with the module can be viewed with:

 

GET-COMMAND -MODULE DLCONVERSIONV2

 

Help for commands within the module can be viewed with:

 

GET-HELP START-DISTRIBUTIONLISTMIGRATION (OR OTHER COMMAND)