> 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/add-user.md).

# Benutzer hinzufügen

Ein neues Benutzerkonto in Entra ID erstellen

### Beschreibung

Erstellt einen Cloud-Benutzer in Entra ID mit den üblichen Profildetails wie Name, Firma, Berufsbezeichnung, Manager, Sponsoren und Adresse. Anmeldename, Alias und Anzeigename werden aus dem Namen abgeleitet, wenn sie leer gelassen werden, und ein Startkennwort wird generiert, wenn keines angegeben wird. Optional erhält der Benutzer eine Lizenzgruppe, weitere Gruppen und ein Exchange Online-Archivpostfach.

### Standorte und Unternehmen als Vorlagen anbieten

Adressfelder und Firma sind standardmäßig Freitext. Mit Vorlagen zur Runbook-Anpassung wählt der Operator einen Office-Standort aus, wodurch der Adressblock ausgefüllt und gesperrt wird, und eine Firma aus einer Liste. Das folgende Beispiel definiert solche Vorlagen und bindet sie an die Felder des Runbooks:

```json
{
    "Templates": {
        "Options": [
            {
                "$id": "LocationOptions",
                "$values": [
                    {
                        "Display": "DE-OF",
                        "Customization": {
                            "Default": {
                                "StreetAddress": "Kaiserstraße 39",
                                "PostalCode": "63065",
                                "City": "Offenbach",
                                "Country": "Germany"
                            }
                        }
                    },
                    {
                        "Display": "DE-DEG",
                        "Customization": {
                            "Default": {
                                "StreetAddress": "Lateinschulgassse 24-26",
                                "PostalCode": "94469",
                                "City": "Deggendorf",
                                "Country": "Germany"
                            }
                        }
                    },
                    {
                        "Display": "DE-HH",
                        "Customization": {
                            "Default": {
                                "StreetAddress": "Hans-Henny-Jahnn-Weg 53",
                                "PostalCode": "22085",
                                "City": "Hamburg",
                                "Country": "Germany"
                            }
                        }
                    },
                    {
                        "Display": "FI-HS",
                        "Customization": {
                            "Default": {
                                "StreetAddress": "Somewhere 42",
                                "PostalCode": "12345",
                                "City": "Helsinki",
                                "Country": "Finland"
                            }
                        }
                    }
                ]
            },
            {
                "$id": "CompanyOptions",
                "$values": [
                    {
                        "Id": "gkg",
                        "Display": "glueckkanja-gab",
                        "Value": "glueckkanja-gab AG"
                    },
                    {
                        "Id": "pp",
                        "Display": "PrimePulse",
                        "Value": "PrimePulse AG"
                    }
                ]
            }
        ]
    },
    "Runbooks": {
        "rjgit-org_general_add-user": {
            "ParameterList": [
                {
                    "DisplayName": "Office-Standort",
                    "DisplayAfter": "CompanyName",
                    "Select": {
                        "Options": {
                            "$ref": "LocationOptions"
                        }
                    }
                },
                {
                    "Name": "CompanyName",
                    "Select": {
                        "Options": {
                            "$ref": "CompanyOptions"
                        },
                        "AllowEdit": false
                    }
                }
            ],
            "ReadOnly": [
                "StreetAddress",
                "PostalCode",
                "City",
                "Country"
            ]
        }
    }
}
```

