Office 365: Comment utiliser la DLL Microsoft.SharePoint.Client.UserProfiles.dll dans son code PowerShell

 Nous avons vu dans un précédent article comment accéder à la base de profile de son Tenant Office 365 via PowerShell:

• Office 365: Comment obtenir des informations des Users Profiles du tenant via PowerShell

Et les première lignes du code d’exemple chargent les DLL nécessaires:

Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.UserProfiles.dll"

La partie plus probématique est la troisième ligne, car pour utiliser ce code telquel, il faut avoir installé le package:

• SharePoint Online Client Components SDK

Dont la date commence un peu à dater, mais surtout qui n’est pas compatible avec le package de management en PowerShell nécessaire pour Office 365:

• SharePoint Online Management Shell

Nous avions évoqué ce point dans un message relatif à la mise en place d’un serveur de gestion Office 365:

• Office 365: Monter une machine de management pour gérer Office 365

Ce package contient de nombreuses DLL, mais pas celle des profiles (Microsoft.SharePoint.Client.UserProfiles.dll) comme on peut le voir ci-dessous:

La solution est un peu barbare, mais a le mérite de fonctionner, car le seul but est d’obtenir une copie de cette DLL pour son code PowerShell.

Pour cela, il existe plusieurs méthodes, plus ou moins sauvage.

La plus simple est l’utilisation d’un outil d’unzip pour extraire le contenu du fichier MSI et trouver alors les fichiers (dans l’exemple avec 7ZIP):

Les fichiers DLL sont alors tous présent et il suffit de le renommer selon son besoin et de l’utiliser dans son script.

La seconde méthode est plus propre, car utilisant le moteur d’installation de Microsoft “MSIExec”.

Elle s’utilise selon le modèle:

• msiexec /a c:\testfile.msi /qb TARGETDIR=c:\temp\test

Ce qui donne dans notre cas précis la commande suivante:

• msiexec.exe /a C:\TEMP\sharepointclientcomponents_16-4002-1211_x64-en-us.msi /qb TARGETDIR=C:\TEMP\sharepointclientcomponentsMSIFiles

Après quelques secondes, on trouve le contenu de ce package dans le répertoire voulu:

On trouve à ce moment les fichiers DLL simplement dans les sous-répertoires, comme pour notre cas précis, dans le sous-répertoire “GAC_MSIL”:

Il ne nous reste plus qu’à copier ce fichier “Microsoft.SharePoint.Client.UserProfiles.dll” dans notre repository qui sera utilisé par PowerShell.

Voici un exemple de script PowerShell utilisable pour les cas de serveur de gestion (Office 365: Monter une machine de management pour gérer Office 365):

[string]$defaultDLLPath = ""
# Load assemblies to PowerShell session
$defaultDLLPath = "C:\Program Files\SharePoint Online Management Shell\Microsoft.Online.SharePoint.PowerShell\Microsoft.SharePoint.Client.dll"
[System.Reflection.Assembly]::LoadFile($defaultDLLPath)
$defaultDLLPath = "C:\Program Files\SharePoint Online Management Shell\Microsoft.Online.SharePoint.PowerShell\Microsoft.SharePoint.Client.Runtime.dll"
[System.Reflection.Assembly]::LoadFile($defaultDLLPath)
$defaultDLLPath = "C:\TEMP\sharepointclientcomponentsMSIFiles\GAC_MSIL\Microsoft.SharePoint.Client.UserProfiles.dll"
[System.Reflection.Assembly]::LoadFile($defaultDLLPath)

Cette stratégie est adaptable pour toutes les autres DLL qui ne sont pas dans le package de management PowerShell pour Office 365.

Romelard Fabrice [MBA Risk Management]