> 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/automatizacao/runbooks/runbook-references/org/security/list-admin-users.md).
# Listar utilizadores administradores
Listar todos os administradores do Entra ID e verificar os respetivos métodos de MFA
### Descrição
Lista todos os utilizadores e Service Principal que possuem uma função integrada do Entra ID, incluindo atribuições elegíveis para PIM, como um relatório de administrador para função. Opcionalmente, os métodos de autenticação registados de cada administrador são verificados para mostrar quem está protegido por MFA, com a opção de escolher quais métodos contam. O relatório pode ser carregado como CSV para uma Azure Storage Account. Nada é alterado.
### Localização
Organização → Segurança → Listar Utilizadores Administradores
**Nome completo do Runbook**
rjgit-org\_security\_list-admin-users
### Detalhes
| Propriedade | Valor |
| ------------------- | ---------------------------------------------------------------------------------------- |
| Versão | 1.2.4 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
|
| Agendável | não |
### Permissões
#### Permissões da aplicação
* **Tipo**: Microsoft Graph
* User.Read.All
* *Lê os detalhes do utilizador dos titulares de funções ao resolver principals*
* Directory.Read.All
* *Resolve os IDs de principal dos titulares de funções em utilizadores, grupos ou Service Principals através de /directoryObjects*
* RoleManagement.Read.All
* *Lista definições de funções, atribuições de funções e agendas de elegibilidade do PIM*
* RoleAssignmentSchedule.Read.Directory
* *Lê roleAssignmentScheduleInstances para indicar as datas de fim das atribuições do PIM*
* UserAuthenticationMethod.Read.All *(opcional — funcionalidade: estado de MFA)*
* *Lê os métodos de autenticação de cada administrador quando QueryMfaState está ativado (ativo por predefinição)*
### Parâmetros
#### ExportarParaFicheiro
Carrega o relatório como CSV para a Storage Account configurada nas definições do Tenant.
| Propriedade | Valor |
| ----------------- | ---------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
#### PimEligibleUntilInCSV
Adiciona as datas de fim das atribuições elegíveis e ativas do PIM ao relatório CSV.
| Propriedade | Valor |
| ----------------- | -------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
#### ContainerName
Contentor de armazenamento para onde os ficheiros do relatório são carregados. Obtido a partir da definição de Tenant ListAdminsReport.Container.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ResourceGroupName
Grupo de recursos da Storage Account. Obtido a partir da definição de Tenant ListAdminsReport.ResourceGroup.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### StorageAccountName
Storage Account para a exportação. Obtido a partir da definição de Tenant ListAdminsReport.StorageAccount.Name.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### StorageAccountLocation
Região do Azure usada quando a Storage Account tem de ser criada. Obtido a partir da definição de Tenant ListAdminsReport.StorageAccount.Location.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### StorageAccountSku
Nível de desempenho usado quando a Storage Account tem de ser criada. Obtido a partir da definição de Tenant ListAdminsReport.StorageAccount.Sku.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### QueryMfaState
Com a verificação, cada administrador recebe uma coluna que mostra se está registado um método que conta como MFA; sem ela, o relatório lista apenas as atribuições de funções.
| Propriedade | Valor |
| ----------------- | ---------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
**Opções do portal**
| Opção do portal | Valor |
| ---------------------------------------------------------- | ---------- |
| Verificar e reportar o estado de MFA de cada administrador | verdadeiro |
| Não verificar os estados de MFA | falso |
#### TrustEmailMfa
Conta o email como um método MFA válido.
| Propriedade | Valor |
| ----------------- | -------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
#### TrustPhoneMfa
Conta chamadas telefónicas e SMS como um método MFA válido.
| Propriedade | Valor |
| ----------------- | -------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
#### TrustSoftwareOathMfa
Conta tokens OATH de software como um método MFA válido.
| Propriedade | Valor |
| ----------------- | ---------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
#### TrustWinHelloMFA
Conta Windows Hello for Business como um método MFA válido.
| Propriedade | Valor |
| ----------------- | -------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
[Voltar à visão geral da referência do Runbook](/pt/automatizacao/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/pt/automatizacao/runbooks/runbook-references/org/security/list-admin-users.md?ask=&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.