> 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/general/offboard-user-temporarily.md).

# Benutzer vorübergehend offboarden

Diesen Benutzer vorübergehend offboarden

### Beschreibung

Offboardet diesen Benutzer vorübergehend, zum Beispiel wegen Elternzeit oder eines Sabbaticals. Die Anmeldung wird blockiert, Lizenzen und Gruppen werden angepasst, und die Gruppenmitgliedschaften können exportiert werden, bevor sie geändert werden. Gruppenbesitz, direkte Unterstellte und Sponsoring-Verhältnisse von Gästen können an eine Ersatzperson übergeben werden. Das Konto selbst bleibt bestehen.

### Die Offboarding-Richtlinie über Tenant-Einstellungen vorbelegen

Die meisten Schalter dieses Runbooks werden durch Tenant-Einstellungen gesteuert, sodass eine Organisation ihre Offboarding-Richtlinie einmalig festlegen und die entsprechenden Felder vor den Operatoren verbergen kann. Das folgende Beispiel belegt jeden Schalter vor und blendet die Felder aus; behalten Sie nur die Felder, die die Operatoren pro Lauf noch entscheiden sollen.

```json
{
    "Settings": {
        "OffboardUserTemporarily": {
            "userTypeRestriction": 0,
            "disableUser": true,
            "revokeAccess": true,
            "exportGroupMemberships": true,
            "licensesMode": 0,
            "groupsMode": 0,
            "groupToAdd": "",
            "groupsToRemovePrefix": "",
            "replaceManagerReferences": true,
            "replaceSponsorReferences": true
        },
        "RJReport": {
            "StorageAccount": {
                "ResourceGroup": "rj-test-runbooks-01",
                "StorageAccountName": "rjrbexports01",
                "LinkExpiryDays": 6
            }
        }
    },
    "Runbooks": {
        "rjgit-user_general_offboard-user-temporarily": {
            "ParameterList": [
                { "Name": "UserTypeSelector", "Hide": true },
                { "Name": "DisableUser", "Hide": true },
                { "Name": "RevokeAccess", "Hide": true },
                { "Name": "ChangeLicensesSelector", "Hide": true },
                { "Name": "ChangeGroupsSelector", "Hide": true },
                { "Name": "GroupToAdd", "Hide": true },
                { "Name": "GroupsToRemovePrefix", "Hide": true },
                { "Name": "CallerName", "Hide": true }
            ]
        }
    }
}
```

Bedeutung der Einstellungen:

* `userTypeRestriction`: `0` erlaubt alle Benutzertypen, `1` nur Mitglieder, `2` nur Gäste. Ein nicht passender Benutzer stoppt den Lauf vor jeglicher Änderung.
* `disableUser`, `revokeAccess`: blockiert die Anmeldung und beendet die Sitzungen des Benutzers.
* `exportGroupMemberships`: exportiert die Gruppenmitgliedschaften in den Storage Account für Berichte (siehe `RJReport.StorageAccount`) und gibt einen Download-Link zurück, bevor Gruppen und Lizenzen geändert werden.
* `licensesMode`: `0` behält die direkt zugewiesenen Lizenzen, `2` entfernt alle davon.
* `groupsMode`: `0` behält die Gruppen, `1` entfernt die Gruppen, die mit `groupsToRemovePrefix`, `2` beginnen, entfernt alle Gruppen. Beide `1` und `2` fügen hinzu oder behalten `groupToAdd`.
* `replaceManagerReferences`, `replaceSponsorReferences`: übergibt die direkten Unterstellten und Sponsoring-Verhältnisse des Benutzers an die Ersatzperson.

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

### Speicherort

Benutzer → Allgemein → Benutzer vorübergehend offboarden

**Voller Runbook-Name**

rjgit-user\_general\_offboard-user-temporarily

### Details

| Eigenschaft          | Wert                                                                                                                                                      |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Version              | 1.1.0                                                                                                                                                     |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)<br>ExchangeOnlineManagement (>= 3.9.2)</p> |
| Planbar              | nein                                                                                                                                                      |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * User.ReadWrite.All
    * *Deaktiviert die Anmeldung, widerruft Sitzungen, entfernt direkt zugewiesene Lizenzen und ersetzt Manager- und Sponsor-Referenzen*
  * Group.ReadWrite.All
    * *Liest Gruppen und überträgt oder entfernt die Gruppenbesitze des Benutzers*
  * GroupMember.ReadWrite.All
    * *Fügt Gruppenmitgliedschaften hinzu und entfernt sie während der Gruppenbereinigung*
