> 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

Automatiza las operaciones diarias en tu entorno.

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

RealmJoin ofrece a los administradores la capacidad de automatizar tareas utilizando [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 debe ejecutar 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 de usuarios (alta/baja 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

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

![](https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FMc2l3m04STPICTYA1oRR%2Fuser%20rb.png?alt=media\&token=9caed6bc-dee4-41b1-b937-b422cdf5022f)

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

RealmJoin se encuentra actualmente en proceso de migración de Windows PowerShell v5.1 a un 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="https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F6zw45i9VYQdWogZMGM3T%2Fre.png?alt=media&amp;token=6d5b6db5-e8d4-49dd-9682-bcad7300b98e" 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", 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 provocar 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 la opción "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="https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FG8FrcvNoMJWIrHJQm0hk%2Fimage.png?alt=media&amp;token=33d5dee3-2d63-42b8-b1b4-9ad85d20aacb" 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 abarcar 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 le permite importar estos runbooks a través de [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 la sincronización de sus runbooks](https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F0KIq5zPxTcdqcZFKKRMu%2Fimage.png?alt=media\&token=18499a55-69c7-4235-8da1-da79441660f9)

Espere el mensaje "Sync completed". Mantenga abierta la ventana del navegador mientras se ejecuta el proceso de sincronización.

Como se describe en el [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 mantenerla sincronizada 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 de información comunes, como ubicaciones de oficina
* Prellenar / preconfigurar parámetros, como no permitir eliminar el objeto de usuario al dar de baja
* Ocultar ciertas entradas/parámetros

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

## Ámbitos

Los runbooks en RealmJoin Portal se asignan 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 se asignan por usuario, como restablecer una contraseña. RealmJoin Portal utiliza esta asignación para ofrecer los runbooks correctos en el contexto adecuado.

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

## Control de acceso

El acceso/los permisos para usar ciertos 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 que solo nuestro equipo de soporte VIP cambie la dirección de correo electrónico del CEO

Ver [Permisos de Runbook](/es/automatizacion/runbooks/runbook-permissions.md) para obtener más 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 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.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.
