Inviter des utilisateurs invités externes

Inviter une personne externe en tant qu'utilisateur invité

Description

Envoie une invitation d'invité Microsoft Entra ID à une adresse e-mail externe. En option, l'invité est ajouté à un groupe, et des détails de profil tels que le nom, l'entreprise, l'emplacement d'utilisation, le gestionnaire et le parrain sont définis immédiatement sur le compte de l'invité. L'e-mail d'invitation et la page d'arrivée peuvent être personnalisés.

Cas d’utilisation courants

• Invitation d'invité de base : fournissez uniquement l'adresse e-mail et le nom d'affichage ; tous les paramètres de profil et de groupe peuvent rester vides.
• Intégration complète : fournissez tous les champs facultatifs pour définir les propriétés du profil, attribuer un gestionnaire et un parrain, et ajouter l'invité à un groupe en une seule exécution.

Interactions des paramètres

• Les propriétés du profil (givenName, surname, companyName, usageLocation) ne sont appliquées que lorsqu'elles ne sont pas vides ; les omettre ignore entièrement l'appel de mise à jour.
• L'attribution du gestionnaire, l'attribution du parrain et l'appartenance au groupe nécessitent chacun leurs paramètres respectifs ; ils sont tous ignorés silencieusement lorsqu'ils ne sont pas fournis.

Emplacement

Organisation → Général → Inviter des utilisateurs invités externes

Nom complet du runbook

rjgit-org_general_Invite-external-guest-users

Détails

Propriété	Valeur
Version	2.0.3
Modules requis	RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)
Planifiable	non

Autorisations

Autorisations d’application

• Type: Microsoft Graph

  • User.ReadWrite.All

    • Crée l'invitation, met à jour les propriétés du profil de l'invité et définit le gestionnaire et le parrain
  • Group.ReadWrite.All

    • Vérifie le groupe cible et ajoute l'invité via /groups/{id}/members/$ref
  • Organization.Read.All

    • Lit l'ID du Tenant pour construire l'URL de redirection d'invitation par défaut

Paramètres

InvitedUserEmail

Adresse e-mail de la personne à inviter.

Propriété	Valeur
Obligatoire	vrai
Valeur par défaut
Type	Chaîne

InvitedUserDisplayName

Nom affiché pour l'invité dans le répertoire.

Propriété	Valeur
Obligatoire	faux
Valeur par défaut
Type	Chaîne

GroupId

Groupe auquel l'invité est ajouté. Préconfiguré dans la personnalisation du runbook ; vide signifie aucun.

Propriété	Valeur
Obligatoire	faux
Valeur par défaut
Type	Chaîne

GivenName

Prénom de l'invité.

Propriété	Valeur
Obligatoire	faux
Valeur par défaut
Type	Chaîne

Surname

Nom de famille de l'invité.

Propriété	Valeur
Obligatoire	faux
Valeur par défaut
Type	Chaîne

CompanyName

Entreprise pour laquelle travaille l'invité.

Propriété	Valeur
Obligatoire	faux
Valeur par défaut
Type	Chaîne

ManagerName

Utilisateur qui devient le gestionnaire de l'invité.

Propriété	Valeur
Obligatoire	faux
Valeur par défaut
Type	Chaîne

SponsorName

Utilisateur enregistré comme parrain de l'invité.

Propriété	Valeur
Obligatoire	faux
Valeur par défaut
Type	Chaîne

CustomizeInvitation

Affiche des champs pour un message d'invitation personnalisé et une URL de redirection.

Propriété	Valeur
Obligatoire	faux
Valeur par défaut	Faux
Type	Booléen

InvitationMessage

Texte inclus dans l'e-mail d'invitation.

Propriété	Valeur
Obligatoire	faux
Valeur par défaut
Type	Chaîne

InviteRedirectUrl

Page sur laquelle l'invité arrive après avoir accepté, par exemple un site SharePoint.

Propriété	Valeur
Obligatoire	faux
Valeur par défaut
Type	Chaîne

UsageLocation

Code pays à deux lettres, par exemple US ou DE, requis avant que des licences puissent être attribuées.

Propriété	Valeur
Obligatoire	faux
Valeur par défaut
Type	Chaîne

Retour à la vue d’ensemble de la référence du runbook