> 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/pt/automacao/runbooks/runbook-references/org/applications/delete-gsa-application-registration.md).
# Eliminar registo de aplicação GSA
Eliminar um registo de aplicação GSA do Azure AD, incluindo os objetos associados
### Descrição
Este runbook exclui um registro de aplicativo do Global Secure Access criado pelo runbook "add-gsa-application-registration", incluindo tudo provisionado com ele: o aplicativo (e, por conseguinte, seu Service Principal, segmentos do aplicativo e a atribuição do grupo de conectores) e o Security Group criado pelo esquema de nomenclatura.
O grupo do esquema de nomenclatura é identificado por meio dos grupos atribuídos ao aplicativo, cujo nome de exibição corresponde ao prefixo de grupo definido pelo administrador. Se o grupo foi criado, mas nunca atribuído (provisionamento parcial), é realizada uma busca por melhor esforço pelo esquema de nomenclatura.
Medidas de segurança:
* O runbook verifica se o aplicativo é realmente um aplicativo GSA / App Proxy (onPremisesPublishing) antes de excluir qualquer coisa.
* Por padrão, apenas os Security Group(s) correspondentes ao esquema de nomenclatura são excluídos. Outros grupos atribuídos ao aplicativo são listados, mas NÃO são excluídos, pois podem ser compartilhados com outros aplicativos. Defina deleteAllAssignedGroups para alterar isso.
### Localização
Organização → Aplicativos → Excluir registro de aplicativo GSA
**Nome completo do runbook**
rjgit-org\_applications\_delete-GSA-application-registration
### Detalhes
| Propriedade | Valor |
| ------------------- | --------------------------------------------------------------------------------------- |
| Versão | 1.2.2 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)
|
| Agendável | não |
### Permissões
#### Permissões de aplicação
* **Tipo**: Microsoft Graph
* Application.ReadWrite.All
* *Localiza o app do Global Secure Access, verifica onPremisesPublishing e o exclui via DELETE /applications/{id}*
* Group.ReadWrite.All
* *Localiza os grupos de acesso do esquema de nomenclatura do app e exclui grupos atribuídos ou órfãos*
### Parâmetros
#### applicationName
O nome de exibição completo do aplicativo GSA a ser excluído, por exemplo, "GSA-MyApp".
| Propriedade | Valor |
| -------------------------- | ---------------------------------------------------------------------- |
| Obrigatório | verdadeiro |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Nome do aplicativo (nome de exibição completo, por exemplo, GSA-MyApp) |
#### groupPrefix
Prefixo do esquema de nomenclatura do Security Group, usado para identificar o(s) grupo(s) a excluir. Deve corresponder ao groupPrefix do runbook add-gsa-application-registration. Padrão: "App - Entra - GSA - ".
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | App - Entra - GSA - |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### groupSuffix
Sufixo opcional do esquema de nomenclatura do Security Group. Padrão: vazio.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### deleteAllAssignedGroups
Se verdadeiro, TODOS os Security Group(s) atribuídos ao aplicativo são excluídos, não apenas o(s) Security Group(s) do esquema de nomenclatura. Use com cuidado - os grupos atribuídos podem ser compartilhados com outros aplicativos. Padrão: falso.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | Falso |
| Tipo | Booleano |
| Nome de exibição no portal | Também excluir TODOS os outros grupos atribuídos ao aplicativo (cuidado - os grupos podem ser compartilhados) |
[Voltar à visão geral da referência do runbook](/pt/automacao/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/pt/automacao/runbooks/runbook-references/org/applications/delete-gsa-application-registration.md?ask=&goal=
```
`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.