> 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, puedes establecer el nombre, el apellido y el alias de correo del contacto, y controlar si aparece en la Lista global de direcciones. Todos los nombres toman como valor predeterminado 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

### Permisos

#### Permisos de la aplicación

* **Tipo**: Office 365 Exchange Online
  * Exchange.ManageAsApp

#### Roles de RBAC

* Administrador de Exchange

### Parámetros

#### ExternalEmailAddress

La dirección de correo SMTP externa para el contacto de correo. Esta es la dirección de correo principal utilizada para comunicarse con el contacto.

| Propiedad            | Valor     |
| -------------------- | --------- |
| Requerido            | verdadero |
| Valor predeterminado |           |
| Tipo                 | Cadena    |

#### DisplayName

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            | verdadero |
| Valor predeterminado |           |
| Tipo                 | Cadena    |

#### Nombre

El nombre único del contacto usado para la administración y la identificación. Si se deja vacío, toma como valor predeterminado el valor de DisplayName.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### FirstName

El nombre del contacto. Si no se especifica, el campo se deja vacío.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### LastName

El apellido del contacto. Si no se especifica, el campo se deja vacío.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### Alias

El apodo de correo (alias) para el 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 |

#### HideFromAddressLists

Si se establece en verdadero, el contacto de correo se ocultará de la Lista global de direcciones y de otras listas de direcciones. Si es falso, el contacto será visible para todos los usuarios. El valor predeterminado es falso.

| Propiedad            | Valor    |
| -------------------- | -------- |
| Requerido            | falso    |
| Valor predeterminado | Falso    |
| Tipo                 | Booleano |

[Volver a la vista general de referencia de 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=<question>&goal=<endgoal>
```

`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.