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

# Agregar usuario

Crear una nueva cuenta de usuario en Entra ID

### Descripción

Crea un usuario en la nube en Entra ID con los detalles habituales del perfil, como nombre, empresa, cargo, gerente, patrocinadores y dirección. El nombre de inicio de sesión, el alias y el nombre para mostrar se derivan del nombre cuando se dejan vacíos, y se genera una contraseña inicial cuando no se proporciona ninguna. Opcionalmente, al usuario se le asigna un grupo de licencias, otros grupos y un buzón de archivo de Exchange Online.

### Ofrezca ubicaciones y empresas como plantillas

Los campos de dirección y la empresa son texto libre de forma predeterminada. Con plantillas de personalización del runbook, el operador selecciona una ubicación de Office, que completa y bloquea el bloque de dirección, y una empresa de una lista. El siguiente ejemplo define dichas plantillas y las vincula a los campos del runbook:

```json
{
    "Templates": {
        "Options": [
            {
                "$id": "LocationOptions",
                "$values": [
                    {
                        "Display": "DE-OF",
                        "Customization": {
                            "Default": {
                                "StreetAddress": "Kaiserstraße 39",
                                "PostalCode": "63065",
                                "City": "Offenbach",
                                "Country": "Germany"
                            }
                        }
                    },
                    {
                        "Display": "DE-DEG",
                        "Customization": {
                            "Default": {
                                "StreetAddress": "Lateinschulgassse 24-26",
                                "PostalCode": "94469",
                                "City": "Deggendorf",
                                "Country": "Germany"
                            }
                        }
                    },
                    {
                        "Display": "DE-HH",
                        "Customization": {
                            "Default": {
                                "StreetAddress": "Hans-Henny-Jahnn-Weg 53",
                                "PostalCode": "22085",
                                "City": "Hamburg",
                                "Country": "Germany"
                            }
                        }
                    },
                    {
                        "Display": "FI-HS",
                        "Customization": {
                            "Default": {
                                "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": "Ubicación de Office",
                    "DisplayAfter": "CompanyName",
                    "Select": {
                        "Options": {
                            "$ref": "LocationOptions"
                        }
                    }
                },
                {
                    "Name": "CompanyName",
                    "Select": {
                        "Options": {
                            "$ref": "CompanyOptions"
                        },
                        "AllowEdit": false
                    }
                }
            ],
            "ReadOnly": [
                "StreetAddress",
                "PostalCode",
                "City",
                "Country"
            ]
        }
    }
}
```

