MachPanel Knowledgebase

INFO:CSP Module Configuration Guide for MachPanel Automation Solution

Mudesira Munir


This article provides a summary for CSP / Office 365 Configuration for MachPanel Control Server.

  • MachPanel Control Server Setup and Configuration.
  • Service Account Permissions and Other Configuration on Microsoft Partner Center and Microsoft Azure Portal.
  • Adding CSP Profile in MachPanel
Applies To

This article applies to MachPanel build version 6.4.50 and above.


MachPanel's Microsoft CSP / Office 365 Module is the only management software that completely wipes out the complexities in Office 365 management by its unified approach. It allows you to significantly reduce your time to manage users, groups, contacts and manipulate plenty of settings via single interface. It is simple, fast and consolidated admin center that allows you to perform numerous action at a time without waiting for any previous one to be completed.

For MachPanel to interact with Microsoft CSP / Office 365, there are multiple PowerShell modules required to be installed on MachPanel control server. Apart from PowerShell modules installation, there are other configuration steps involved and host machine environment requirements to complete and these are as follows.

1 - Dot Net Framework 4.6.2

Microsoft Dot Net Framework 4.6.2 or above shall be installed on host machine (In most cases it will be already installed on control server)
2 - Set Execution Policy

Execution policy for Windows PowerShell needs to be set to ‘RemoteSigned’ so that remote commands can be executed in shell. To set execution policy, please open windows PowerShell and type below command and then press enter to execute Set-ExecutionPolicy RemoteSigned

Required Module and Version
Nuget                    Package Provider
O365 tenant management
Microsoft Partner Center
Azure Active Directory  
MicrosoftTeams 4.4.1                         Teams Cmdlets Module

3 - Powershell Modules and their Configuration/Installation
  • Install PowerShell 5.1 if not installed.
    • To check your PowerShell version use command: $PSVersionTable.PSVersion
  • It should be like below or a latest build
  • To install:

  • ​Install Module MSOnline using command: Open PowerShell as Administrator

    1. Run Command Get-PackageProvider
      1. See: NuGet, version should be: or latest.
        1. If version is older then run commands:
          1. [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12;
          2. Install-PackageProvider -Name NuGet -RequiredVersion -Force
        2. Once done, Close PowerShell and Re-open as Administator.
    2. Run commands:
      1. [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12;
      2. Install-Module -Name MSOnline -RequiredVersion
      3. Install-Module -Name PartnerCenter -RequiredVersion 1.5.1908.1
      4. Import-Module MSOnline
      5. Get-Module
        1. MsOnline version should be >=

    3. For MachPanel Build version 6.3.12 and later Azure AD module is required, please install by running command on PowerShell on control server:
      Install-Module -Name AzureAD -RequiredVersion
4 - SharePoint Online Module for O365

On the MachPanel Control Server Machine, navigate to: C:\Program Files\MachSol\MachPanel Control Server\Apps\O365\Installers and use the file SharePointOnlineManagementShell_7414-1200_x64_en-us to install SharePoint Online Module for Office 365.

5 - Microsoft Teams Online Connector for Office 365
  1. If you have installed any SkypeOnlineConnector module, Uninstall it from Add/Remove Programs in Windows Control Panel.
  2. If you have installed any MicrosoftTeams Module, Uninstall it using PowerShell command:
    • Uninstall-Module MicrosoftTeams -Force
  3. Install 4.4.1 version of Teams Module:
    • Install-Module -Name MicrosoftTeams -RequiredVersion 4.4.1 -AllowPrerelease
    • If above command gives error related to command parameters RequiredVersion, AllowPrerelease, run below commands on shell:
      • Install-PackageProvider Nuget -Force
      • Install-Module -Name PowerShellGet -Force
      • Install-Module -Name MicrosoftTeams -RequiredVersion 4.4.1 -AllowPrerelease

After installation restart "O365 Service" once.

6 - MachPanel O365 Service Installation

To communicate with Microsoft Office 365 a windows service is built that will operate as a bridge between MachPanel and Microsoft Office 365. To install the service please locate “o365install.bat” file inside “C:\Program Files\MachSol\MachPanel Control Server\Apps\O365\Installers” directory.

RUN this file via Windows Shell with administrator privileges or simply right click and RUN AS ADMINISTRATOR.

Once the service is installed, open the services console in windows and locate service with name “MachPanel O365 Service” and make sure it is in Running state.

Note: o365install.bat file should be RUN AS ADMINISTRATOR.

7 - System Reboot
Once above steps are completed, reboot the server. System reboot is mandatory step in configuration and must not be skipped.
  • To enable Microsoft CSP module in MachPanel Control Server, please navigate to Path: Home » System Configuration » Built-in Modules and select “Microsoft CSP” Checkbox as checked and press “Update Configuration” button. For detail see below screenshot of the interface:


  • Once CSP module is enabled, the next step is to add a CSP Profile. Navigate to: Home » Service Director » Microsoft CSP » Microsoft CSP Profiles
  • Click on "Add CSP Profile" button.


  •  You will be asked to fill following details: 


Enable Permissions for 'Microsoft Partner Center' and 'Windows Azure Active Directory Portal':

  • Login to Microsoft Partner Center click on "Dashboard >> View Users", this will land you on "User Management".
  • For CSP Service Account following "roles and permissions" are required:

Summary of Steps to perform on Microsoft Azure Portal:
  • Go to: and login using your CSP Service Account, then navigate to "Azure Active Directory" >> "App Registrations".
  • Here, either use Existing Application or create "New Registration".
  • Add Redirect URI for your Web Application as: urn:ietf:wg:oauth:2.0:oob
  • Hit Register to register this application.