Skip to main content

Technical Brief
from Zigabyte Australia

PowerShell beyond the script

Sometimes you need to glance sidewards, it’s not always about the product’s technical aspects and features. 

"… the Consultant and our technical team hit a road block when attempting a sync between Azure and our on prem. It was the determination and technical capability of the Consultant that saw it through."
Zigabyte Australia Tech Brief - Engagement Brief

During the installation of Active Roles’ Synchronization Services, particularly the Back-Sync between Azure Active Directory and on-prem. Active Directory, a critical Powershell script needs to be executed to set up the relevant permissions in the synchronization. The script makes certain assumptions of the Powershell environment that in practice may not be present. If they are not, the script will fail, and the Back-Sync cannot be configured correctly.

The problem is outside the scope of Active Roles’ documentation or Knowledge Base. The Back-Sync script assumes that the NuGet package is installed in the PowerShell environment as it makes calls to this package.

Zigabyte Australia Tech Brief - Problem Solution

Review of the script highlighted the assumptions of the PowerShell environment and made evident the undocumented dependencies. Three were identified:

  1. The MS-Online module needs to be installed and imported in the script for cmdlets such as connect-msolservice to be run.
  2. The MS-Online module is not exposed unless NuGet package is installed
  3. The NuGet package cannot be installed if the ServicePoint Manager class does not host or support TLS 1.2 interoperability.

Processed as:

  1. Expose the TLS 1.2 interoperability class to the ServicePoint Manager of Powershell.
  2. Install the NuGet package for Powershell.
  3. Install and import the MS-Online module into the script.
PointZ Tech Brief - Problem Solution

Not all deployments go to plan as documented. It is sometimes necessary to pause and look for solutions and experience outside of the Product itself to tools and skills that are not incorporated in the products themselves.

PointZ Technologies

The expertise to pause and look behind the tool and the assumptions of the developers.


  • Active Roles Server