Para obtener más información sobre cómo personalizar runbooks, consulte la [Guía de personalización de runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### Ubicación

Organización → General → Agregar usuario

**Nombre completo del runbook**

rjgit-org\_general\_add-user

### Detalles

| Propiedad          | Valor                                                                             |
| ------------------ | --------------------------------------------------------------------------------- |
| Versión            | 1.0.1                                                                             |
| Módulos requeridos | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>ExchangeOnlineManagement (>= 3.9.2)</p> |
| Programable        | no                                                                                |

### Permisos

#### Permisos de aplicación

* **Tipo**: Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *Abre la sesión de Exchange Online solo para aplicaciones utilizada para grupos de distribución y para habilitar el archivo en línea*

#### roles de RBAC

* Administrador de usuarios
  * *Admite la creación del usuario, la asignación de gerente, patrocinadores y grupos, y la lectura de datos de licencia*
* Administrador de Exchange
  * *Requerido para la sesión de Exchange Online solo para aplicaciones que administra grupos de distribución y el archivo en línea*

### Parámetros

#### GivenName

Nombre de pila del usuario.

| Propiedad                      | Valor          |
| ------------------------------ | -------------- |
| Requerido                      | verdadero      |
| Valor predeterminado           |                |
| Tipo                           | Cadena         |
| Nombre para mostrar del portal | Nombre de pila |

#### Surname

Apellido del usuario.

| Propiedad                      | Valor     |
| ------------------------------ | --------- |
| Requerido                      | verdadero |
| Valor predeterminado           |           |
| Tipo                           | Cadena    |
| Nombre para mostrar del portal | Apellido  |

#### UserPrincipalName

Nombre de inicio de sesión del usuario. Se deriva del nombre cuando está vacío.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### MailNickname

Alias del buzón. Se deriva del nombre de inicio de sesión cuando está vacío.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### DisplayName

Se deriva del nombre y apellido cuando está vacío.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### CompanyName

Empresa a la que pertenece el usuario.

| Propiedad                      | Valor   |
| ------------------------------ | ------- |
| Requerido                      | falso   |
| Valor predeterminado           |         |
| Tipo                           | Cadena  |
| Nombre para mostrar del portal | Company |

#### JobTitle

Se muestra en el perfil y en la libreta de direcciones.

| Propiedad                      | Valor  |
| ------------------------------ | ------ |
| Requerido                      | falso  |
| Valor predeterminado           |        |
| Tipo                           | Cadena |
| Nombre para mostrar del portal | Cargo  |

#### Department

Departamento en el que trabaja el usuario.

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

#### ManagerId

Usuario que se convierte en el gerente.

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

#### SponsorIds

Usuarios registrados como patrocinadores del nuevo usuario. Se pueden seleccionar varios.

| Propiedad            | Valor     |
| -------------------- | --------- |
| Requerido            | falso     |
| Valor predeterminado |           |
| Tipo                 | Cadena\[] |

#### MobilePhone

Se muestra en el perfil y en la libreta de direcciones.

| Propiedad                      | Valor          |
| ------------------------------ | -------------- |
| Requerido                      | falso          |
| Valor predeterminado           |                |
| Tipo                           | Cadena         |
| Nombre para mostrar del portal | Teléfono móvil |

#### LocationName

Ubicación de Office mostrada en el perfil. Con plantillas de la personalización del runbook, al seleccionar una también se completan los campos de dirección.

| Propiedad                      | Valor               |
| ------------------------------ | ------------------- |
| Requerido                      | falso               |
| Valor predeterminado           |                     |
| Tipo                           | Cadena              |
| Nombre para mostrar del portal | Ubicación de Office |

#### StreetAddress

Parte de la dirección postal mostrada en el perfil. La completa la plantilla de ubicación de Office cuando se selecciona una.

| Propiedad                      | Valor     |
| ------------------------------ | --------- |
| Requerido                      | falso     |
| Valor predeterminado           |           |
| Tipo                           | Cadena    |
| Nombre para mostrar del portal | Dirección |

#### PostalCode

Parte de la dirección postal mostrada en el perfil. La completa la plantilla de ubicación de Office cuando se selecciona una.

| Propiedad                      | Valor         |
| ------------------------------ | ------------- |
| Requerido                      | falso         |
| Valor predeterminado           |               |
| Tipo                           | Cadena        |
| Nombre para mostrar del portal | Código postal |

#### City

Parte de la dirección postal mostrada en el perfil. La completa la plantilla de ubicación de Office cuando se selecciona una.

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

#### State

Parte de la dirección postal mostrada en el perfil.

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

#### Country

Parte de la dirección postal mostrada en el perfil. La completa la plantilla de ubicación de Office cuando se selecciona una.

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

#### UsageLocation

Código de país de dos letras que determina qué licencias puede recibir el usuario, por ejemplo DE.

| Propiedad                      | Valor            |
| ------------------------------ | ---------------- |
| Requerido                      | falso            |
| Valor predeterminado           |                  |
| Tipo                           | Cadena           |
| Nombre para mostrar del portal | Ubicación de uso |

#### DefaultLicense

Nombre para mostrar del grupo que asigna la licencia; el usuario se agrega a él. Déjelo vacío si no hay ninguno.

| Propiedad                      | Valor                        |
| ------------------------------ | ---------------------------- |
| Requerido                      | falso                        |
| Valor predeterminado           |                              |
| Tipo                           | Cadena                       |
| Nombre para mostrar del portal | Grupo de licencias a asignar |

#### DefaultGroups

Nombres para mostrar de otros grupos a los que se agrega el usuario, separados por comas.

| Propiedad                      | Valor            |
| ------------------------------ | ---------------- |
| Requerido                      | falso            |
| Valor predeterminado           |                  |
| Tipo                           | Cadena           |
| Nombre para mostrar del portal | Grupos a agregar |

#### InitialPassword

Contraseña inicial del usuario. Déjelo vacío para que se genere una y se muestre en la salida.

| Propiedad                      | Valor              |
| ------------------------------ | ------------------ |
| Requerido                      | falso              |
| Valor predeterminado           |                    |
| Tipo                           | Cadena             |
| Nombre para mostrar del portal | Contraseña inicial |

#### EnableEXOArchive

Activa el buzón de archivo de Exchange Online para el nuevo usuario.

| Propiedad                      | Valor                       |
| ------------------------------ | --------------------------- |
| Requerido                      | falso                       |
| Valor predeterminado           | Falso                       |
| Tipo                           | Booleano                    |
| Nombre para mostrar del portal | ¿Crear un buzón de archivo? |

[Volver a la vista general de 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 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/es/automatizacion/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.