Externe Gastbenutzer einladen

Eine externe Person als Gastbenutzer einladen

Beschreibung

Sendet eine Microsoft Entra ID-Gastseinladung an eine externe E-Mail-Adresse. Optional wird der Gast einer Gruppe hinzugefügt, und Profildetails wie Name, Firma, Nutzungsort, Manager und Sponsor werden sofort im Gastkonto festgelegt. Die Einladungs-E-Mail und die Landingpage können angepasst werden.

Häufige Anwendungsfälle

• Einfache Gast-Einladung: Geben Sie nur die E-Mail-Adresse und den Anzeigenamen an; alle Profil- und Gruppenparameter können leer bleiben.
• Vollständiges Onboarding: Geben Sie alle optionalen Felder an, um Profileigenschaften festzulegen, einen Manager und einen Sponsor zuzuweisen und den Gast in einem einzigen Durchlauf einer Gruppe hinzuzufügen.

Wechselwirkungen der Parameter

• Profileigenschaften (givenName, surname, companyName, usageLocation) werden nur angewendet, wenn sie nicht leer sind; werden sie weggelassen, wird der Aktualisierungsaufruf vollständig übersprungen.
• Manager-Zuweisung, Sponsor-Zuweisung und Gruppenmitgliedschaft erfordern jeweils ihre entsprechenden Parameter; alle werden stillschweigend übersprungen, wenn sie nicht angegeben sind.

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	RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)
Planbar	nein

Berechtigungen

Anwendungsberechtigungen

• Typ: Microsoft Graph

  • User.ReadWrite.All

    • Erstellt die Einladung, aktualisiert die Gast-Profileigenschaften und legt Manager und Sponsor fest
  • Group.ReadWrite.All

    • Prü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 Einladungs-Weiterleitungs-URL zu erstellen

Parameter

InvitedUserEmail

E-Mail-Adresse der einzuladenden Person.

Eigenschaft	Wert
Erforderlich	ja
Standardwert
Typ	Zeichenfolge

InvitedUserDisplayName

Im Verzeichnis angezeigter Name des Gasts.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge

GroupId

Gruppe, der der Gast hinzugefügt wird. In der Runbook-Anpassung voreingestellt; leer bedeutet keine.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge

GivenName

Vorname des Gasts.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge

Surname

Nachname des Gasts.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge

CompanyName

Firma, für die der Gast arbeitet.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge

ManagerName

Benutzer, der zum Manager des Gasts wird.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge

SponsorName

Benutzer, der als Sponsor des Gasts erfasst wird.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge

Einladung anpassen

Zeigt Felder für eine eigene Einladungsnachricht und eine Weiterleitungs-URL an.

Eigenschaft	Wert
Erforderlich	nein
Standardwert	Falsch
Typ	Boolesch

Einladungsnachricht

Text, der in der Einladungs-E-Mail enthalten ist.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge

Einladungs-Weiterleitungs-URL

Seite, auf der der Gast nach der Annahme landet, z. B. eine SharePoint-Website.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge

UsageLocation

Zweistelliger Ländercode, z. B. US oder DE, der erforderlich ist, bevor Lizenzen zugewiesen werden können.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge

Zurück zur Runbook-Reference-Übersicht