> 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/user/userinfo/update-user.md).

# Atualizar utilizador

Atualizar metadados e associações de utilizadores

### Descrição

Atualiza as propriedades do perfil do utilizador no Microsoft Entra ID e aplica associações de grupos opcionais e definições do Exchange Online. Este runbook é normalmente usado para finalizar a integração ou para corrigir os metadados do utilizador.

### Localização

Utilizador → Userinfo → Atualizar utilizador

**Nome completo do runbook**

rjgit-user\_userinfo\_update-user

### Detalhes

| Propriedade         | Valor                                                                            |
| ------------------- | -------------------------------------------------------------------------------- |
| Versão              | 1.0.2                                                                            |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>ExchangeOnlineManagement (>= 3.9.2)</p> |
| Agendável           | não                                                                              |

### Permissões

#### Permissões de aplicação

* **Tipo**: Microsoft Graph
  * UserAuthenticationMethod.Read.All
    * *Lê os métodos de MFA registados do utilizador para ignorar a redefinição da palavra-passe se existir MFA*
* **Tipo**: Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *Abre a sessão do Exchange Online apenas para a aplicação usada para grupos de distribuição e para ativar o arquivo online*

#### funções RBAC

* Administrador de Utilizadores
  * *Reverte as atualizações do perfil, a redefinição da palavra-passe, a atribuição do gestor e as adições a grupos*
* Administrador do Exchange
  * *Necessário para a sessão do Exchange Online apenas para a aplicação que gere grupos de distribuição e o arquivo online*

### Parâmetros

#### Nome de usuário

Nome principal de usuário do usuário de destino.

| Propriedade      | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Obrigatório      | verdadeiro                                      |
| Valor padrão     |                                                 |
| Tipo             | String                                          |
| Oculto no portal | sim (predefinido via personalização do runbook) |

#### GivenName

Nome próprio a definir para o utilizador.

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

#### Surname

Apelido a definir para o utilizador.

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

#### DisplayName

Nome a apresentar a definir para o utilizador.

| Propriedade                | Valor       |
| -------------------------- | ----------- |
| Obrigatório                | falso       |
| Valor padrão               |             |
| Tipo                       | String      |
| Nome de exibição no portal | DisplayName |

#### CompanyName

Nome da empresa a definir para o utilizador.

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

#### Cidade

Cidade a definir para o utilizador.

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

#### País

País a definir para o utilizador.

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

#### JobTitle

Cargo a definir para o utilizador.

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

#### Department

Departamento a definir para o utilizador.

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

#### OfficeLocation

Localização do Office a definir para o utilizador.

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

#### PostalCode

Código postal a definir para o utilizador.

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

#### Idioma preferido

Idioma preferido a definir para o utilizador. Exemplos: "en-US" ou "de-DE".

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

#### Estado

Estado a definir para o utilizador.

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

#### StreetAddress

Morada a definir para o utilizador.

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

#### UsageLocation

Localização de utilização a definir para o utilizador.

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

#### ManagerId

ID opcional do utilizador gestor a definir para o utilizador.

| Propriedade                | Valor  |
| -------------------------- | ------ |
| Obrigatório                | falso  |
| Valor padrão               |        |
| Tipo                       | String |
| Nome de exibição no portal | Gestor |

#### DefaultLicense

Nome de apresentação de um grupo de licenças a atribuir.

| Propriedade                | Valor                        |
| -------------------------- | ---------------------------- |
| Obrigatório                | falso                        |
| Valor padrão               |                              |
| Tipo                       | String                       |
| Nome de exibição no portal | Grupo de licenças a atribuir |

#### DefaultGroups

Lista de nomes de apresentação de grupos, separados por vírgulas, a atribuir.

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

#### EnableEXOArchive

Se definido como verdadeiro, ativa a caixa de correio de arquivo do Exchange Online.

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

#### Repor palavra-passe

Se definido como verdadeiro, repõe a palavra-passe do utilizador.

| Propriedade  | Valor    |
| ------------ | -------- |
| Obrigatório  | falso    |
| Valor padrão | 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 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/automatizacao/runbooks/runbook-references/user/userinfo/update-user.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.
