> 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/applications/delete-gsa-application-registration.md).

# GSA-Anwendungsregistrierung löschen

### Beschreibung

Dieses Runbook löscht eine Global Secure Access-Anwendungsregistrierung, die vom Runbook "add-gsa-application-registration" erstellt wurde, einschließlich allem, was damit bereitgestellt wurde: die Anwendung (und damit ihren Service Principal, Anwendungssegmente und die Connector-Gruppenzuweisung) sowie die Security Group, die durch das Benennungsschema erstellt wurde.

Die Gruppe des Benennungsschemas wird anhand der der Anwendung zugewiesenen Gruppen identifiziert, deren Anzeigename mit dem vom Administrator definierten Gruppenpräfix übereinstimmt. Wenn die Gruppe erstellt, aber nie zugewiesen wurde (teilweise Bereitstellung), wird eine Best-Effort-Suche anhand des Benennungsschemas durchgeführt.

Sicherheitsmaßnahmen:

* Das Runbook überprüft, dass die Anwendung tatsächlich eine GSA-/App-Proxy-Anwendung (onPremisesPublishing) ist, bevor irgendetwas gelöscht wird.
* Standardmäßig werden nur Security Group(s), die dem Benennungsschema entsprechen, gelöscht. Andere der Anwendung zugewiesene Gruppen werden aufgelistet, aber NICHT gelöscht, da sie mit anderen Anwendungen geteilt werden können. Setzen Sie deleteAllAssignedGroups, um dies zu ändern.

### Ort

Organisation → Anwendungen → GSA-Anwendungsregistrierung löschen

**Vollständiger Runbook-Name**

rjgit-org\_applications\_delete-GSA-application-registration

### Details

| Eigenschaft          | Wert                                                                                    |
| -------------------- | --------------------------------------------------------------------------------------- |
| Version              | 1.2.2                                                                                   |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Microsoft.Graph.Authentication (>= 2.39.0)</p> |
| Planbar              | nein                                                                                    |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * Application.ReadWrite.All
    * *Findet die Global Secure Access-App, überprüft onPremisesPublishing und löscht sie über DELETE /applications/{id}*
  * Group.ReadWrite.All
    * *Findet die Zugriffsgruppen der App gemäß dem Benennungsschema und löscht zugewiesene oder verwaiste Gruppen*

### Parameter

#### applicationName

Der vollständige Anzeigename der zu löschenden GSA-Anwendung, z. B. "GSA-MyApp".

| Eigenschaft           | Wert                                                        |
| --------------------- | ----------------------------------------------------------- |
| Erforderlich          | wahr                                                        |
| Standardwert          |                                                             |
| Typ                   | Zeichenfolge                                                |
| Anzeigename im Portal | Anwendungsname (vollständiger Anzeigename, z. B. GSA-MyApp) |

#### groupPrefix

Präfix des Security Group-Benennungsschemas, das zur Identifizierung der zu löschenden Gruppe(n) verwendet wird. Muss mit dem groupPrefix des add-gsa-application-registration-Runbooks übereinstimmen. Standard: "App - Entra - GSA - ".

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

#### groupSuffix

Optionales Suffix des Benennungsschemas für Sicherheitsgruppen. Standard: leer.

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

#### deleteAllAssignedGroups

Wenn wahr, werden ALLE der Anwendung zugewiesenen Gruppen gelöscht, nicht nur die Gruppe(n) des Benennungsschemas. Mit Vorsicht verwenden - zugewiesene Gruppen können mit anderen Anwendungen geteilt werden. Standard: false.

| Eigenschaft           | Wert                                                                                                  |
| --------------------- | ----------------------------------------------------------------------------------------------------- |
| Erforderlich          | falsch                                                                                                |
| Standardwert          | Falsch                                                                                                |
| Typ                   | Boolescher Wert                                                                                       |
| Anzeigename im Portal | Auch ALLE anderen der Anwendung zugewiesenen Gruppen löschen (Vorsicht - Gruppen können geteilt sein) |

[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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/applications/delete-gsa-application-registration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.