> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/org/general/invite-external-guest-users.md).
# Inviter des utilisateurs invités externes
### Description
Ce runbook invite un utilisateur externe en tant qu'utilisateur invité dans Microsoft Entra ID. Des propriétés de profil facultatives telles que le prénom, le nom de famille, le nom de l'entreprise, l'emplacement d'utilisation, le gestionnaire et le parrain peuvent être définies après l'acceptation de l'invitation. L'utilisateur invité peut éventuellement être ajouté à un groupe spécifié.
### 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 |
### Notes
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 être laissés vides
* Intégration complète : fournissez tous les champs facultatifs pour définir les propriétés du profil, attribuer un gestionnaire/parrain et ajouter à un groupe en une seule exécution
Interactions des paramètres :
* Les propriétés de profil (givenName, surname, companyName, usageLocation) sont appliquées uniquement lorsqu'elles ne sont pas vides ; leur omission ignore complètement l'appel PATCH
* L'attribution du gestionnaire et du parrain ainsi que l'appartenance au groupe nécessitent chacun leurs paramètres respectifs ; tout est ignoré silencieusement lorsqu'ils ne sont pas fournis
### 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
#### Courriel de l'utilisateur invité
Adresse e-mail de l'utilisateur invité à inviter.
| Propriété | Valeur |
| ----------------- | -------------------- |
| Obligatoire | vrai |
| Valeur par défaut | |
| Type | Chaîne de caractères |
#### Nom d'affichage de l'utilisateur invité
Nom d'affichage de l'utilisateur invité.
| Propriété | Valeur |
| ----------------- | -------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne de caractères |
#### ID du groupe
L'ID d'objet du groupe auquel ajouter l'utilisateur invité. Si non spécifié, l'utilisateur ne sera ajouté à aucun groupe.
| Propriété | Valeur |
| ----------------- | -------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne de caractères |
#### Prénom
Prénom de l'utilisateur invité.
| Propriété | Valeur |
| ----------------- | -------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne de caractères |
#### Nom
Nom de famille de l'utilisateur invité.
| Propriété | Valeur |
| ----------------- | -------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne de caractères |
#### Nom de l’entreprise
Nom de l'entreprise de l'utilisateur invité.
| Propriété | Valeur |
| ----------------- | -------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne de caractères |
#### Nom du gestionnaire
Gestionnaire à attribuer à l'utilisateur invité. Sélectionnez un utilisateur dans l'annuaire.
| Propriété | Valeur |
| ----------------- | -------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne de caractères |
#### Nom du parrain
Parrain à attribuer à l'utilisateur invité. Sélectionnez un utilisateur dans l'annuaire.
| Propriété | Valeur |
| ----------------- | -------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne de caractères |
#### Personnaliser l'invitation
Activez cette option pour personnaliser le message d'invitation et l'URL de redirection.
| Propriété | Valeur |
| ----------------- | ------- |
| Obligatoire | faux |
| Valeur par défaut | Faux |
| Type | Booléen |
#### Message d'invitation
Corps du message personnalisé à inclure dans l'e-mail d'invitation. Utilisé uniquement lorsque Personnaliser l'invitation est activé.
| Propriété | Valeur |
| ----------------- | -------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne de caractères |
#### URL de redirection de l'invitation
URL personnalisée vers laquelle l'utilisateur est redirigé après avoir accepté l'invitation. Utilisée uniquement lorsque Personnaliser l'invitation est activé.
| Propriété | Valeur |
| ----------------- | -------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne de caractères |
#### Emplacement d’utilisation
Code pays ISO 3166-1 alpha-2 pour l'emplacement d'utilisation de l'utilisateur invité (par exemple « US », « DE »).
| Propriété | Valeur |
| ----------------- | -------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne de caractères |
[Retour à l’aperçu de la référence du runbook](/fr/automatisation/runbooks/runbook-references.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/org/general/invite-external-guest-users.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.