15/11/2024

Office 365PowerShell

Ajouter un compte invité dans Office 365 avec PowerShell

I. Présentation

Dans ce tutoriel, je vais vous expliquer comment ajouter un compte invité dans Office 365 et plus précisément auprès d'Azure afin de pouvoir l'ajouter par la suite dans une équipe Teams. Sans cette action, un utilisateur externe (invité donc) ne peut pas être ajouté à une équipe Teams.

II. Ajouter un compte invité en PowerShell

Pour commencer, vous devez disposer du module PowerShell "AzureAD" pour réaliser cette opération. Pour l'installer, c'est tout simple :

Install-Module -Name AzureAD

Le module est disponible sur le site PowerShell Gallery : Module "AzureAD"

Ensuite, il faut créer un objet avec les credentials et nous allons l'utiliser avec le cmdlet "Connect-AzureAD" afin d'initier une connexion avec le tenant.

$Credentials = Get-Credential 
$Credentials.password.MakeReadOnly()
# Connexion à Azure
Connect-AzureAD -Credential $Credentials

La connexion étant établie, il va falloir maintenant créer le compte invité afin de permettre à notre partenaire d'accéder à une application ou un service de notre tenant. Le cmdlet New-AzureADMSInvitation va nous permettre de réaliser cette action, avec également la possibilité d'envoyer une invitation par e-mail. Voyons quelques informations complémentaires au sujet de ce cmdlet avant de voir la commande complète :

-InvitedUserEmailAddress : adresse e-mail de la personne à inviter

-SendInvitationMessage : faut-il envoyer un message d'invitation à cet e-mail ?

-InviteRedirectUrl : lien vers l'application à intégrer dans l'e-mail d'invitation

Voici la commande complète à titre d'exemple :

New-AzureADMSInvitation -InvitedUserEmailAddress "[email protected]" -SendInvitationMessage $true -InviteRedirectUrl "https://teams.microsoft.com/"

Lorsque le compte est ajouté, vous pouvez le vérifier en listant les comptes invités "guest" de votre tenant grâce au filtre sur le "UserType" :

Get-AzureADUser -Filter "UserType eq 'Guest'"

Le compte est prêt au niveau d'Azure, il est désormais possible de l'ajouter à une équipe Teams :

Add-TeamUser -GroupId <Team-Id> -User "[email protected]" -Role member

Cet exemple s'applique à Teams, car c'est un besoin que j'ai eu dernièrement, mais la création d'un compte invité de cette façon s'applique aussi aux autres services.

author avatar
Florian BURNEL Co-founder of IT-Connect
Ingénieur système et réseau, cofondateur d'IT-Connect et Microsoft MVP "Cloud and Datacenter Management". Je souhaite partager mon expérience et mes découvertes au travers de mes articles. Généraliste avec une attirance particulière pour les solutions Microsoft et le scripting. Bonne lecture.
Partagez cet article Partager sur Twitter Partager sur Facebook Partager sur Linkedin Envoyer par mail

1 commentaire sur “Ajouter un compte invité dans Office 365 avec PowerShell

  • Bonjour,
    Nous avons écrit un script (voir ci-dessous) afin de créer une équipe teams au sein de notre organisation (partager des fichiers avec des personnes extérieures).
    Nous rencontrons un problème lors de l’ajout d’un invité à un canal privé. Que ce soit via script ou directement sur l’application Teams. L’erreur est la même, l’invité est introuvable.
    Cette erreur se produit uniquement quand l’équipe est créée via script (ok dans appli Teams)
    Que nous manque-t-il dans nos scripts pour que cela fonctionne ?
    Autre besoin : création de dossier dans les canaux via script.

    (Connexion à Teams avec le compte admin)
    Connect-MicrosoftTeams

    (Création de l’équipe Teams)
    New-Team -DisplayName « 000000 – DEMO CREATION » -Description ‘000000 – DEMO CREATION’ -Visibility Public

    (renseigner la variable TeamGroupId pour la suite des commandes)
    $TeamGroupId = (Get-Team -DisplayName « 000000 – DEMO CREATION »).GroupId

    (modifier l’adresse mail de l’équipe)
    Set-Team -GroupId $TeamGroupId -MailNickname « 000000-DEMOCREATION »

    (connaitre les canaux présents dans une équipe-facultatif)
    Get-TeamChannel -GroupId $TeamGroupId

    (Création des Canaux)
    New-TeamChannel -GroupId $TeamGroupId -DisplayName « SOCIAL » -Description « SOCIAL » -MembershipType Private
    New-TeamChannel -GroupId $TeamGroupId -DisplayName « COMPTA » -Description « COMPTA » -MembershipType Private
    New-TeamChannel -GroupId $TeamGroupId -DisplayName « Cabinet » -Description « Cabinet » -MembershipType Private

    (Ajout des propriétaires à l’équipe)
    Add-TeamUser -GroupId $TeamGroupId -User « [email protected] »-Role Owner
    Add-TeamUser -GroupId $TeamGroupId -User « [email protected] »-Role Owner
    Add-TeamUser -GroupId $TeamGroupId -User « [email protected] »-Role Owner
    Add-TeamUser -GroupId $TeamGroupId -User « [email protected] »-Role Owner

    AJOUT DES PROPRIETAIRES des canaux privés : en 2 temps
    (Ajout des membres dans les canaux)
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected]

    (Passage en propriétaires dans les canaux)
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected] -Role Owner
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]-Role Owner
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected] -Role Owner
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected] -Role Owner
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]-Role Owner
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected] -Role Owner
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected]-Role Owner
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]-Role Owner
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected]-Role Owner
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected]-Role Owner
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]-Role Owner
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected]-Role Owner

    (Ajout des membres à l’équipe)

    Add-TeamUser -GroupId $TeamGroupId -User « [email protected] »
    Add-TeamUser -GroupId $TeamGroupId -User « [email protected] »
    Add-TeamUser -GroupId $TeamGroupId -User « [email protected] »
    Add-TeamUser -GroupId $TeamGroupId -User « [email protected] »

    (Ajout des membres dans les canaux privés)
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected]

    (Ajout 1 invité à l’équipe)
    Add-TeamUser -GroupId $TeamGroupId -User « [email protected] »-Role Guest

    (Ajout 1 invité dans les canaux)
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « SOCIAL » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « COMPTA » -User [email protected]
    Add-TeamChannelUser -GroupId $TeamGroupId -DisplayName « Cabinet » -User [email protected]

    Répondre

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.