Skip to main content

Prepare deployment machine

This section details the steps for preparing the Windows machine that will be used to execute the deployment. It is recommended the machine is a Windows virtual machine hosted in Azure.

Before you start​

Permission required​

Use an account with the following permissions:

  • Local Administrator on installation machine

PowerShell​

The following PowerShell modules should be installed:

  • PnP PowerShell PowerShell Module providing cmdlets that work with Microsoft 365 environments.
  • Azure PowerShell Collection of modules for managing Azure resources from PowerShell.
  • Exchange Online PowerShell Administrative interface that enables you to manage the Exchange Online.

PowerShell version​

All PowerShell commands should be run using PowerShell 5.x. This version of PowerShell supports all the commands required.

warning

IMPORTANT: It is strongly recommended that the installation is not attempted using any other version.

Execute the following PowerShell command to check the version you are running.

$PSVersionTable

Example output:

machine-01.png

PnP PowerShell​

Install the module using the following command in an elevated PowerShell window.

Install-Module -Name PnP.PowerShell -RequiredVersion 1.12.0

Update-Module can be used to update an existing installation.

Do not update PnP.PowerShell module to a version higher than 1.12.0.

Manual Download

Azure PowerShell​

Install the module using the following command in an elevated PowerShell window.

Install-Module -Name Az -RequiredVersion 7.5.0

Update-Module can be used to update an existing installation.

Manual Download

Exchange Online PowerShell​

Install the module using the following command in an elevated PowerShell window.

Install-Module -Name ExchangeOnlineManagement

Update-Module can be used to update an existing installation.

Manual Download

Microsoft .NET Framework​

Download and install the latest Microsoft .NET Framework runtime.

Check current version

You can check which version is installed by following this guide.

SQL CMD​

Download and install the SQL Command utility.

SQL Package​

Download and install the SQL Package utility.

Visual Studio Code​

Download and install Visual Studio Code.

SQL Server Management Studio​

Download and install SQL Server Management Studio.