* **Typ**: Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *Öffnet die app-only Exchange Online-Sitzung, die verwendet wird, um den Benutzer aus Verteilungsgruppen zu entfernen*

#### Hinweise zu Berechtigungen

Azure Storage Account: Die Rolle "Reader and Data Access" für die verwaltete Identität des Automation Account auf dem Ziel-Storage Account – der Upload ruft die Kontoschlüssel über listKeys ab (nur erforderlich, wenn exportGroupMemberships verwendet wird)

#### RBAC-Rollen

* Benutzeradministrator
  * *Erforderlich, damit Schreibvorgänge auf Benutzer auch bei Benutzern mit Rollen erfolgreich sind*
* Exchange-Administrator
  * *Erforderlich für die Exchange Online-Sitzung im App-only-Modus, die Verteilungsgruppenmitgliedschaften entfernt*

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

#### UserTypeSelector

Wird nur für den gewählten Benutzertyp ausgeführt: alle Benutzer, nur Mitglieder oder nur Gäste. Bei einer Abweichung stoppt der Lauf vor jeder Änderung.

| Eigenschaft           | Wert                              |
| --------------------- | --------------------------------- |
| Erforderlich          | falsch                            |
| Standardwert          | 0                                 |
| Typ                   | Int32                             |
| Anzeigename im Portal | Auf einen Benutzertyp beschränken |

**Portaloptionen**

| Portaloption                                       | Wert |
| -------------------------------------------------- | ---- |
| Alle Benutzertypen zulassen (Mitglieder und Gäste) | 0    |
| Nur Mitglieder                                     | 1    |
| Nur Gäste                                          | 2    |

#### Benutzer deaktivieren

Verhindert die Anmeldung des Kontos.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | falsch   |
| Standardwert | Wahr     |
| Typ          | Boolesch |

#### RevokeAccess

Beendet die aktiven Sitzungen des Benutzers und macht seine Refresh-Tokens ungültig.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | falsch   |
| Standardwert | Wahr     |
| Typ          | Boolesch |

#### exportGroupMemberships

Exportiert die Gruppenmitgliedschaften des Benutzers in eine Datei und gibt vor der Änderung von Gruppen und Lizenzen einen Download-Link zurück. Entnommen aus der Tenant-Einstellung OffboardUserTemporarily.exportGroupMemberships.

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

#### ContainerName

Storage-Container, in den der Export hochgeladen wird. Pro Runbook festgelegt.

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

#### ResourceGroupName

Ressourcengruppe des Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.ResourceGroup übernommen.

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

#### StorageAccountName

Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.StorageAccountName übernommen.

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

#### LinkExpiryDays

Anzahl der Tage, die ein Downloadlink gültig bleibt. Aus der Tenant-Einstellung RJReport.StorageAccount.LinkExpiryDays übernommen.

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

#### ChangeLicensesSelector

Bei „Alles entfernen“ wird jede direkt zugewiesene Lizenz entfernt; von Gruppen geerbte Lizenzen bleiben erhalten.

| Eigenschaft           | Wert                        |
| --------------------- | --------------------------- |
| Erforderlich          | falsch                      |
| Standardwert          | 0                           |
| Typ                   | Int32                       |
| Anzeigename im Portal | Direkt zugewiesene Lizenzen |

**Portaloptionen**

| Portaloption                                | Wert |
| ------------------------------------------- | ---- |
| Zugewiesene Lizenzen nicht ändern           | 0    |
| Alle direkt zugewiesenen Lizenzen entfernen | 2    |

#### ChangeGroupsSelector

Die Option „Gruppen mit dem Präfix entfernen“ entfernt die Gruppen, deren Name mit diesem Präfix beginnt, „Alle Gruppen entfernen“ entfernt jede Gruppe. Beide fügen die Gruppe unter „Gruppe zum Hinzufügen oder Beibehalten“ hinzu oder belassen sie dort. Dynamische, rollenzuweisbare und lokale Gruppen werden übersprungen und aufgelistet.

