# Runbooks

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

O RealmJoin oferece aos administradores a capacidade de automatizar tarefas usando [Azure Automation](https://learn.microsoft.com/en-us/azure/automation/overview) para executar [Runbooks do PowerShell](https://docs.microsoft.com/en-us/azure/automation/automation-runbook-types#powershell-runbooks). &#x20;

Runbooks são scripts que automatizam tarefas que normalmente teriam de ser executadas por um engenheiro de suporte / operador ou administrador. Automatizar estas tarefas reduz o risco de erro manual e permite uma melhor auditoria das ações.

Algumas tarefas comuns que o RealmJoin pode ajudar a automatizar incluem:

* Operações do ciclo de vida do utilizador (integração/desintegração de utilizadores)
* Criação de Temporary Access Passes (TAPs)
* Relatório da utilização de licenças M/O365
* Gestão de aliases de email

Pode disponibilizar o RealmJoin Portal às suas equipas de suporte e administração para simplificar e melhorar a qualidade das suas operações do dia a dia.

![](https://686519968-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)

### Migração para Ambientes de Runtime do PowerShell

O RealmJoin encontra-se atualmente em processo de migração do Windows PowerShell v5.1 para um PowerShell v7.4 [Ambiente de Runtime](https://learn.microsoft.com/en-us/azure/automation/manage-runtime-environment).&#x20;

{% hint style="info" %}
Certifique-se de que a experiência "Runtime Environment" na sua Automation Account está ativada.
{% endhint %}

<figure><img src="https://686519968-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>

Ao executar um [sync](#syncing-from-the-shared-repository), será criado um Ambiente de Runtime do PowerShell personalizado "RJ-PowerShell-7.4"; os runbooks sincronizados serão տեղափոխados para este ambiente. Se necessário, os módulos PowerShell necessários serão importados automaticamente.

{% hint style="info" %}
Devido a **durações de processo variáveis** que podem causar erros como 404, por favor **sincronize novamente**. Além disso, aguarde alguns minutos antes de iniciar o primeiro runbook após a migração.
{% endhint %}

{% hint style="warning" %}
**Os runbooks personalizados / não sincronizados não serão atualizados automaticamente.**

Pode usar o Azure Portal e selecionar "Edit in Portal" nestes runbooks para os migrar manualmente. Certifique-se de "publicar" os runbooks para que a alteração entre em vigor.
{% endhint %}

<figure><img src="https://686519968-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 Comuns

O RealmJoin mantém um [repositório online partilhado de runbooks](https://github.com/realmjoin/realmjoin-runbooks). Estes têm como objetivo abranger muitas operações comuns encontradas na maioria dos ambientes. Os runbooks são continuamente atualizados e melhorados. Naturalmente, também pode incluir os seus próprios runbooks personalizados.

O RealmJoin Portal permite-lhe importar estes runbooks através de [RealmJoin Runbook Management App](https://docs.realmjoin.com/pt/connecting-azure-automation/required-permissions#b31d828b-8bcb-45fc-8d72-5418777a5376) para o seu ambiente e oferece à sua equipa de suporte e administração uma interface fácil e não técnica para as tarefas abrangidas pelos runbooks.

### Sincronização a partir do Repositório Partilhado

Pode iniciar uma sincronização do repositório partilhado para a sua conta Azure Automation ao clicar em "Sync runbooks with upstream" em

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

![Iniciar uma sincronização dos seus runbooks](https://686519968-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)

Aguarde pela mensagem "Sync completed". Por favor, mantenha a janela do navegador aberta enquanto o processo de sincronização estiver em execução.

Conforme descrito na [convenção de nomenclatura](https://docs.realmjoin.com/pt/automacao/runbooks/naming-conventions) isto irá adicionar, atualizar e, se necessário, remover runbooks da Azure Automation Account ligada para que fiquem sincronizados com o repositório partilhado do RealmJoin. Isto garante que os seus runbooks estão atualizados, incluindo melhorias, correções e novas funcionalidades.

## Personalização

Pode personalizar runbooks existentes e novos para o seu ambiente. Por exemplo, pode&#x20;

* Usar modelos para partes comuns de informação, como localizações de escritório
* Pré-preencher / pré-configurar parâmetros, como não permitir a eliminação do objeto de utilizador ao desintegrar um utilizador
* Ocultar certos inputs/parâmetros

Consulte [Personalização de Runbooks ](https://docs.realmjoin.com/pt/automacao/runbooks/runbook-customization)para mais detalhes.

## Âmbitos

Os runbooks no RealmJoin Portal estão limitados aos diferentes tipos de objetos no seu ambiente. Alguns runbooks operam ao nível do tenant / organização, como a criação de um relatório de licenças. Alguns runbooks estão limitados por utilizador, como a reposição de uma palavra-passe. O RealmJoin Portal utiliza esta limitação para oferecer os runbooks certos no contexto certo.

Consulte [Convenções de Nomenclatura](https://docs.realmjoin.com/pt/automacao/runbooks/naming-conventions) para saber como os runbooks são limitados a certos objetos no seu ambiente.

## Controlo de Acesso

O acesso/permissões para usar determinados runbooks pode ser atribuído de forma granular ao nível do runbook. Por exemplo, as Permissões de Runbook podem ajudá-lo a:

* Permitir o acesso a este runbook apenas aos operadores de 3.º nível&#x20;
* Permitir apenas à nossa equipa de suporte VIP alterar o endereço de email do CEO

Consulte [Permissões de Runbook](https://docs.realmjoin.com/pt/automacao/runbooks/runbook-permissions) para obter detalhes sobre como implementar estas regras no seu ambiente.
