> 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

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, la société, l’emplacement d’utilisation, le manager et le sponsor 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 manager et un sponsor, et ajouter l’invité à un groupe en une seule exécution.

### Interactions des paramètres

* 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 manager, l’attribution du sponsor et l’appartenance au groupe nécessitent chacun leurs paramètres respectifs ; tous sont 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 | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| 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 manager et le sponsor*
  * Group.ReadWrite.All
    * *Vérifie le groupe cible et ajoute l’invité via /groups/{id}/members/$ref*
  * Organization.Read.All
    * *Lit l’identifiant 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 l’annuaire.

| 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

Société pour laquelle l’invité travaille.

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

#### ManagerName

Utilisateur qui devient le manager de l’invité.

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

#### SponsorName

Utilisateur enregistré comme sponsor 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 de pouvoir attribuer des licences.

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

[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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/org/general/invite-external-guest-users.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.