> 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/general/add-user.md).

# Adicionar utilizador

Criar uma nova conta de utilizador no Entra ID

### Descrição

Cria um usuário na nuvem no Entra ID com os detalhes usuais do perfil, como nome, empresa, cargo, gerente, patrocinadores e endereço. O nome de entrada, o alias e o nome de exibição são derivados do nome quando deixados em branco, e uma senha inicial é gerada quando nenhuma é fornecida. Opcionalmente, o usuário recebe um grupo de licença, outros grupos e uma caixa de correio de arquivo do Exchange Online.

### Ofereça localizações e empresas como modelos

Os campos de endereço e a empresa são texto livre por padrão. Com modelos de personalização do runbook, o operador escolhe uma localização do Office, que preenche e bloqueia o bloco de endereço, e uma empresa de uma lista. O exemplo abaixo define esses modelos e os vincula aos campos do runbook:

```json
{
    "Modelos": {
        "Opções": [
            {
                "$id": "LocationOptions",
                "$values": [
                    {
                        "Display": "DE-OF",
                        "Personalização": {
                            "Padrão": {
                                "StreetAddress": "Kaiserstraße 39",
                                "PostalCode": "63065",
                                "City": "Offenbach",
                                "Country": "Germany"
                            }
                        }
                    },
                    {
                        "Display": "DE-DEG",
                        "Personalização": {
                            "Padrão": {
                                "StreetAddress": "Lateinschulgassse 24-26",
                                "PostalCode": "94469",
                                "City": "Deggendorf",
                                "Country": "Germany"
                            }
                        }
                    },
                    {
                        "Display": "DE-HH",
                        "Personalização": {
                            "Padrão": {
                                "StreetAddress": "Hans-Henny-Jahnn-Weg 53",
                                "PostalCode": "22085",
                                "City": "Hamburg",
                                "Country": "Germany"
                            }
                        }
                    },
                    {
                        "Display": "FI-HS",
                        "Personalização": {
                            "Padrão": {
                                "StreetAddress": "Somewhere 42",
                                "PostalCode": "12345",
                                "City": "Helsinki",
                                "Country": "Finland"
                            }
                        }
                    }
                ]
            },
            {
                "$id": "CompanyOptions",
                "$values": [
                    {
                        "Id": "gkg",
                        "Display": "glueckkanja-gab",
                        "Value": "glueckkanja-gab AG"
                    },
                    {
                        "Id": "pp",
                        "Display": "PrimePulse",
                        "Value": "PrimePulse AG"
                    }
                ]
            }
        ]
    },
    "Runbooks": {
        "rjgit-org_general_add-user": {
            "ParameterList": [
                {
                    "DisplayName": "Localização do Office",
                    "DisplayAfter": "CompanyName",
                    "Select": {
                        "Options": {
                            "$ref": "LocationOptions"
                        }
                    }
                },
                {
                    "Name": "CompanyName",
                    "Select": {
                        "Options": {
                            "$ref": "CompanyOptions"
                        },
                        "AllowEdit": false
                    }
                }
            ],
            "ReadOnly": [
                "StreetAddress",
                "PostalCode",
                "City",
                "Country"
            ]
        }
    }
}
```

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

Organização → Geral → Adicionar usuário

**Nome completo do runbook**

rjgit-org\_general\_add-user

### Detalhes

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

### Permissões

#### Permissões de aplicativo

* **Tipo**Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *Abre a sessão do Exchange Online somente para aplicativo usada para grupos de distribuição e para habilitar o arquivo online*

#### Funções RBAC

* Administrador de Usuários
  * *Apoia a criação do usuário, a atribuição de gerente, patrocinadores e grupos e a leitura dos dados de licença*
* Administrador do Exchange
  * *Necessário para a sessão do Exchange Online somente para aplicativo que gerencia grupos de distribuição e o arquivo online*

### Parâmetros

#### GivenName

Primeiro nome do usuário.

