> 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

Meldet diesen Benutzer endgültig ab: Der Zugriff wird entzogen, das Konto wird deaktiviert oder gelöscht, Lizenzen und Gruppen werden angepasst, und die Gruppenmitgliedschaften können vor der Ä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 vorkonfigurieren

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 verbergen kann. Das folgende Beispiel legt jeden Schalter vorab fest und blendet die Felder aus; behalten Sie nur die Felder, die die Operatoren pro Lauf 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",
                "SubscriptionId": "00000000-0000-0000-0000-000000000000",
                "LinkExpiryDays": 6
            }
        }
    },
    "Runbooks": {
        "rjgit-user_general_offboard-user-permanently": {
            "ParameterList": [
                { "Name": "Benutzertyp-Auswahl", "Hide": true },
                { "Name": "Benutzer deaktivieren", "Hide": true },
                { "Name": "Zugriff entziehen", "Hide": true },
                { "Name": "Auswahl zur Lizenzänderung", "Hide": true },
                { "Name": "Auswahl zur Gruppenänderung", "Hide": true },
                { "Name": "Zu hinzufügende Gruppe", "Hide": true },
                { "Name": "Präfix der zu entfernenden Gruppen", "Hide": true },
                { "Name": "Name des Aufrufers", "Hide": true }
            ]
        }
    }
}
```

Bedeutung der Einstellungen:

* `userTypeRestriction`: `0` erlaubt alle Benutzertypen, `1` nur Mitglieder, `2` nur Gäste. Bei einem Mismatch wird der Lauf vor jeder Änderung gestoppt.
* `deleteUser`: das Konto löschen (`wahr`) oder behalten (`falsch`).
* `disableUser`, `revokeAccess`: blockiert die Anmeldung und beendet die Sitzungen des Benutzers.
* `exportGroupMemberships`: exportiert die Gruppenmitgliedschaften in den Report-Storage Account (siehe `RJReport.StorageAccount`) und gibt vor der Änderung von Gruppen und Lizenzen einen Download-Link zurück.
* `licensesMode`: `0` behält die direkt zugewiesenen Lizenzen, `2` entfernt alle.
* `groupsMode`: `0` behält die Gruppen, `1` entfernt die Gruppen, die mit `groupsToRemovePrefix`, `2` beginnen, entfernt alle Gruppen. Beide `1` und `2` hinzufügen oder beibehalten `groupToAdd`.
* `replaceManagerReferences`, `replaceSponsorReferences`: übergibt die direkt unterstellten Personen und Sponsoring des Benutzers an die Ersatzperson.

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

### Ort

Benutzer → Allgemein → Benutzer dauerhaft abmelden

**Vollständiger Runbook-Name**

rjgit-user\_general\_offboard-user-permanently

### Details

| Eigenschaft          | Wert                                                                                                                                                      |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Version              | 1.3.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 Verweise auf Manager und Sponsor und löscht das Benutzerobjekt*
  * Group.ReadWrite.All
    * *Liest Gruppen und überträgt oder entfernt die Gruppenbesitzrechte des Benutzers*
  * GroupMember.ReadWrite.All
    * *Fügt während der Gruppenbereinigung Gruppenmitgliedschaften hinzu und entfernt sie*
* **Typ**: Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *Öffnet die nur für die App verwendete 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 Accounts im Ziel-Storage Account - der Upload ruft die Account-Schlüssel über listKeys ab (nur erforderlich, wenn exportGroupMemberships verwendet wird)

#### RBAC-Rollen

* Benutzeradministrator
  * *Erforderlich, damit die reine App-Identität die Anmeldung blockieren, Sitzungen widerrufen und den Benutzer löschen kann*
* Exchange-Administrator
  * *Erforderlich für die nur für die App verwendete Exchange-Online-Sitzung zum Entfernen von Verteilergruppenmitgliedschaften*

### Parameter

#### Benutzername

Der Benutzerprinzipalname des Benutzers, für den das Runbook ausgeführt wird. Vom Portal anhand des ausgewählten Benutzers festgelegt.

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

#### Benutzertyp-Auswahl

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

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

#### DeleteUser

Löschen entfernt das Benutzerobjekt. Beibehalten lässt das Konto bestehen; was damit geschieht, richtet sich nach 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 |

#### DisableUser

Blockiert die Anmeldung des Kontos.

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

#### Zugriff entziehen

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

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

#### exportGroupMemberships

Exportiert die Gruppenmitgliedschaften des Benutzers vor der Änderung von Gruppen und Lizenzen in eine Datei und gibt einen Downloadlink zurück. Übernommen aus der Tenant-Einstellung OffboardUserPermanently.exportGroupMemberships.

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

#### ContainerName

Speichercontainer, in den der Export hochgeladen wird. Pro Runbook festlegen.

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

#### ResourceGroupName

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

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

#### StorageAccountName

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

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

#### SubscriptionId

Abonnement-ID des Storage Account für Bericht-Uploads. Wird aus der Tenant-Einstellung RJReport.StorageAccount.SubscriptionId übernommen; wenn leer, wird das Abonnement verwendet, bei dem sich die verwaltete Identität anmeldet.

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

#### LinkExpiryDays

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

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

#### Auswahl zur Lizenzänderung

Alle entfernen entzieht jede direkt zugewiesene Lizenz; 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    |

#### Auswahl zur Gruppenänderung

Gruppen mit dem Präfix entfernen entfernt die durch das Präfix benannten Gruppen, Alle Gruppen entfernen entfernt jede Gruppe. Beide fügen die Gruppe unter "Zu hinzufügende oder beizubehaltende Gruppe" 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    |

#### Zu hinzufügende Gruppe

Gruppe, die der Benutzer nach dem Offboarding noch benötigt, zum Beispiel eine Leaver-Lizenzgruppe. Sie wird hinzugefügt, wenn sie fehlt, und nie 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. Wird nur mit "Gruppen mit dem Präfix entfernen" verwendet.

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

#### Gruppenbesitz entziehen

Entfernen oder Ersetzen entzieht dem Benutzer die Gruppenbesitzrechte. Wenn dieser Benutzer der letzte Besitzer ist, übernimmt die Ersatzperson; ohne Ersatzperson wird die Gruppe zur manuellen Nachverfolgung aufgelistet. Beibehalten lässt die Besitzrechte, wie sie sind.

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

**Portaloptionen**

| Portaloption                                           | Wert   |
| ------------------------------------------------------ | ------ |
| Die Besitzrechte des Benutzers beibehalten             | 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, direkt unterstellte Personen und Sponsoring ü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 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 direkt unterstellter Personen |

**Portaloptionen**

| Portaloption                                                                 | Wert   |
| ---------------------------------------------------------------------------- | ------ |
| Diesen Benutzer als Manager seiner direkt unterstellten Personen beibehalten | falsch |
| Die Ersatzperson als Manager der direkt unterstellten Personen festlegen     | wahr   |

#### Sponsor-Verweise ersetzen

Ersetzt diesen Benutzer überall als Sponsor, wo er als solcher gesetzt ist, typischerweise bei Gastbenutzern. Ohne Ersatzperson werden diese Benutzer nur aufgelistet. Über eine Gruppe gehaltenes Sponsoring bleibt bestehen. Dies durchsucht alle Benutzer im 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 Übersicht der Runbook-Referenz zurück](https://docs.realmjoin.com/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.
