Le blog technique

Toutes les astuces #tech des collaborateurs de PI Services.

#openblogPI

Retrouvez les articles à la une

Powershell & Office 365 : Provisionning de licences

Introduction

Dans Office 365, il existe plusieurs méthodes pour ajouter des licences à un utilisateur :

  • Via l’interface d’administration manuellement sur chaque utilisateur.
  • Via l’interface d’administration manuellement sur plusieurs utilisateurs.
  • Avec les cmdlets Powershell Office 365.

Dans cet article, nous allons nous intéresser à l’ajout/suppression de licences via Powershell. Le but est d’automatiser cette opération. On peut facilement imaginer des scénarios conjoints avec Dirsync. Ce dernier provisionne un compte, puis, une tâche ajoute automatiquement les licences nécessaires à l’utilisateur.

D’autre part, il est possible d’ajouter pour chaque utilisateur :

  • Une licence complète incluant tout les services de l’abonnement souscrit.
  • Certains services d’une licence afin de limiter les accès aux utilisateurs (par exemple : ne donner qu’une licence Exchange sans donner les accès à la suite Office).

    Nous nous attarderons sur ces différentes possibilités dans l’un des paragraphes suivants.

    Nous ferons un rappel sur les prérequis nécessaires à l’utilisation des cmdlets Powershell avant d’appréhender leur attribution. Nous verrons enfin un script permettant d’automatiser le processus d’ajout/suppression de services via l’utilisation des groupes de sécurité Office 365.

Pré requis

L’administration des utilisateurs Office 365 via Powershell a besoin de l’installation d’un module spécifique. Ce dernier nécessite un prérequis : Microsoft Online Services Sign-In Assistant. Ci dessous, vous trouverez le lien de téléchargement de ce dernier :

http://www.microsoft.com/en-us/download/details.aspx?id=41950

Voici maintenant les liens pour récupérer le module Powershell :

http://go.microsoft.com/fwlink/p/?linkid=236298

A titre informatif, la version 32 bits de ces composants n’est plus pris en charge et ne sera plus mis à jour par Microsoft.

 

Connexion à Office 365 et permission

Pour se connecter à Office 365, il est nécessaire d’exécuter la commande suivante :

Les informations d’authentification fourni doivent correspondre à un utilisateur possédant à minima le rôle de gestion des utilisateurs. Cette attribution permettra d’affecter les licences.

 

Licences et abonnements

Tout d’abord, nous allons commencer par récupérer les différents abonnements disponibles sur un tenant Office 365. Il s’agit de la commande :

Le résultat obtenu permet aussi de voir les licences disponibles (ActiveUnits) et utilisées. (ConsumedUnits)

Get-MsolAccountSku

Pour chacun des abonnements, il est possible d’accéder aux services disponibles. Exemple avec le premier abonnement de la liste :

ServiceStatus

Chaque service Office 365 possède donc un identifiant qui est utilise lors de l’affectation de licences à certains utilisateurs. Les services étant différents d’un plan à un autre, voici un tableau récapitulant les identifiants et les services auxquels ils donnent accès pour un abonnement de type E3 :

EXCHANGE_S_STANDARD Exchange Online (Plan 2)
MCOSTANDARD Lync Online (Plan 2)
SHAREPOINTENTERPRISE SharePoint Online (Plan 2)
SHAREPOINTWAC Office Online
OFFICESUBSCRIPTION Office ProPlus
RMS_S_ENTERPRISE Azure Active Directory Rights Management
INTUNE_O365 Intune
YAMMER_ENTERPRISE Yammer
 

Pour les autres abonnements, les services ont des noms identiques ou similaires (exemple : SHAREPOINT_S_DEVELOPER au lieu de SHAREPOINTENTERPRISE pour un abonnement développeur).

NB : J’ai noté deux spécificités sur certains services. Premièrement, la licence Office Online doit être attribué conjointement à une licence Sharepoint (on peut facilement s’en rendre compte via le portail d’administration Office 365). Enfin, les licences Yammer n’ont pas besoin d’être attribués. Cela est sans doute dû au fait que l’intégration du service dans l’offre Office 365 n’est pas terminée. Il se peut aussi que cela soit pensé pour simplifier le système. Néanmoins, il apparaît que le nombre d’utilisateurs peut dépasser le nombre de licences sans avoir de réduction de services (Il faut donc faire un suivi régulier du nombre de licences afin d’être en règle).

 

Gestion des licences utilisateurs

Attribution d’une licence complète

L’attribution d’une licence utilisateur se fait via la commande Powershell "Set-MSOLUserLicence". Il est possible d’utiliser cette commande pour un ou plusieurs utilisateurs. Le paramètre AddLicenses permet d’ajouter une licence correspondant à un plan Office 365.

Exemple d’attribution d’une licence :

NB : Il est nécessaire de fournir l’attribut AccountSkuId de l’objet obtenu avec la commande Get-MsolAccountSku.

NB2 : Si vous attribuez des licences à plusieurs utilisateurs et que le nombre restants est insuffisant, alors la cmdlet affectera quand même des licences jusqu’à épuisement de celles-ci.

Attention, avant d’attribuer une licence, il est nécessaire d’ajouter une localisation à l’utilisateur. Cette opération est automatisable avec la commande suviante :

La location est à remplacer par la valeur voulue (ici : FR).

 

Attribution d’une licence partielle

Pour l’instant nous avons vu, l’attribution d’une licence donnant accès à tous les services offert par l’abonnement Office 365. Dans certains cas, il peut être voulu de n’autoriser un utilisateur qu’à un certain nombre de services. Pour se faire, il faut créer un objet du type MsolLicenceOption. Celui-ci est une licence à laquelle on a désactivé certains services.

