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

# Benutzer aktualisieren

Aktualisieren Sie die Profildetails, Gruppen und Postfacheinstellungen dieses Benutzers

### Beschreibung

Aktualisiert das Profil dieses Benutzers in Entra ID, z. B. Name, Unternehmen, Adresse, Stellenbezeichnung und Manager. Es kann den Benutzer außerdem einer Lizenzgruppe und weiteren Gruppen hinzufügen, das Exchange Online-Archiv aktivieren und das Kennwort zurücksetzen. Nur die von Ihnen ausgefüllten Felder werden geändert; ein fehlender Anzeigename oder ein fehlendes Unternehmen wird automatisch ergänzt.

### Standorte, Unternehmen, Lizenzen und Abteilungen als Vorlagen anbieten

Die meisten Felder dieses Runbooks sind Freitext. Mit Runbook-Anpassungsvorlagen wählt der Operator stattdessen aus vordefinierten Listen aus, und eine Standortvorlage kann den gesamten Adressblock ausfüllen und sperren. Das folgende Beispiel definiert solche Vorlagen und bindet sie an die Felder des Runbooks:

```json
"Templates": {
    "Options": [
        {
            "$id": "LocationOptions",
            "$values": [
                {
                    "Display": "Contoso DE",
                    "Value": "ContosoDe",
                    "Customization": {
                        "Default": {
                            "StreetAddress": "Demostr. 22",
                            "PostalCode": "80333",
                            "City": "München",
                            "State": "Bayern",
                            "Country": "Deutschland",
                            "UsageLocation": "DE"
                        },
                        "ReadOnly": [
                            "StreetAddress",
                            "PostalCode",
                            "City",
                            "Country",
                            "UsageLocation"
                        ]
                    }
                }
            ]
        },
        {
            "$id": "CompanyOptions",
            "$values": [
                {
                    "Display": "CONTOSO",
                    "Value": "Contoso"
                }
            ]
        },
        {
            "$id": "LicenseOptions",
            "$values": [
                {
                    "Display": "M365 E3 + E5 Security + Audiokonferenzen",
                    "Value": "LIC_M365_E3&E5_SecurityPlan&AudioConf"
                },
                {
                    "Display": "keine",
                    "Value": ""
                }
            ]
        },
        {
            "$id": "DepartmentOptions",
            "$values": [
                {
                    "Display": "M&A",
                    "Value": "M&A"
                },
                {
                    "Display": "Steuern & Recht",
                    "Value": "Steuern & Recht"
                },
                {
                    "Display": "Controlling & Betrieb",
                    "Value": "Controlling & Betrieb"
                },
                {
                    "Display": "IT",
                    "Value": "IT"
                },
                {
                    "Display": "Kommunikation",
                    "Value": "Kommunikation"
                },
                {
                    "Display": "Strategie & Management",
                    "Value": "Strategie & Management"
                },
                {
                    "Display": "Rechnungswesen",
                    "Value": "Rechnungswesen"
                },
                {
                    "Display": "Versicherung",
                    "Value": "Versicherung"
                },
                {
                    "Display": "Treasury",
                    "Value": "Treasury"
                }
            ]
        }
    ]
},
"Runbooks": {
    "rjgit-user_userinfo_update-user": {
        "ParameterList": [
            {
                "Name": "LocationName",
                "DisplayName": "Office-Standort",
                "DisplayBefore": "StreetAddress",
                "Select": {
                    "Options": {
                        "$ref": "LocationOptions"
                    }
                },
                "Default": "ContosoDe"
            },
            {
                "Name": "CompanyName",
                "Select": {
                    "Options": {
                        "$ref": "CompanyOptions"
                    },
                    "AllowEdit": false
                },
                "Default": "Contoso"
            },
            {
                "Name": "DefaultLicense",
                "DisplayName": "Lizenz",
                "Select": {
                    "Options": {
                        "$ref": "LicenseOptions"
                    },
                    "AllowEdit": true
                },
                "Default": "LIC_M365_E3&E5_SecurityPlan&AudioConf"
            },
            {
                "Name": "Department",
                "Select": {
                    "Options": {
                        "$ref": "DepartmentOptions"
                    },
                    "AllowEdit": true
                }
            },
            {
                "Name": "ResetPassword",
                "Hide": true
            },
            {
                "Name": "DefaultGroups",
                "Default": "app - 7-Zip,app - Adobe Reader DC Continuous Track,app - glueckkanja-gab KONNEKT"
            }
        ]
    }
}
```

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

### Speicherort

Benutzer → Benutzerinfo → Benutzer aktualisieren

**Voller Runbook-Name**

rjgit-user\_userinfo\_update-user

### Details

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * UserAuthenticationMethod.Read.All
    * *Liest die registrierten MFA-Methoden des Benutzers aus, um das Zurücksetzen des Kennworts zu überspringen, wenn MFA vorhanden ist*
* **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 Profilaktualisierungen, das Zurücksetzen des Kennworts, die Managerzuweisung und das Hinzufügen zu Gruppen.*
* Exchange-Administrator
  * *Erforderlich für die Nur-App-Exchange Online-Sitzung zur Verwaltung von Verteilungsgruppen und des Online-Archivs*

### Parameter

#### Benutzername

Benutzerprinzipalname des Benutzers, auf den das Runbook angewendet wird. Wird vom Portal aus dem ausgewählten Benutzer gesetzt.

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

#### GivenName

Neuer Vorname.

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

#### Nachname

Neuer Nachname.

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

#### DisplayName

Neuer Anzeigename, wie er in Microsoft 365 angezeigt wird.

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

#### CompanyName

Firma, zu der der Benutzer gehört.

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

#### Stadt

Stadt der Adresse des Benutzers.

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

#### Land

Land der Adresse des Benutzers.

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

#### JobTitle

Stellenbezeichnung, die im Profil angezeigt wird.

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

#### OfficeLocation

Office oder Gebäude, an dem der Benutzer arbeitet.

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

#### PostalCode

Postleitzahl der Adresse des Benutzers.

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

#### PreferredLanguage

Sprachcode wie en-US oder de-DE.

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

#### Bundesland

Bundesland oder Region der Adresse des Benutzers.

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

#### StreetAddress

Straße und Hausnummer der Adresse des Benutzers.

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

#### 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  |

#### ManagerId

Benutzer, der zum Manager dieses Benutzers wird.

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

#### DefaultLicense

Anzeigename der Gruppe, die die Lizenz zuweist; der Benutzer wird ihr hinzugefügt.

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

#### DefaultGroups

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

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

#### EnableEXOArchive

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

| Eigenschaft           | Wert                           |
| --------------------- | ------------------------------ |
| Erforderlich          | falsch                         |
| Standardwert          | Falsch                         |
| Typ                   | Boolesch                       |
| Anzeigename im Portal | Das Archivpostfach aktivieren? |

#### ResetPassword

Setzt ein generiertes Startkennwort, das in der Ausgabe angezeigt wird und beim nächsten Anmelden geändert werden muss. Wird übersprungen, wenn der Benutzer bereits MFA-Methoden hat.

| Eigenschaft           | Wert                       |
| --------------------- | -------------------------- |
| Erforderlich          | falsch                     |
| Standardwert          | Falsch                     |
| Typ                   | Boolesch                   |
| Anzeigename im Portal | Das Kennwort zurücksetzen? |

[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/user/userinfo/update-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.