# 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 [PowerShell Runbooks](https://docs.microsoft.com/en-us/azure/automation/automation-runbook-types#powershell-runbooks). &#x20;

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 (incorporación/desincorporación de usuarios)
* Creación de Temporary Access Passes (TAPs)
* Informe de 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.

![](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).&#x20;

{% hint style="info" %}
Asegúrese de que la experiencia "Runtime Environment" 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&#x26;token=6d5b6db5-e8d4-49dd-9682-bcad7300b98e" alt=""><figcaption></figcaption></figure>

Al ejecutar un [sync](#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 seleccionar "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="https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FG8FrcvNoMJWIrHJQm0hk%2Fimage.png?alt=media&#x26;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 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](https://docs.realmjoin.com/es/connecting-azure-automation/required-permissions#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>

![Inicie una 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 al 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](https://docs.realmjoin.com/es/automatizacion/runbooks/naming-conventions) 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 funcionalidades.

## Personalización

Puede personalizar los runbooks existentes y nuevos para su entorno. Por ejemplo, puede&#x20;

* Usar plantillas para información común, como ubicaciones de oficina
* Rellenar previamente / preconfigurar parámetros, como no permitir eliminar el objeto de usuario al desincorporar
* Ocultar ciertas entradas/parámetros

Consulta [Personalización de Runbooks ](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-customization)para más detalles.

## Ámbitos

Los runbooks en RealmJoin Portal están delimitados a los diferentes tipos de objetos en su entorno. Algunos runbooks operan a nivel de inquilino / organización, como la creación de un informe de licencias. Algunos runbooks están delimitados por usuario, como el restablecimiento de una contraseña. RealmJoin Portal utiliza esta delimitación para ofrecer los runbooks adecuados en el contexto adecuado.

Consulta [Convenciones de nomenclatura](https://docs.realmjoin.com/es/automatizacion/runbooks/naming-conventions) para aprender cómo los runbooks están delimitados a ciertos objetos en su entorno.

## Control de acceso

El acceso/permisos para usar ciertos runbooks pueden concederse de forma granular a nivel de runbook. Por ejemplo, los permisos de runbooks podrían ayudarle a:

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

Consulta [Permisos de Runbook](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-permissions) para obtener detalles sobre cómo implementar dichas reglas en su entorno.
