> 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/mail/add-mail-contact.md).
# Adicionar contacto de correio
Criar um novo contacto de correio do Exchange Online com definições opcionais de nome apresentado e lista de endereços
### Descrição
Este runbook cria um novo contacto de correio do Exchange Online (contacto externo) utilizando o cmdlet New-MailContact. Pode, opcionalmente, definir o nome próprio, apelido, alias de e-mail do contacto e controlar se este aparece na Lista de Endereços Global. Todos os nomes assumem, por defeito, o nome de apresentação fornecido se não forem definidos explicitamente.
### Localização
Organização → Correio → Adicionar contacto de correio
**Nome completo do runbook**
rjgit-org\_mail\_add-mail-contact
### 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
* *Executa as verificações de pré-execução New-/Set-MailContact e Get-MailContact/Get-Recipient na sessão do Exchange Online apenas da aplicação*
#### funções RBAC
* Administrador do Exchange
* *Necessário para que a sessão do Exchange Online apenas da aplicação da identidade gerida crie contactos de correio*
### Parâmetros
#### ExternalEmailAddress
O endereço de e-mail SMTP externo para o contacto de correio. Este é o endereço de e-mail principal utilizado para comunicação com o contacto.
| Propriedade | Valor |
| -------------------------- | -------------------------- |
| Obrigatório | verdadeiro |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Endereço de e-mail externo |
#### DisplayName
O nome de apresentação mostrado para o contacto de correio no Exchange Online e na Lista de Endereços Global.
| Propriedade | Valor |
| -------------------------- | -------------------- |
| Obrigatório | verdadeiro |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Nome de apresentação |
#### Nome
O nome exclusivo do contacto utilizado para gestão e identificação. Se for deixado em branco, assume por defeito o valor de DisplayName.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Nome do contacto (opcional - assume por defeito o Nome de apresentação) |
#### FirstName
O nome próprio do contacto. Se não for especificado, o campo fica em branco.
| Propriedade | Valor |
| -------------------------- | ----------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Nome próprio (opcional) |
#### LastName
O apelido do contacto. Se não for especificado, o campo fica em branco.
| Propriedade | Valor |
| -------------------------- | ------------------ |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Apelido (opcional) |
#### Alias
A alcunha de correio (alias) para o contacto de correio. Se não for especificada, o sistema gera-a automaticamente a partir do nome de apresentação.
| Propriedade | Valor |
| -------------------------- | --------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Alias de correio (opcional) |
#### HideFromAddressLists
Se definido como true, o contacto de correio ficará oculto da Lista de Endereços Global e de outras listas de endereços. Se false, o contacto fica visível para todos os utilizadores. O valor predefinido é false.
| Propriedade | Valor |
| -------------------------- | ------------------------------------ |
| Obrigatório | falso |
| Valor padrão | Falso |
| Tipo | Booleano |
| Nome de exibição no portal | Ocultar da Lista de Endereços Global |
[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/mail/add-mail-contact.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.