Weitere Informationen zur Anpassung von Runbooks finden Sie im [Runbook-Anpassungsleitfaden](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### Speicherort

Organisation → Allgemein → Benutzer hinzufügen

**Voller Runbook-Name**

rjgit-org\_general\_add-user

### Details

| Eigenschaft          | Wert                                                                              |
| -------------------- | --------------------------------------------------------------------------------- |
| Version              | 1.0.1                                                                             |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>ExchangeOnlineManagement (>= 3.9.2)</p> |
| Planbar              | nein                                                                              |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *Öffnet die Nur-App-Exchange Online-Sitzung, die für Verteilungsgruppen und das Aktivieren des Online-Archivs verwendet wird*

#### RBAC-Rollen

* Benutzeradministrator
  * *Unterstützt das Erstellen des Benutzers, das Zuordnen von Manager, Sponsoren und Gruppen sowie das Auslesen der Lizenzdaten*
* Exchange-Administrator
  * *Erforderlich für die Nur-App-Exchange Online-Sitzung zur Verwaltung von Verteilungsgruppen und des Online-Archivs*

### Parameter

#### GivenName

Vorname des Benutzers.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | wahr         |
| Standardwert          |              |
| Typ                   | Zeichenfolge |
| Anzeigename im Portal | Vorname      |

#### Nachname

Nachname des Benutzers.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | wahr         |
| Standardwert          |              |
| Typ                   | Zeichenfolge |
| Anzeigename im Portal | Nachname     |

#### UserPrincipalName

Anmeldename des Benutzers. Wird aus dem Namen abgeleitet, wenn er leer ist.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### MailNickname

Alias des Postfachs. Wird aus dem Anmeldenamen abgeleitet, wenn er leer ist.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### DisplayName

Wird aus Vor- und Nachname abgeleitet, wenn leer.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### CompanyName

Firma, zu der der Benutzer gehört.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | falsch       |
| Standardwert          |              |
| Typ                   | Zeichenfolge |
| Anzeigename im Portal | Firma        |

#### JobTitle

Wird im Profil und im Adressbuch angezeigt.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | falsch       |
| Standardwert          |              |
| Typ                   | Zeichenfolge |
| Anzeigename im Portal | Jobtitel     |

#### Abteilung

Abteilung, in der der Benutzer arbeitet.

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

#### ManagerId

Benutzer, der zum Manager wird.

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

#### SponsorIds

Als Sponsoren des neuen Benutzers erfasste Benutzer. Es können mehrere ausgewählt werden.

| Eigenschaft  | Wert      |
| ------------ | --------- |
| Erforderlich | falsch    |
| Standardwert |           |
| Typ          | String\[] |

#### MobilePhone

Wird im Profil und im Adressbuch angezeigt.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | falsch       |
| Standardwert          |              |
| Typ                   | Zeichenfolge |
| Anzeigename im Portal | Mobiltelefon |

#### LocationName

Im Profil angezeigter Office-Standort. Mit Vorlagen aus der Runbook-Anpassung werden bei Auswahl auch die Adressfelder ausgefüllt.

| Eigenschaft           | Wert            |
| --------------------- | --------------- |
| Erforderlich          | falsch          |
| Standardwert          |                 |
| Typ                   | Zeichenfolge    |
| Anzeigename im Portal | Office-Standort |

#### StreetAddress

Teil der im Profil angezeigten Postanschrift. Wird beim Auswählen durch die Office-Standortvorlage ausgefüllt.

| Eigenschaft           | Wert           |
| --------------------- | -------------- |
| Erforderlich          | falsch         |
| Standardwert          |                |
| Typ                   | Zeichenfolge   |
| Anzeigename im Portal | Straßenadresse |

#### PostalCode

Teil der im Profil angezeigten Postanschrift. Wird beim Auswählen durch die Office-Standortvorlage ausgefüllt.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | falsch       |
| Standardwert          |              |
| Typ                   | Zeichenfolge |
| Anzeigename im Portal | Postleitzahl |

#### Stadt

Teil der im Profil angezeigten Postanschrift. Wird beim Auswählen durch die Office-Standortvorlage ausgefüllt.

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

#### Bundesland

Teil der im Profil angezeigten Postanschrift.

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

#### Land

Teil der im Profil angezeigten Postanschrift. Wird beim Auswählen durch die Office-Standortvorlage ausgefüllt.

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

#### UsageLocation

Zweistelliger Ländercode, der bestimmt, welche Lizenzen der Benutzer erhalten kann, z. B. DE.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | falsch       |
| Standardwert          |              |
| Typ                   | Zeichenfolge |
| Anzeigename im Portal | Nutzungsort  |

#### DefaultLicense

Anzeigename der Gruppe, die die Lizenz zuweist; der Benutzer wird ihr hinzugefügt. Leer lassen, wenn keine.

| Eigenschaft           | Wert                      |
| --------------------- | ------------------------- |
| Erforderlich          | falsch                    |
| Standardwert          |                           |
| Typ                   | Zeichenfolge              |
| Anzeigename im Portal | Zuzuordnende Lizenzgruppe |

#### DefaultGroups

Anzeigenamen weiterer Gruppen, denen der Benutzer hinzugefügt wird, durch Kommas getrennt.

| Eigenschaft           | Wert                   |
| --------------------- | ---------------------- |
| Erforderlich          | falsch                 |
| Standardwert          |                        |
| Typ                   | Zeichenfolge           |
| Anzeigename im Portal | Hinzuzufügende Gruppen |

#### InitialPassword

Startkennwort für den Benutzer. Leer lassen, damit eines generiert und in der Ausgabe angezeigt wird.

| Eigenschaft           | Wert          |
| --------------------- | ------------- |
| Erforderlich          | falsch        |
| Standardwert          |               |
| Typ                   | Zeichenfolge  |
| Anzeigename im Portal | Startkennwort |

#### EnableEXOArchive

Aktiviert das Exchange Online-Archivpostfach für den neuen Benutzer.

| Eigenschaft           | Wert                          |
| --------------------- | ----------------------------- |
| Erforderlich          | falsch                        |
| Standardwert          | Falsch                        |
| Typ                   | Boolesch                      |
| Anzeigename im Portal | Ein Archivpostfach erstellen? |

[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 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/de/automatisierung/runbooks/runbook-references/org/general/add-user.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.