> 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/de/automatisierung/runbooks/runbook-references/org/general/invite-external-guest-users.md).

# Externe Gastbenutzer einladen

### Beschreibung

Dieses Runbook lädt einen externen Benutzer als Gastbenutzer in Microsoft Entra ID ein. Optionale Profileigenschaften wie Vorname, Nachname, Firmenname, Nutzungsort, Manager und Sponsor können nach Annahme der Einladung festgelegt werden. Der eingeladene Benutzer kann optional zu einer angegebenen Gruppe hinzugefügt werden.

### Ort

Organisation → Allgemein → Externe Gastbenutzer einladen

**Vollständiger Runbook-Name**

rjgit-org\_general\_Invite-external-guest-users

### Details

| Eigenschaft          | Wert                                                                                    |
| -------------------- | --------------------------------------------------------------------------------------- |
| Version              | 2.0.3                                                                                   |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Microsoft.Graph.Authentication (>= 2.39.0)</p> |
| Planbar              | nein                                                                                    |

### Hinweise

Häufige Anwendungsfälle:

* Einfache Gast-Einladung: nur E-Mail-Adresse und Anzeigename angeben; alle Profil- und Gruppenparameter können leer bleiben
* Vollständiges Onboarding: alle optionalen Felder bereitstellen, um Profileigenschaften festzulegen, einen Manager/Sponsor zuzuweisen und den Benutzer in einem einzigen Durchlauf zu einer Gruppe hinzuzufügen

Parameterwechselwirkungen:

* Profileigenschaften (givenName, surname, companyName, usageLocation) werden nur angewendet, wenn sie nicht leer sind; beim Weglassen wird der PATCH-Aufruf vollständig übersprungen
* Die Zuweisung von Manager und Sponsor sowie die Gruppenmitgliedschaft erfordern jeweils die entsprechenden Parameter; alles wird stillschweigend übersprungen, wenn es nicht angegeben wird

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * User.ReadWrite.All
    * *Erstellt die Einladung, aktualisiert die Gast-Profil-Eigenschaften und legt Manager und Sponsor fest*
  * Group.ReadWrite.All
    * *Überprüft die Zielgruppe und fügt den Gast über /groups/{id}/members/$ref hinzu*
  * Organization.Read.All
    * *Liest die Tenant-ID, um die standardmäßige Weiterleitungs-URL für Einladungen zu erstellen*

### Parameter

#### InvitedUserEmail

E-Mail-Adresse des einzuladenden Gastbenutzers.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | wahr         |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### InvitedUserDisplayName

Anzeigename des Gastbenutzers.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### GroupId

Die Objekt-ID der Gruppe, zu der der Gastbenutzer hinzugefügt werden soll. Wenn nicht angegeben, wird der Benutzer keiner Gruppe hinzugefügt.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### GivenName

Vorname des Gastbenutzers.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### Surname

Nachname des Gastbenutzers.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### CompanyName

Firmenname des Gastbenutzers.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### ManagerName

Manager, der dem Gastbenutzer zugewiesen werden soll. Wählen Sie einen Benutzer aus dem Verzeichnis aus.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### SponsorName

Sponsor, der dem Gastbenutzer zugewiesen werden soll. Wählen Sie einen Benutzer aus dem Verzeichnis aus.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### CustomizeInvitation

Aktivieren, um die Einladungsnachricht und die Weiterleitungs-URL anzupassen.

| Eigenschaft  | Wert            |
| ------------ | --------------- |
| Erforderlich | falsch          |
| Standardwert | Falsch          |
| Typ          | Boolescher Wert |

#### InvitationMessage

Benutzerdefinierter Nachrichtentext, der in die Einladungs-E-Mail aufgenommen wird. Nur verwendet, wenn CustomizeInvitation aktiviert ist.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### InviteRedirectUrl

Benutzerdefinierte URL, zu der der Benutzer nach Annahme der Einladung weitergeleitet wird. Nur verwendet, wenn CustomizeInvitation aktiviert ist.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### UsageLocation

ISO-3166-1-Alpha-2-Ländercode für den Nutzungsort des Gastbenutzers (z. B. "US", "DE").

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | falsch       |
| Standardwert |              |
| Typ          | Zeichenfolge |

[Zurück zur Übersicht der Runbook-Referenz](/de/automatisierung/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/de/automatisierung/runbooks/runbook-references/org/general/invite-external-guest-users.md?ask=<question>&goal=<endgoal>
```

`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.