-
Title
HOW TO: Importing the Active Roles Synchronization Service Management Shell module into PowerShell scripts -
Description
The Active Roles Synchronization Service Management Shell is not added to the PSModulePath during the installation of the product, so importing the PowerShell module requires a version-specific string. -
Cause
This has been identified as an Enhancement Request and is being tracked as Feature ID 91017. -
Resolution
WORKAROUND
Active Roles 7.0:
Import-Module 'C:\Program Files\Dell\Active Roles\7.0\SyncService\SyncServiceShell\ActiveRoles.SyncService.ManagementShell.SnapIn.dll'
Active Roles 7.1:
Import-Module 'C:\Program Files\Dell\Active Roles\7.1\SyncService\SyncServiceShell\ActiveRoles.SyncService.ManagementShell.SnapIn.dll'
Active Roles 7.2 though 7.6:
Import-Module 'C:\Program Files\One Identity\Active Roles\7.x\SyncService\SyncServiceShell\ActiveRoles.SyncService.ManagementShell.SnapIn.dll'
Active Roles 8.01 LTS and Active Roles 8.x:
Import-Module 'C:\Program Files\One Identity\Active Roles\8.x\SyncService\SyncServiceShell\ActiveRoles.SyncService.ManagementShell.SnapIn.dll'
For scripts which might be run under multiple versions, something similar to the following could be leveraged:
if (Test-Path 'C:\Program Files\Dell\Active Roles\7.1\SyncService\SyncServiceShell\ActiveRoles.SyncService.ManagementShell.SnapIn.dll')
{#Test for Active Roles Synchronization Service Management Shell 7.1 DLLImport-Module 'C:\Program Files\Dell\Active Roles\7.1\SyncService\SyncServiceShell\ActiveRoles.SyncService.ManagementShell.SnapIn.dll'}elseif (Test-Path 'C:\Program Files\Dell\Active Roles\7.0\SyncService\SyncServiceShell\ActiveRoles.SyncService.ManagementShell.SnapIn.dll'){#Test for Active Roles Synchronization Service Management Shell 7.0 DLLImport-Module 'C:\Program Files\Dell\Active Roles\7.0\SyncService\SyncServiceShell\ActiveRoles.SyncService.ManagementShell.SnapIn.dll'}else{#Do not load the Active Roles Synchronization Service cmdlets.throw [System.Exception]"Active Roles Synchronization Service Management Shell not present. Please install the Active Roles Synchronization Service before proceeding."}STATUSEnhancement request number 91017 has been submitted to Development for consideration in a future release of Active Roles. -
Change Request
91017