> 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-permanently.md).

# Benutzer dauerhaft offboarden

Diesen Benutzer dauerhaft offboarden

### Beschreibung

Entfernt diesen Benutzer endgültig: Der Zugriff wird widerrufen, das Konto wird deaktiviert oder gelöscht, Lizenzen und Gruppen werden angepasst, und die Gruppenmitgliedschaften können vor ihrer Änderung exportiert werden. Gruppenbesitz, direkte Unterstellte und Sponsorings von Gästen können an eine Ersatzperson übergeben werden. Ein gelöschtes Konto kann nur 30 Tage lang wiederhergestellt werden.

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

Die meisten Schalter dieses Runbooks werden durch Tenant-Einstellungen gesteuert, sodass eine Organisation ihre Offboarding-Richtlinie einmal festlegen und die entsprechenden Felder vor den Operatoren ausblenden kann. Das folgende Beispiel setzt jeden Schalter vorein und blendet die Felder aus; behalten Sie nur die Felder, die die Operatoren pro Ausführung noch entscheiden sollen.

```json
{
    "Settings": {
        "OffboardUserPermanently": {
            "userTypeRestriction": 0,
            "deleteUser": true,
            "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-permanently": {
            "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:

* `Benutzertyp-Einschränkung`: `0` erlaubt alle Benutzertypen, `1` nur Mitglieder, `2` nur Gäste. Ein nicht passender Benutzer stoppt den Lauf vor jeder Änderung.
* `Benutzer löschen`: das Konto löschen (`wahr`) oder behalten (`falsch`).
* `Benutzer deaktivieren`, `Zugriff widerrufen`: die Anmeldung blockieren und die Sitzungen des Benutzers beenden.
* `Gruppenmitgliedschaften exportieren`: exportiert die Gruppenmitgliedschaften in das Storage Account für Berichte (siehe `RJReport.StorageAccount`) und gibt vor der Änderung von Gruppen und Lizenzen einen Download-Link zurück.
* `Lizenzen-Modus`: `0` behält die direkt zugewiesenen Lizenzen, `2` entfernt alle davon.
* `Gruppenmodus`: `0` behält die Gruppen, `1` entfernt die Gruppen, die mit `Gruppen-Entfernungspräfix`, `2` entfernt alle Gruppen. Beide `1` und `2` hinzufügen oder behalten `Gruppe zum Hinzufügen`.
* `Manager-Verweise ersetzen`, `Sponsor-Verweise ersetzen`: übergibt die direkten Unterstellten und Sponsorings 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 dauerhaft offboarden

**Voller Runbook-Name**

rjgit-user\_general\_offboard-user-permanently

### Details

| Eigenschaft          | Wert                                                                                                                                                      |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Version              | 1.2.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 Lizenzen, ersetzt Manager- und Sponsor-Verweise und löscht das Benutzerobjekt*
  * Group.ReadWrite.All
    * *Liest Gruppen aus und überträgt oder entfernt die Gruppenbesitzrechte 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 Verteilergruppen zu entfernen*

#### Hinweise zu Berechtigungen

Azure Storage Account: 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 die app-only Identität die Anmeldung blockieren, Sitzungen widerrufen und den Benutzer löschen kann*
* Exchange-Administrator
  * *Erforderlich für die app-only Exchange Online-Sitzung, die Gruppenmitgliedschaften in Verteilergruppen 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) |

#### Benutzertyp-Auswahl

Wird nur für den ausgewä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 löschen

Löschen entfernt das Benutzerobjekt. Behalten lässt das Konto bestehen; was damit geschieht, folgt den anderen Schaltern.

| Eigenschaft           | Wert                        |
| --------------------- | --------------------------- |
| Erforderlich          | falsch                      |
| Standardwert          | Falsch                      |
| Typ                   | Boolesch                    |
| Anzeigename im Portal | Konto löschen oder behalten |

**Portaloptionen**

| Portaloption   | Wert   |
| -------------- | ------ |
| Konto löschen  | wahr   |
| Konto behalten | falsch |

#### Benutzer deaktivieren

Blockiert die Anmeldung des Kontos.

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

#### Zugriff widerrufen

Beendet die aktiven Sitzungen des Benutzers und macht dessen Aktualisierungstoken ungültig.

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

#### Gruppenmitgliedschaften exportieren

Exportiert die Gruppenmitgliedschaften des Benutzers in eine Datei und gibt vor der Änderung von Gruppen und Lizenzen einen Download-Link zurück. Übernommen aus der Tenant-Einstellung OffboardUserPermanently.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 festlegen.

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

#### Lizenzauswahl

Bei „Alle 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    |

#### Gruppenauswahl

Bei „Gruppen mit dem Präfix entfernen“ werden die durch das Präfix benannten Gruppen entfernt, bei „Alle Gruppen entfernen“ jede Gruppe. Beide fügen die Gruppe unter „Gruppe zum Hinzufügen oder Behalten“ hinzu oder behalten 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    |

#### Gruppe zum Hinzufügen

Gruppe, die der Benutzer nach dem Offboarding weiterhin benötigt, zum Beispiel eine Lizenzgruppe für ausgeschiedene Benutzer. Sie wird hinzugefügt, wenn sie fehlt, und niemals entfernt.

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

#### Präfix der zu entfernenden Gruppen

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

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

#### Gruppenbesitz entziehen

Entfernen oder Ersetzen entzieht dem Benutzer den Gruppenbesitz. Wo dieser Benutzer der letzte Besitzer ist, übernimmt die Ersatzperson; ohne Ersatzperson wird die Gruppe zur manuellen Nachverfolgung aufgelistet. Behalten lässt die Besitzrechte unverändert.

| Eigenschaft           | Wert                |
| --------------------- | ------------------- |
| Erforderlich          | falsch              |
| Standardwert          | Wahr                |
| Typ                   | Boolesch            |
| Anzeigename im Portal | Gruppenbesitzrechte |

**Portaloptionen**

| Portaloption                                           | Wert   |
| ------------------------------------------------------ | ------ |
| Die Besitzrechte des Benutzers behalten                | falsch |
| Die Besitzrechte des Benutzers entfernen oder ersetzen | wahr   |

#### Manager als Ersatzbesitzer

Verwendet den Manager des Benutzers aus Entra ID als Ersatzbesitzer, 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 | Den Manager als Ersatz verwenden? |

#### Name der Ersatzperson

Person, die Besitzrechte, direkte Unterstellte und Sponsorings übernimmt, wenn der Manager nicht verwendet wird oder dieser Benutzer keinen hat.

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

#### Manager-Verweise ersetzen

Setzt die Ersatzperson als Manager von allen, 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 behalten | falsch |
| Die Ersatzperson als Manager der direkten Unterstellten festlegen  | wahr   |

#### Sponsor-Verweise ersetzen

Ersetzt diesen Benutzer überall dort als Sponsor, wo er als solcher gesetzt ist, typischerweise bei Gastbenutzern. Ohne Ersatzperson werden diese Benutzer nur aufgelistet. Über Gruppen gehaltene Sponsorings bleiben erhalten. 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 behalten                      | 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-permanently.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.