> 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/automacao/runbooks/runbook-references/org/general/add-user.md).
# Adicionar utilizador
### Descrição
Este runbook cria um novo utilizador na nuvem em Microsoft Entra ID e aplica propriedades padrão de utilizador. Opcionalmente, pode atribuir um grupo de licenças, adicionar o utilizador a grupos adicionais e criar uma caixa de correio de arquivo do Exchange Online.
### Localização
Organização → Geral → Adicionar Utilizador
**Nome completo do runbook**
rjgit-org\_general\_add-user
### Detalhes
| Propriedade | Valor |
| ------------------- | -------------------------------------------------------------------------------- |
| Versão | 1.0.1 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.9)
ExchangeOnlineManagement (>= 3.9.2)
|
| Agendável | não |
### Permissões
#### Permissões de aplicação
* **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
* *Dá suporte à criação do utilizador, à atribuição de gestor, patrocinadores e grupos, e à leitura de dados de licença*
* 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
#### GivenName
Nome próprio do utilizador.
| Propriedade | Valor |
| ------------ | ---------- |
| Obrigatório | verdadeiro |
| Valor padrão | |
| Tipo | String |
#### Surname
Apelido do utilizador.
| Propriedade | Valor |
| ------------ | ---------- |
| Obrigatório | verdadeiro |
| Valor padrão | |
| Tipo | String |
#### UserPrincipalName
Nome principal do utilizador (UPN). Se estiver vazio, o runbook gera um UPN a partir do nome fornecido.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### MailNickname
Apelido de correio (alias) usado para o utilizador. Se estiver vazio, o runbook deriva-o do UPN.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### DisplayName
Nome de apresentação do utilizador. Se estiver vazio, o runbook deriva-o do nome fornecido.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### CompanyName
Nome da empresa do utilizador.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### JobTitle
Cargo do utilizador.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### Department
Departamento do 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 |
#### SponsorIds
IDs opcionais dos utilizadores patrocinadores a definir para o utilizador. Suporte para vários patrocinadores.
| Propriedade | Valor |
| ------------ | --------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String\[] |
#### MobilePhone
Número de telemóvel do utilizador.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### LocationName
Nome da localização do Office usado para personalização do portal.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### StreetAddress
Morada do utilizador.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### PostalCode
Código postal do utilizador.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### Cidade
Cidade do utilizador.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### Estado
Estado ou região do utilizador.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### País
País do utilizador.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### UsageLocation
Localização de utilização usada para licenciamento.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### DefaultLicense
Grupo de licenças opcional a atribuir ao utilizador.
| 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 grupos separada por vírgulas a atribuir ao utilizador.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### InitialPassword
Palavra-passe inicial. Se estiver vazio, o runbook gera uma palavra-passe aleatória.
| Propriedade | Valor |
| ------------ | ------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
#### EnableEXOArchive
Se definido como verdadeiro, cria uma caixa de correio de arquivo do Exchange Online para o utilizador.
| Propriedade | Valor |
| -------------------------- | ---------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | Falso |
| Tipo | Booleano |
| Nome de exibição no portal | Criar caixa de correio de arquivo do Exchange Online |
[Voltar à visão geral da referência do runbook](/pt/automacao/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/automacao/runbooks/runbook-references/org/general/add-user.md?ask=&goal=
```
`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.