> 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 Principals que possuem uma função integrada do Entra ID, também através de elegibilidade PIM ou de um grupo atribuível a funções, como um relatório de administrador para função. Opcionalmente, os métodos de autenticação de cada administrador são verificados para mostrar quem está protegido por MFA. O relatório pode ser carregado como CSV para uma Storage Account do Azure. Nada é alterado. A execução falha quando as atribuições de função ou os membros de um grupo atribuível a funções não podem ser lidos, ou quando o carregamento falha.

### 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.3.0                                                                                                              |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Agendável           | não                                                                                                                |

### Permissões

#### Permissões de aplicativo

* **Tipo**: Microsoft Graph
  * Directory.Read.All
    * *Resolve os IDs dos principais detentores da função para utilizadores, grupos ou Service Principals através de /directoryObjects e lista os membros dos grupos atribuíveis a funções que detêm uma função*
  * RoleAssignmentSchedule.Read.Directory
    * *Lê roleAssignmentScheduleInstances para reportar as datas de fim das atribuições PIM*
  * RoleManagement.Read.All
    * *Lista definições de funções, atribuições de funções e programações de elegibilidade PIM*
  * User.Read.All
    * *Lê os detalhes de utilizador dos detentores da função ao resolver os principais*
  * UserAuthenticationMethod.Read.All *(opcional — funcionalidade: estado de MFA)*
    * *Lê os métodos de autenticação de cada administrador quando QueryMfaState está ativado (ativado por predefinição)*

#### Notas de permissão

Azure Storage Account: função 'Reader and Data Access' para a identidade gerida da Automation Account na Storage Account de destino - o carregamento obtém as chaves da conta através de listKeys (necessário apenas para o carregamento CSV)

### Parâmetros

#### Exportar para ficheiro

Carrega o relatório como CSV para a Storage Account configurada nas definições do Tenant.

| Propriedade  | Valor      |
| ------------ | ---------- |
| Obrigatório  | falso      |
| Valor padrão | Verdadeiro |
| Tipo         | Booleano   |

#### PimEligibleUntilInCSV

Adiciona as datas de fim das atribuições elegíveis e ativas de PIM ao relatório CSV.

| Propriedade  | Valor    |
| ------------ | -------- |
| Obrigatório  | falso    |
| Valor padrão | Falso    |
| Tipo         | Booleano |

#### ContainerName

Contentor de armazenamento para o qual os ficheiros do relatório são carregados. Obtido a partir da definição do Tenant ListAdminsReport.Container; caso contrário, definido por runbook.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ResourceGroupName

Grupo de recursos da Storage Account para carregamentos do relatório. Obtido a partir da definição do Tenant ListAdminsReport.ResourceGroup; quando não está definido, é usado RJReport.StorageAccount.ResourceGroup.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### StorageAccountName

Storage Account para carregamentos do relatório. Obtido a partir da definição do Tenant ListAdminsReport.StorageAccount.Name; quando não está definido, é usado RJReport.StorageAccount.StorageAccountName.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### SubscriptionId

ID da subscrição do Storage Account indicado em ResourceGroupName e StorageAccountName. Não é obtido de uma definição do Tenant; quando estiver vazio, é usada a subscrição na qual a identidade gerida inicia sessão.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### StorageAccountLocation

Já não é usado, porque a Storage Account já não é criada. Mantido para que os agendamentos e chamadas de API existentes continuem a iniciar; um valor passado apenas adiciona um aviso de descontinuação à execução.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### StorageAccountSku

Já não é usado, porque a Storage Account já não é criada. Mantido para que os agendamentos e chamadas de API existentes continuem a iniciar; um valor passado apenas adiciona um aviso de descontinuação à execução.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### QueryMfaState

Com a verificação, cada administrador obtém 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. Os administradores cujos métodos não podem ser lidos são listados como não verificáveis.

| Propriedade  | Valor      |
| ------------ | ---------- |
| Obrigatório  | falso      |
| Valor padrão | 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 estados de MFA                               | falso      |

#### TrustEmailMfa

Conta o e-mail como um método de MFA válido.

| Propriedade  | Valor    |
| ------------ | -------- |
| Obrigatório  | falso    |
| Valor padrão | Falso    |
| Tipo         | Booleano |

#### TrustPhoneMfa

Conta chamadas telefónicas e SMS como um método de MFA válido.

| Propriedade  | Valor    |
| ------------ | -------- |
| Obrigatório  | falso    |
| Valor padrão | Falso    |
| Tipo         | Booleano |

#### TrustSoftwareOathMfa

Conta tokens OATH de software como um método de MFA válido. Tokens OATH de hardware contam sempre.

| Propriedade  | Valor      |
| ------------ | ---------- |
| Obrigatório  | falso      |
| Valor padrão | Verdadeiro |
| Tipo         | Booleano   |

#### TrustWinHelloMFA

Conta Windows Hello for Business como um método de MFA válido. A credencial de plataforma do macOS Platform SSO conta sempre.

| Propriedade  | Valor    |
| ------------ | -------- |
| Obrigatório  | falso    |
| Valor padrão | Falso    |
| Tipo         | Booleano |

#### RJReportResourceGroupName

Grupo de recursos da Storage Account para carregamentos do relatório. Obtido a partir da definição do Tenant RJReport.StorageAccount.ResourceGroup e usado quando ListAdminsReport.ResourceGroup não está definido.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### RJReportStorageAccountName

Storage Account para carregamentos do relatório. Vem da definição do Tenant RJReport.StorageAccount.StorageAccountName e é usada quando ListAdminsReport.StorageAccount.Name não está definido.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### RJReportSubscriptionId

ID da subscrição da Storage Account para carregamentos de relatórios. Obtido da definição do Tenant RJReport.StorageAccount.SubscriptionId e usado quando a Storage Account provém de RJReport.StorageAccount.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### LinkExpiryDays

Número de dias que um link de download permanece válido. Obtido da configuração do Tenant RJReport.StorageAccount.LinkExpiryDays.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | 6                                                       |
| Tipo             | Int32                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

[Voltar à visão geral da referência do runbook](https://docs.realmjoin.com/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=<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.
