# 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 error manual y permite una mejor auditoría de las acciones.

Algunas tareas comunes que RealmJoin puede ayudarle a automatizar incluyen:

* Operaciones del ciclo de vida del usuario (incorporación/desincorporación de usuarios)
* Crear Temporary Access Passes (TAPs)
* Informar sobre el uso de licencias M/O365
* Administrar alias de correo electrónico

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

![](/files/dde38959561f941836d58fe541eac53f603dc927)

### Migración a PowerShell Runtime Environments

RealmJoin se encuentra actualmente en proceso de migración 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úrese de que la experiencia de "Runtime Environment" en su 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 personalizado de PowerShell "RJ-PowerShell-7.4" y 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 de proceso variables** que podrían causar errores como 404, por favor **sincronice de nuevo**. Además, espere 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.**

Puede usar Azure Portal y usar "Edit in Portal" en estos runbooks para migrarlos manualmente. Asegúrese de "publish" 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 puede incluir sus propios runbooks personalizados.

RealmJoin Portal le permite importar estos runbooks mediante [RealmJoin Runbook Management App](/es/automatizacion/connecting-azure-automation/required-permissions.md#b31d828b-8bcb-45fc-8d72-5418777a5376) en su entorno y ofrece a su 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

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

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

![Iniciar una sincronización de sus runbooks](/files/663a34eff7d99fb75a3bae92d8a45b64e2517321)

Espere el mensaje "Sync completed". Mantenga abierta la ventana del navegador 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 de Azure Automation conectada para que estén sincronizados con el repositorio compartido de RealmJoin. Esto garantiza que sus runbooks estén actualizados, incluidas mejoras, correcciones y nuevas funciones.

## Personalización

Puede personalizar los runbooks existentes y nuevos para su entorno. Por ejemplo, puede

* Usar plantillas para piezas comunes de información, como ubicaciones de oficina
* Rellenar / preconfigurar parámetros, como no permitir eliminar el 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 en su entorno. Algunos runbooks operan a nivel de Tenant / organización, como la creación de un informe de licencias. Algunos runbooks están asignados por usuario, como el restablecimiento de una contraseña. RealmJoin Portal utiliza esta asignación para ofrecer los runbooks adecuados en el contexto adecuado.

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

## Control de acceso

Los accesos/permisos para usar ciertos runbooks pueden otorgarse de forma granular a nivel de runbook. Por ejemplo, los permisos de Runbook podrían ayudarle a:

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

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


---

# Agent Instructions: 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:

```
GET https://docs.realmjoin.com/es/automatizacion/runbooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