Exemple :

Cette cmdlet crée une licence avec un pack de service désactivant Azure Right Management Services et Lync Online.

La commande crée les options de licencing à partir d’un abonnement (AccountSkuId) et une liste de services sous forme de tableau. Les noms des services à fournir sont ceux définis dans le tableau du paragraphe "Licences et abonnements". On peut ensuite attribuer ces options de licencing via la même commande que précédemment mais en changeant de paramètre :

Script

Présentation

Le but du script ci-dessous est d’effectuer un provisioning automatique des licences Office 365 pour les utilisateurs synchronisés avec Dirsync. Celui-ci est basé sur l’utilisation des groupes de sécurité Office 365 (ce dernier peut être synchronisé via Dirsync). Chaque groupe correspond à l’attribution d’un ou plusieurs accès à des services Office 365.Ce script peut aussi bien gérer l’ajout que la suppression d’accès. Afin de ne pas perturber les accès déjà affectés à un utilisateur sont réattribués (tant qu’ils ne sont pas concerné par le script). Afin de mieux comprendre le comportement du script, voici un scénario d’exemple :

  • USER1 appartient au groupe GRP-SharepointOnline
  • GRP-SharepointOnline attribue les accès SHAREPOINTENTERPRISE et SHAREPOINTWAC
  • USER1 possède déjà un accès à Lync (via MCOSTANDARD)
  • Le script s’exécute et donne les accès à SHAREPOINT Online et Office Online à USER1
  • USER1 conserve également son accès à Lync Online.

Pour obtenir ce résultat, l’algorithme recalcule les accès de chaque utilisateur. Cette opération est réalisé en récupérant l’attribut DisabledServices de la licence utilisateur (avec Get-MsolUserLicense).

Il permet aussi de ne pas gérer certains services. Cela peut être notamment utile pour Yammer dont l’attribution de licence n’est pas à administrer.

Celui-ci a été utilisé au travers d’un runbook dans System Center Orchestrator mais il peut aussi être utilisé dans une tâche planifié. Il est possible d’imaginer des variantes de ce script. Par exemple, les licences à attribuer pourraient être stockée dans un attribut du groupe. On peut aussi supprimer l’exigence d’être un utilisateur synchronisé par Dirsync (dans ce cas le groupe devra être alimenté via la console Office 365 et non dans Active Directory).

 

Script

Office 365 – Résoudre l’erreur de migration “Cannot find a recipient that has mailbox GUID”

Contexte

Dans un environnement Exchange 2013 en mode hybride, vous obtenez l’erreur suivante lors de la migration d’une boite aux lettres Exchange Online vers Exchange OnPremise :

Error: MigrationPermanentException: Cannot find a recipient that as mailbox GUID <GUID>.

2015-09-08_181420

Cette erreur est due à l’absence du GUID sur la RemoteMailbox de l’utilisateur côté Exchange OnPremise.

Si vous lancez la commande suivante sur l’Exchange Management Shell, vous obtiendrez un GUID nul :

Get-RemoteMailbox <SamAccountName> | fl *ExchangeGUID*

2015-09-08_181240

Résolution

Afin de résoudre l’erreur et pouvoir procéder à la migration de la boite, vous devez modifier le GUID de la RemoteMailbox pour le faire correspondre à celui de la boite côté Exchange Online.

Vous pouvez récupérer le GUID de la boite depuis le message d’erreur ou depuis une console PowerShell connectée à ExchangeOnline avec la commande

Get-Mailbox <SamAccountName> | fl *ExchangeGUID*

2015-09-08_181501

Ensuite depuis l’Exchange Management Shell, lancez la commande suivante :

Set-Mailbox <SamAccountName> –ExchangeGUID <GUID>

2015-09-08_181532

Relancez votre migration.

2015-09-09_100059

Skype for Business 2015 – Publier les services web via WAP

Contexte

Lors de l’installation de Skype for Business 2015, un certain nombre de flux web doivent être publiés vers l’extérieur. Avec l’arrêt de TMG, il est recommandé (voir nécessaire) d’utiliser un autre Reverse Proxy pour publier ces flux.

Depuis Windows Server 2012 R2, Microsoft a intégré un nouveau rôle, le WAP pour Web Application Proxy. Ce rôle permet la publication de flux web. Il peut donc être utilisé dans une architecture Skype for Business 2015. Pour en savoir plus sur l’installation du rôle WAP, vous pouvez suivre le lien suivant : https://technet.microsoft.com/fr-fr/library/Dn280944.aspx.

Mise en œuvre

Prérequis

La publication des services web via WAP ne nécessite pas de prérequis particulier à l’exception du certificat public contenant l’ensemble des URLs.

 

 

Services Web

Skype for Business 2015 intègre plusieurs services web :

  • Meet
  • Dial-In
  • Scheduler
  • Autodiscover
  • Services Web
  • Office Web Apps

Publication

      Depuis la console

Remote Access Management Console

      , cliquez sur

Publish.

2015-09-09_141606

Passez la première étape, puis sélectionnez Pass-through dans la méthode de pré-authentification.

2015-09-09_141728

Indiquez le nom du service web, l’URL de publication dans External URL, sélectionnez le certificat public correspondant et indiquez l’URL interne dans Backend server URL.

2015-09-09_141913

La page suivante récapitule la publication. Cliquez sur Publish pour terminer la publication.

2015-09-09_141957

Recommencez l’opération pour toutes les URLs.