> 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 os detalhes do perfil, grupos e definições da caixa de correio deste utilizador

### Descrição

Atualiza o perfil deste usuário no Entra ID, como nome, empresa, endereço, cargo e gestor. Também pode adicionar o usuário a um grupo de licença e a outros grupos, habilitar o arquivo do Exchange Online e redefinir a senha. Apenas os campos preenchidos são alterados; um nome de exibição ou empresa ausente é preenchido automaticamente.

### Ofereça locais, empresas, licenças e departamentos como modelos

A maioria dos campos deste runbook é texto livre. Com os modelos de personalização do runbook, o operador escolhe de listas predefinidas em vez disso, e um modelo de local pode preencher e bloquear todo o bloco de endereço. O exemplo abaixo define esses modelos e os vincula aos campos do runbook:

```json
"Templates": {
    "Options": [
        {
            "$id": "LocationOptions",
            "$values": [
                {
                    "Exibição": "Contoso DE",
                    "Valor": "ContosoDe",
                    "Customization": {
                        "Default": {
                            "StreetAddress": "Demostr. 22",
                            "PostalCode": "80333",
                            "City": "Munique",
                            "State": "Baviera",
                            "Country": "Alemanha",
                            "UsageLocation": "DE"
                        },
                        "ReadOnly": [
                            "StreetAddress",
                            "PostalCode",
                            "City",
                            "País",
                            "Localização de uso"
                        ]
                    }
                }
            ]
        },
        {
            "$id": "CompanyOptions",
            "$values": [
                {
                    "Exibição": "CONTOSO",
                    "Valor": "Contoso"
                }
            ]
        },
        {
            "$id": "LicenseOptions",
            "$values": [
                {
                    "Exibição": "Microsoft 365 E3 + E5 Security + Conferência de Áudio",
                    "Valor": "LIC_M365_E3&E5_SecurityPlan&AudioConf"
                },
                {
                    "Exibição": "nenhum",
                    "Valor": ""
                }
            ]
        },
        {
            "$id": "DepartmentOptions",
            "$values": [
                {
                    "Exibição": "Fusões e Aquisições",
                    "Valor": "M&A"
                },
                {
                    "Exibição": "Fiscal e Jurídico",
                    "Valor": "Tax & Legal"
                },
                {
                    "Exibição": "Controlo e Operações",
                    "Valor": "Controlling & Operations"
                },
                {
                    "Exibição": "TI",
                    "Valor": "IT"
                },
                {
                    "Exibição": "Comunicações",
                    "Valor": "Communications"
                },
                {
                    "Exibição": "Estratégia e Gestão",
                    "Valor": "Strategy & Management"
                },
                {
                    "Exibição": "Contabilidade",
                    "Valor": "Accounting"
                },
                {
                    "Exibição": "Seguros",
                    "Valor": "Insurance"
                },
                {
                    "Exibição": "Tesouraria",
                    "Valor": "Treasury"
                }
            ]
        }
    ]
},
"Runbooks": {
    "rjgit-user_userinfo_update-user": {
        "ParameterList": [
            {
                "Nome": "LocationName",
                "DisplayName": "Office Location",
                "Exibir antes": "StreetAddress",
                "Select": {
                    "Options": {
                        "$ref": "LocationOptions"
                    }
                },
                "Padrão": "ContosoDe"
            },
            {
                "Name": "CompanyName",
                "Select": {
                    "Options": {
                        "$ref": "CompanyOptions"
                    },
                    "AllowEdit": false
                },
                "Padrão": "Contoso"
            },
            {
                "Nome": "DefaultLicense",
                "Nome de exibição": "License",
                "Select": {
                    "Options": {
                        "$ref": "LicenseOptions"
                    },
                    "Permitir edição": true
                },
                "Padrão": "LIC_M365_E3&E5_SecurityPlan&AudioConf"
            },
            {
                "Nome": "Department",
                "Select": {
                    "Options": {
                        "$ref": "DepartmentOptions"
                    },
                    "Permitir edição": true
                }
            },
            {
                "Nome": "Redefinir senha",
                "Hide": true
            },
            {
                "Nome": "Grupos padrão",
                "Padrão": "app - 7-Zip,app - Adobe Reader DC Continuous Track,app - glueckkanja-gab KONNEKT"
            }
        ]
    }
}
```

