> 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/es/automatizacion/runbooks/runbook-references/org/applications/delete-gsa-application-registration.md).

# Eliminar registro de aplicación Gsa

### Descripción

Este runbook elimina un registro de aplicación de Global Secure Access creado por el runbook "add-gsa-application-registration", incluida toda la configuración aprovisionada con él: la aplicación (y, por tanto, su Service Principal, los segmentos de aplicación y la asignación del grupo de conectores) y el Security Group creado por el esquema de nomenclatura.

El grupo del esquema de nomenclatura se identifica a través de los grupos asignados a la aplicación cuyo nombre para mostrar coincide con el prefijo de grupo definido por el administrador. Si el grupo se creó pero nunca se asignó (aprovisionamiento parcial), se realiza una búsqueda de mejor esfuerzo según el esquema de nomenclatura.

Medidas de seguridad:

* El runbook verifica que la aplicación sea realmente una aplicación GSA / App Proxy (onPremisesPublishing) antes de eliminar nada.
* De forma predeterminada, solo se eliminan los Security Group(s) que coinciden con el esquema de nomenclatura. Los demás grupos asignados a la aplicación se enumeran, pero NO se eliminan, ya que pueden compartirse con otras aplicaciones. Establezca deleteAllAssignedGroups para cambiar esto.

### Ubicación

Organización → Aplicaciones → Eliminar registro de aplicación de GSA

**Nombre completo del runbook**

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

### Detalles

| Propiedad          | Valor                                                                                   |
| ------------------ | --------------------------------------------------------------------------------------- |
| Versión            | 1.2.2                                                                                   |
| Módulos requeridos | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Microsoft.Graph.Authentication (>= 2.39.0)</p> |
| Programable        | no                                                                                      |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * Application.ReadWrite.All
    * *Encuentra la aplicación de Global Secure Access, verifica onPremisesPublishing y la elimina mediante DELETE /applications/{id}*
  * Group.ReadWrite.All
    * *Encuentra los grupos de acceso del esquema de nomenclatura de la aplicación y elimina los grupos asignados o huérfanos*

### Parámetros

#### applicationName

El nombre para mostrar completo de la aplicación GSA que se va a eliminar, por ejemplo, "GSA-MyApp".

| Propiedad                        | Valor                                                                     |
| -------------------------------- | ------------------------------------------------------------------------- |
| Requerido                        | true                                                                      |
| Valor predeterminado             |                                                                           |
| Tipo                             | Cadena                                                                    |
| Nombre para mostrar en el portal | Nombre de la aplicación (nombre para mostrar completo, p. ej., GSA-MyApp) |

#### groupPrefix

Prefijo del esquema de nomenclatura del Security Group, usado para identificar los grupos que se van a eliminar. Debe coincidir con el groupPrefix del runbook add-gsa-application-registration. Predeterminado: "App - Entra - GSA - ".

| Propiedad            | Valor                                                    |
| -------------------- | -------------------------------------------------------- |
| Requerido            | falso                                                    |
| Valor predeterminado | App - Entra - GSA -                                      |
| Tipo                 | Cadena                                                   |
| Oculto en el portal  | sí (preestablecido mediante personalización del runbook) |

#### groupSuffix

Sufijo opcional del esquema de nomenclatura del Security Group. Predeterminado: vacío.

| Propiedad            | Valor                                                    |
| -------------------- | -------------------------------------------------------- |
| Requerido            | falso                                                    |
| Valor predeterminado |                                                          |
| Tipo                 | Cadena                                                   |
| Oculto en el portal  | sí (preestablecido mediante personalización del runbook) |

#### deleteAllAssignedGroups

Si es true, se eliminan TODOS los grupos asignados a la aplicación, no solo los grupos del esquema de nomenclatura. Úsese con cuidado: los grupos asignados pueden compartirse con otras aplicaciones. Predeterminado: false.

| Propiedad                        | Valor                                                                                                      |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Requerido                        | falso                                                                                                      |
| Valor predeterminado             | Falso                                                                                                      |
| Tipo                             | Booleano                                                                                                   |
| Nombre para mostrar en el portal | Eliminar también TODOS los demás grupos asignados a la aplicación (cuidado: los grupos pueden compartirse) |

[Volver a la vista general de la referencia del runbook](/es/automatizacion/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/es/automatizacion/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.