| Propriedade                | Valor        |
| -------------------------- | ------------ |
| Obrigatório                | verdadeiro   |
| Valor padrão               |              |
| Tipo                       | Texto        |
| Nome de exibição no portal | Nome próprio |

#### Sobrenome

Sobrenome do usuário.

| Propriedade                | Valor      |
| -------------------------- | ---------- |
| Obrigatório                | verdadeiro |
| Valor padrão               |            |
| Tipo                       | Texto      |
| Nome de exibição no portal | Apelido    |

#### UserPrincipalName

Nome de entrada do usuário. Derivado do nome quando vazio.

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

#### MailNickname

Alias da caixa de correio. Derivado do nome de entrada quando vazio.

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

#### DisplayName

Derivado do primeiro e do último nome quando vazio.

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

#### CompanyName

Empresa à qual o usuário pertence.

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

#### JobTitle

Mostrado no perfil e na lista de endereços.

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

#### Department

Departamento em que o usuário trabalha.

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

#### ManagerId

Usuário que se torna o gerente.

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

#### SponsorIds

Usuários registrados como patrocinadores do novo usuário. Vários podem ser selecionados.

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

#### MobilePhone

Mostrado no perfil e na lista de endereços.

| Propriedade                | Valor            |
| -------------------------- | ---------------- |
| Obrigatório                | falso            |
| Valor padrão               |                  |
| Tipo                       | Texto            |
| Nome de exibição no portal | Telefone celular |

#### LocationName

Localização do Office mostrada no perfil. Com modelos da personalização do runbook, ao escolher uma, os campos de endereço também são preenchidos.

| Propriedade                | Valor                 |
| -------------------------- | --------------------- |
| Obrigatório                | falso                 |
| Valor padrão               |                       |
| Tipo                       | Texto                 |
| Nome de exibição no portal | Localização do Office |

#### StreetAddress

Parte do endereço postal mostrado no perfil. Preenchida pelo modelo de localização do Office quando um é escolhido.

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

#### PostalCode

Parte do endereço postal mostrado no perfil. Preenchida pelo modelo de localização do Office quando um é escolhido.

| Propriedade                | Valor         |
| -------------------------- | ------------- |
| Obrigatório                | falso         |
| Valor padrão               |               |
| Tipo                       | Texto         |
| Nome de exibição no portal | Código postal |

#### Cidade

Parte do endereço postal mostrado no perfil. Preenchida pelo modelo de localização do Office quando um é escolhido.

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

#### Estado

Parte do endereço postal mostrado no perfil.

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

#### País

Parte do endereço postal mostrado no perfil. Preenchida pelo modelo de localização do Office quando um é escolhido.

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

#### UsageLocation

Código de país de duas letras que decide quais licenças o usuário pode receber, por exemplo DE.

| Propriedade                | Valor               |
| -------------------------- | ------------------- |
| Obrigatório                | falso               |
| Valor padrão               |                     |
| Tipo                       | Texto               |
| Nome de exibição no portal | Local de utilização |

#### DefaultLicense

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

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

#### DefaultGroups

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

| Propriedade                | Valor              |
| -------------------------- | ------------------ |
| Obrigatório                | falso              |
| Valor padrão               |                    |
| Tipo                       | Texto              |
| Nome de exibição no portal | Grupos a adicionar |

#### InitialPassword

Senha inicial para o usuário. Deixe em branco para que uma seja gerada e exibida na saída.

| Propriedade                | Valor         |
| -------------------------- | ------------- |
| Obrigatório                | falso         |
| Valor padrão               |               |
| Tipo                       | Texto         |
| Nome de exibição no portal | Senha inicial |

#### EnableEXOArchive

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

| Propriedade                | Valor                                  |
| -------------------------- | -------------------------------------- |
| Obrigatório                | falso                                  |
| Valor padrão               | Falso                                  |
| Tipo                       | Booleano                               |
| Nome de exibição no portal | Criar uma caixa de correio de arquivo? |

[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/general/add-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.
