> 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/pt/automacao/runbooks.md). # Runbooks {% embed url="" %} RealmJoin fornece 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 têm 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órios de utilização de licenças M/O365 * Gestão de aliases de email Pode oferecer 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. ![](/files/c7f61bb967827c2b5944e1eef80b445bd8fdb60b) ### Migração para Ambientes de Runtime do PowerShell O RealmJoin está 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). {% hint style="info" %} Certifique-se de que a experiência de "Runtime Environment" na sua conta de Automação está ativada. {% endhint %}
Ao executar um [sync](#syncing-from-the-shared-repository), será criado um Ambiente de Runtime do PowerShell personalizado "RJ-PowerShell-7.4" e os runbooks sincronizados serão movidos para este ambiente. Se necessário, os módulos do PowerShell requeridos 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 usar "Edit in Portal" nestes runbooks para os migrar manualmente. Certifique-se de "publicar" os runbooks para que a alteração tenha efeito. {% endhint %}
## Runbooks Comuns O RealmJoin mantém um [repositório online compartilhado de runbooks](https://github.com/realmjoin/realmjoin-runbooks). O 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 [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 aos seus colaboradores 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 a partir do repositório partilhado para a sua conta do Azure Automation clicando em "Sync runbooks with upstream" em ![Inicie uma sincronização dos seus runbooks](/files/f6fd3a5817953c24f7c1af6ffd694ab68c6f263b) Aguarde a mensagem "Sync completed". Mantenha a janela do navegador aberta enquanto o processo de sincronização estiver em execução. Tal como descrito na [convenção de nomenclatura](/pt/automacao/runbooks/naming-conventions.md) isto irá adicionar, atualizar e, se necessário, remover runbooks da conta do Azure Automation conectada para ficarem em sincronização 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 os runbooks existentes e novos para o seu ambiente. Por exemplo, pode * Usar modelos para partes comuns de informação, como localizações do Office * Preencher / pré-configurar parâmetros, como não permitir eliminar o objeto do utilizador ao desativar a conta * Ocultar determinados 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 associados aos 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 estão associados a cada utilizador, como redefinir uma palavra-passe. O RealmJoin Portal usa esta associação para oferecer os runbooks certos no contexto certo. Ver [Convenções de Nomenclatura](/pt/automacao/runbooks/naming-conventions.md) para saber como os runbooks são associados a determinados objetos no seu ambiente. ## Controlo de Acesso O acesso/permissões para usar determinados runbooks podem ser atribuídos 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 do Runbook](/pt/automacao/runbooks/runbook-permissions.md) para mais detalhes sobre como implementar estas regras no seu ambiente. --- # 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/pt/automacao/runbooks.md?ask=&goal= ``` `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.