| Eigenschaft           | Wert                    |
| --------------------- | ----------------------- |
| Erforderlich          | falsch                  |
| Standardwert          | 0                       |
| Typ                   | Int32                   |
| Anzeigename im Portal | Gruppenmitgliedschaften |

**Portaloptionen**

| Portaloption                     | Wert |
| -------------------------------- | ---- |
| Zugewiesene Gruppen nicht ändern | 0    |
| Gruppen mit dem Präfix entfernen | 1    |
| Alle Gruppen entfernen           | 2    |

#### GroupToAdd

Gruppe, die der Benutzer nach dem Offboarding weiterhin benötigt, zum Beispiel eine Leaver-Lizenzgruppe. Sie wird hinzugefügt, wenn sie fehlt, und nie entfernt.

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

#### GroupsToRemovePrefix

Gruppen, deren Name mit diesem Text beginnt, werden entfernt, zum Beispiel LIC\_ für alle Lizenzgruppen. Nur mit „Gruppen mit dem Präfix entfernen“ verwendet.

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

#### RevokeGroupOwnership

Entfernen oder Ersetzen entzieht dem Benutzer die Gruppenbesitze. Wenn dieser Benutzer der letzte Besitzer ist, übernimmt die Ersatzperson; ohne Ersatzperson wird die Gruppe für die manuelle Nachverfolgung aufgelistet. Beibehalten lässt die Besitze unverändert.

| Eigenschaft           | Wert           |
| --------------------- | -------------- |
| Erforderlich          | falsch         |
| Standardwert          | Falsch         |
| Typ                   | Boolesch       |
| Anzeigename im Portal | Gruppenbesitze |

**Portaloptionen**

| Portaloption                                      | Wert   |
| ------------------------------------------------- | ------ |
| Die Besitze des Benutzers beibehalten             | falsch |
| Die Besitze des Benutzers entfernen oder ersetzen | wahr   |

#### ManagerAsReplacementOwner

Verwendet den Manager des Benutzers aus Entra ID als Ersatz-Eigentümer, Manager und Sponsor. Wenn ein Manager gesetzt ist, wird er anstelle der „Ersatzperson“ verwendet.

| Eigenschaft           | Wert                                |
| --------------------- | ----------------------------------- |
| Erforderlich          | falsch                              |
| Standardwert          | Wahr                                |
| Typ                   | Boolesch                            |
| Anzeigename im Portal | Manager als Ersatzperson verwenden? |

#### ReplacementOwnerName

Person, die Besitzrechte, direkte Unterstellte und Sponsoring-Verhältnisse übernimmt, wenn der Manager nicht verwendet wird oder dieser Benutzer keinen hat.

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

#### ReplaceManagerReferences

Setzt die Ersatzperson als Manager aller Personen, die diesem Benutzer unterstellt sind. Ohne Ersatzperson werden diese Benutzer nur aufgelistet.

| Eigenschaft           | Wert                               |
| --------------------- | ---------------------------------- |
| Erforderlich          | falsch                             |
| Standardwert          | Falsch                             |
| Typ                   | Boolesch                           |
| Anzeigename im Portal | Manager der direkten Unterstellten |

**Portaloptionen**

| Portaloption                                                          | Wert   |
| --------------------------------------------------------------------- | ------ |
| Diesen Benutzer als Manager seiner direkten Unterstellten beibehalten | falsch |
| Die Ersatzperson als Manager der direkten Unterstellten festlegen     | wahr   |

#### ReplaceSponsorReferences

Ersetzt diesen Benutzer überall dort als Sponsor, wo er als solcher hinterlegt ist, typischerweise bei Gastbenutzern. Ohne Ersatzperson werden diese Benutzer nur aufgelistet. Über eine Gruppe gehaltene Sponsoring-Verhältnisse bleiben bestehen. Dies durchsucht alle Benutzer des Tenant.

| Eigenschaft           | Wert               |
| --------------------- | ------------------ |
| Erforderlich          | falsch             |
| Standardwert          | Falsch             |
| Typ                   | Boolesch           |
| Anzeigename im Portal | Sponsor von Gästen |

**Portaloptionen**

| Portaloption                                              | Wert   |
| --------------------------------------------------------- | ------ |
| Diesen Benutzer als Sponsor beibehalten                   | falsch |
| Diesen Benutzer als Sponsor von (Gast-)Benutzern ersetzen | wahr   |

[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/general/offboard-user-temporarily.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.