> 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.md).

# Runbooks

{% embed url="<https://www.youtube.com/watch?v=TfL7xRasVUg>" %}

RealmJoin proporciona a los administradores la capacidad de automatizar tareas mediante el uso de [Azure Automation](https://learn.microsoft.com/en-us/azure/automation/overview) para ejecutar [Runbooks de PowerShell](https://docs.microsoft.com/en-us/azure/automation/automation-runbook-types#powershell-runbooks).

Los runbooks son scripts que automatizan tareas que normalmente deben ser ejecutadas por un ingeniero de soporte / operador o administrador. Automatizar estas tareas reduce el riesgo de errores manuales y permite una mejor auditoría de las acciones.

Algunas tareas comunes que RealmJoin puede ayudarte a automatizar incluyen:

* Operaciones del ciclo de vida de los usuarios (incorporación/desincorporación de usuarios)
* Creación de pases de acceso temporal (TAPs)
* Generación de informes sobre el uso de licencias de M/O365
* Administración de alias de correo electrónico

Puedes ofrecer RealmJoin Portal a tus equipos de soporte y administración para simplificar y mejorar la calidad de tus operaciones diarias.

![](/files/dde38959561f941836d58fe541eac53f603dc927)

### Migración a entornos de ejecución de PowerShell

RealmJoin se encuentra actualmente en proceso de migrar de Windows PowerShell v5.1 a PowerShell v7.4 [Entorno de ejecución](https://learn.microsoft.com/en-us/azure/automation/manage-runtime-environment).

{% hint style="info" %}
Asegúrate de que la experiencia de "Runtime Environment" en tu Automation Account esté habilitada.
{% endhint %}

<figure><img src="/files/befde9d4bea555687f78b2a9698fc7324d2b8512" alt=""><figcaption></figcaption></figure>

Al ejecutar una [sincronización](#syncing-from-the-shared-repository), se creará un entorno de ejecución de PowerShell personalizado "RJ-PowerShell-7.4"; los runbooks sincronizados se moverán a este entorno. Si es necesario, los módulos de PowerShell requeridos se importarán automáticamente.

{% hint style="info" %}
Debido a **duraciones variables del proceso** que podrían causar errores como 404, por favor **sincroniza de nuevo**. Además, espera unos minutos antes de iniciar el primer runbook después de la migración.
{% endhint %}

{% hint style="warning" %}
**Los runbooks personalizados / no sincronizados no se actualizarán automáticamente.**

Puedes usar Azure Portal y la opción "Edit in Portal" en estos runbooks para migrarlos manualmente. Asegúrate de "publicar" los runbooks para que el cambio surta efecto.
{% endhint %}

<figure><img src="/files/0c7f684be0bd4ae5e79a22b120de0a9961eaec3c" alt=""><figcaption></figcaption></figure>

## Runbooks comunes

RealmJoin mantiene un [repositorio compartido en línea de runbooks](https://github.com/realmjoin/realmjoin-runbooks). Su objetivo es cubrir muchas operaciones comunes que se encuentran en la mayoría de los entornos. Los runbooks se actualizan y mejoran continuamente. Por supuesto, también puedes incluir tus propios runbooks personalizados.

RealmJoin Portal te permite importar estos runbooks mediante [Aplicación de administración de runbooks de RealmJoin](/es/automatizacion/connecting-azure-automation/required-permissions.md#b31d828b-8bcb-45fc-8d72-5418777a5376) en tu entorno y ofrece a tu personal de soporte y administración una interfaz fácil y no técnica para las tareas que cubren los runbooks.

### Sincronización desde el repositorio compartido

Puedes iniciar una sincronización desde el repositorio compartido hacia tu cuenta de Azure Automation haciendo clic en "Sync runbooks with upstream" en

<https://portal.realmjoin.com/settings/general>

![Inicia una sincronización de tus runbooks](/files/663a34eff7d99fb75a3bae92d8a45b64e2517321)

Espera el mensaje "Sync completed". Por favor, mantén la ventana del navegador abierta mientras se ejecuta el proceso de sincronización.

Como se describe en la [convención de nomenclatura](/es/automatizacion/runbooks/naming-conventions.md) esto agregará, actualizará y, si es necesario, eliminará runbooks de la cuenta conectada de Azure Automation para que esté sincronizada con el repositorio compartido de RealmJoin. Esto garantiza que tus runbooks estén actualizados, incluidas mejoras, correcciones y nuevas funciones.

## Personalización

Puedes personalizar los runbooks existentes y nuevos para tu entorno. Por ejemplo, puedes

* Usar plantillas para datos comunes, como ubicaciones de oficina
* Rellenar / preconfigurar parámetros, como no permitir la eliminación del objeto de usuario al dar de baja
* Ocultar ciertas entradas/parámetros

Vea [Personalización de runbooks ](/es/automatizacion/runbooks/runbook-customization.md)para más detalles.

## Ámbitos

Los runbooks en RealmJoin Portal están asignados a los distintos tipos de objetos de tu entorno. Algunos runbooks operan a nivel de tenant / organización, como crear un informe de licencias. Algunos runbooks están asignados por usuario, como restablecer una contraseña. RealmJoin Portal usa este ámbito para ofrecer los runbooks adecuados en el contexto adecuado.

Vea [Convenciones de nomenclatura](/es/automatizacion/runbooks/naming-conventions.md) para aprender cómo los runbooks se delimitan a ciertos objetos en tu entorno.

## Control de acceso

El acceso/permisos para usar ciertos runbooks se puede conceder de forma granular a nivel de runbook. Por ejemplo, los permisos de runbook podrían ayudarte a:

* Permitir el acceso a este runbook solo a los operadores de tercer nivel
* Permitir solo a nuestro equipo de soporte VIP cambiar la dirección de correo electrónico del director general

Vea [Permisos de runbook](/es/automatizacion/runbooks/runbook-permissions.md) para obtener detalles sobre cómo implementar estas reglas en tu entorno.


---

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