> 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/es/automatizacion/runbooks/runbook-references/org/mail/add-mail-contact.md).
# Agregar contacto de correo
### Descripción
Este runbook crea un nuevo contacto de correo de Exchange Online (contacto externo) mediante el cmdlet New-MailContact. Opcionalmente, puede configurar el nombre, apellido y alias de correo del contacto, y controlar si aparece en la Lista global de direcciones. Todos los nombres usan de forma predeterminada el nombre para mostrar proporcionado si no se establecen explícitamente.
### Ubicación
Organización → Correo → Agregar contacto de correo
**Nombre completo del runbook**
rjgit-org\_mail\_add-mail-contact
### Detalles
| Propiedad | Valor |
| ------------------ | -------------------------------------------------------------------------------- |
| Versión | 1.0.1 |
| Módulos requeridos | RealmJoin.RunbookHelper (>= 0.8.9)
ExchangeOnlineManagement (>= 3.9.2)
|
| Programable | no |
### Permisos
#### Permisos de aplicación
* **Tipo**: Exchange Online de Office 365
* Exchange.ManageAsApp
* *Ejecuta las comprobaciones previas New-/Set-MailContact y Get-MailContact/Get-Recipient en la sesión de Exchange Online solo de aplicación*
#### roles RBAC
* Administrador de Exchange
* *Requerido para que la sesión de Exchange Online solo de aplicación de la identidad administrada cree contactos de correo*
### Parámetros
#### ExternalEmailAddress
La dirección de correo electrónico SMTP externa del contacto de correo. Esta es la dirección de correo principal utilizada para comunicarse con el contacto.
| Propiedad | Valor |
| -------------------------------- | --------------------------------------- |
| Requerido | true |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Dirección de correo electrónico externa |
#### Nombre para mostrar
El nombre para mostrar que se muestra para el contacto de correo en Exchange Online y en la Lista global de direcciones.
| Propiedad | Valor |
| -------------------------------- | ------------------- |
| Requerido | true |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Nombre para mostrar |
#### Nombre
El nombre único del contacto utilizado para la administración y la identificación. Si se deja vacío, el valor predeterminado será DisplayName.
| Propiedad | Valor |
| -------------------------------- | --------------------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Nombre del contacto (opcional: predeterminado al Nombre para mostrar) |
#### FirstName
El nombre del contacto. Si no se especifica, el campo queda vacío.
| Propiedad | Valor |
| -------------------------------- | ----------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Nombre (opcional) |
#### LastName
Los apellidos del contacto. Si no se especifica, el campo queda vacío.
| Propiedad | Valor |
| -------------------------------- | -------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Apellidos (opcional) |
#### Alias
El apodo de correo (alias) del contacto de correo. Si no se especifica, el sistema genera uno automáticamente a partir del nombre para mostrar.
| Propiedad | Valor |
| -------------------------------- | -------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Alias de correo (opcional) |
#### HideFromAddressLists
Si se establece en true, el contacto de correo se ocultará de la Lista global de direcciones y de otras listas de direcciones. Si es false, el contacto será visible para todos los usuarios. El valor predeterminado es false.
| Propiedad | Valor |
| -------------------------------- | ----------------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Nombre para mostrar en el portal | Ocultar de la Lista global de direcciones |
[Volver a la vista general de la referencia del runbook](/es/automatizacion/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/es/automatizacion/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.