# Runbooks

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

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).

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

Algumas tarefas comuns que o RealmJoin pode ajudá-lo a automatizar incluem:

* Operações do ciclo de vida do usuário (onboarding/offboarding de usuários)
* Criação de Temporary Access Passes (TAPs)
* Relatórios de uso de licenças do M/O365
* Gestão de aliases de email

Você pode oferecer o RealmJoin Portal às suas equipas de suporte e administração para simplificar e melhorar a qualidade das suas operações diárias.

![](/files/c7f61bb967827c2b5944e1eef80b445bd8fdb60b)

### Migração para PowerShell Runtime Environments

O RealmJoin está atualmente no processo de migração do Windows PowerShell v5.1 para um PowerShell v7.4 [Runtime Environment](https://learn.microsoft.com/en-us/azure/automation/manage-runtime-environment).

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

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

Ao executar um [sync](#syncing-from-the-shared-repository), será criado um PowerShell Runtime Environment personalizado "RJ-PowerShell-7.4"; os runbooks sincronizados serão movidos para este ambiente. Se necessário, os módulos do PowerShell exigidos 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" %}
**Runbooks personalizados / não sincronizados não serão atualizados automaticamente.**

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

<figure><img src="/files/67afc8fc8a7f9f327e41800a02ff4aba9ba37fb3" alt=""><figcaption></figcaption></figure>

## Runbooks Comuns

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

O RealmJoin Portal permite importar estes runbooks através de [Aplicação de Gestão de Runbooks do RealmJoin](/pt/automacao/connecting-azure-automation/required-permissions.md#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 do Azure Automation clicando em "Sync runbooks with upstream" em

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

![Iniciar uma sincronização dos seus runbooks](/files/f6fd3a5817953c24f7c1af6ffd694ab68c6f263b)

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](/pt/automacao/runbooks/naming-conventions.md) isto adicionará, atualizará e, se necessário, removerá runbooks da Azure Automation Account ligada para ficar sincronizada 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

* Usar modelos para partes comuns de informação, como localizações de escritório
* Preencher / pré-configurar parâmetros, como não permitir eliminar o objeto do utilizador durante o offboarding
* Ocultar certos inputs/parâmetros

Ver [Personalização de Runbooks ](/pt/automacao/runbooks/runbook-customization.md)para mais detalhes.

## Âmbitos

Os runbooks no RealmJoin Portal estão abrangidos por diferentes tipos de objetos no seu ambiente. Alguns runbooks operam ao nível do tenant / organização, como criar um relatório de licenças. Alguns runbooks são abrangidos por utilizador, como redefinir uma palavra-passe. O RealmJoin Portal usa esta abrangência para oferecer os runbooks certos no contexto certo.

Ver [Convenções de Nomeação](/pt/automacao/runbooks/naming-conventions.md) para saber como os runbooks estão abrangidos por certos objetos no seu ambiente.

## Controlo de Acesso

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

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

Ver [Permissões de Runbook](/pt/automacao/runbooks/runbook-permissions.md) para detalhes sobre como implementar essas regras no seu ambiente.


---

# 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/pt/automacao/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.