Para mais informações sobre como personalizar runbooks, consulte o [Guia de Personalização de Runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### Localização

Usuário → Informações do usuário → Atualizar usuário

**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.10)<br>ExchangeOnlineManagement (>= 3.9.2)</p> |
| Agendável           | não                                                                               |

### Permissões

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

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

#### funções RBAC

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

### Parâmetros

#### Nome de utilizador

Nome principal do utilizador sobre o qual o runbook atua. Definido pelo portal a partir do utilizador selecionado.

| Propriedade       | Valor                                                  |
| ----------------- | ------------------------------------------------------ |
| Obrigatório       | verdadeiro                                             |
| Valor predefinido |                                                        |
| Tipo              | Cadeia de caracteres                                   |
| Oculto no portal  | sim (predefinido através da personalização do runbook) |

#### GivenName

Novo primeiro nome.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Nome próprio         |

#### Surname

Novo sobrenome.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Apelido              |

#### DisplayName

Novo nome de exibição conforme mostrado no Microsoft 365.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Nome apresentado     |

#### CompanyName

Empresa a que o utilizador pertence.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Empresa              |

#### Cidade

Cidade do endereço do usuário.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### País

País do endereço do usuário.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### JobTitle

Cargo mostrado no perfil.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Cargo                |

#### Departamento

Departamento em que o utilizador trabalha.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### Localização do escritório

Escritório ou edifício onde o usuário trabalha.

| Propriedade                | Valor                 |
| -------------------------- | --------------------- |
| Obrigatório                | falso                 |
| Valor predefinido          |                       |
| Tipo                       | Cadeia de caracteres  |
| Nome de exibição do portal | Localização do Office |

#### PostalCode

Código postal do endereço do usuário.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Código postal        |

#### Idioma preferido

Código de idioma, como en-US ou de-DE.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Idioma preferido     |

#### Estado

Estado ou região do endereço do usuário.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### StreetAddress

Rua e número do endereço do usuário.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Morada               |

#### UsageLocation

Código de país com duas letras que determina que licenças o utilizador pode obter, por exemplo DE.

| Propriedade                | Valor                     |
| -------------------------- | ------------------------- |
| Obrigatório                | falso                     |
| Valor predefinido          |                           |
| Tipo                       | Cadeia de caracteres      |
| Nome de exibição do portal | Localização de utilização |

#### ManagerId

Usuário que se torna o gestor deste usuário.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Gestor               |

#### DefaultLicense

Nome de exibição do grupo que atribui a licença; o usuário é adicionado a ele.

| Propriedade                | Valor                       |
| -------------------------- | --------------------------- |
| Obrigatório                | falso                       |
| Valor predefinido          |                             |
| Tipo                       | Cadeia de caracteres        |
| Nome de exibição do portal | Grupo de licença a atribuir |

#### DefaultGroups

Nomes de exibição dos grupos aos quais o usuário é adicionado, separados por vírgulas.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | falso                |
| Valor predefinido          |                      |
| Tipo                       | Cadeia de caracteres |
| Nome de exibição do portal | Grupos a adicionar   |

#### EnableEXOArchive

Ativa a caixa de correio de arquivo do Exchange Online para o usuário.

| Propriedade                | Valor                                 |
| -------------------------- | ------------------------------------- |
| Obrigatório                | falso                                 |
| Valor predefinido          | Falso                                 |
| Tipo                       | Booleano                              |
| Nome de exibição do portal | Ativar a caixa de correio de arquivo? |

#### Redefinir senha

Define uma senha inicial gerada, mostrada na saída, que deve ser alterada no próximo início de sessão. É ignorado quando o usuário já tem métodos MFA.

| Propriedade                | Valor              |
| -------------------------- | ------------------ |
| Obrigatório                | falso              |
| Valor predefinido          | Falso              |
| Tipo                       | Booleano           |
| Nome de exibição do portal | Redefinir a senha? |

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