> 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 ayudarle a automatizar incluyen:

* Operaciones del ciclo de vida del usuario (alta/baja de usuarios)
* Creación de Temporary Access Passes (TAPs)
* Informes del uso de licencias de M/O365
* Gestión de 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 entornos de ejecución de PowerShell

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 "Entorno de ejecución" en su Automation Account esté habilitada.
{% endhint %}

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

Cuando se ejecuta una [sincronización](#syncing-from-the-shared-repository), se creará un entorno de ejecución personalizado de PowerShell "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 **vuelva a sincronizar**. 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 utilizar "Edit in Portal" en estos runbooks para migrarlos manualmente. Asegúrese 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 presentes 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 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) a 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 a 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 "Sincronización completada". Mantenga 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 añadirá, 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 elementos comunes de información, como ubicaciones de oficina
* Prellenar / preconfigurar parámetros, como no permitir eliminar el objeto de usuario al hacer offboarding
* 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 limitados a los distintos tipos de objetos de su entorno. Algunos runbooks operan a nivel de Tenant / organización, como crear un informe de licencias. Algunos runbooks están limitados por usuario, como restablecer una contraseña. RealmJoin Portal utiliza este ámbito para ofrecer los runbooks correctos 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 de su entorno.

## Control de acceso

El acceso/los permisos para usar determinados runbooks pueden concederse 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 tercer 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 estas reglas en su 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.
