> 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="" %} 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). Os 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 ajudá-lo a automatizar incluem: * Operações do ciclo de vida do utilizador (integração/saída de utilizadores) * Criação de Passes de Acesso Temporário (TAPs) * Relatório da utilização de licenças do M/O365 * Gestão de aliases de e-mail 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. ![](/files/c7f61bb967827c2b5944e1eef80b445bd8fdb60b) ### Migração para Ambientes de Execução do PowerShell O RealmJoin encontra-se atualmente em processo de migração do Windows PowerShell v5.1 para o PowerShell v7.4 [Ambiente de execução](https://learn.microsoft.com/en-us/azure/automation/manage-runtime-environment). {% hint style="info" %} Certifique-se de que a experiência de "Ambiente de execução" na sua Automation Account está ativada. {% endhint %}
Ao executar uma [sincronização](#syncing-from-the-shared-repository), será criado um ambiente de execução personalizado do PowerShell "RJ-PowerShell-7.4"; os runbooks sincronizados serão movidos para este ambiente. Se necessário, os módulos do 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 usar "Editar no 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 uma [repositório online partilhado de runbooks](https://github.com/realmjoin/realmjoin-runbooks). Destinam-se a abranger muitas operações comuns encontradas na maioria dos ambientes. Os runbooks são atualizados e melhorados continuamente. 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](/pt/automacao/connecting-azure-automation/required-permissions.md#b31d828b-8bcb-45fc-8d72-5418777a5376) para o seu ambiente e oferece ao seu pessoal de suporte e administração uma interface simples 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 de Automação do Azure clicando em "Sync runbooks with upstream" em ![Iniciar uma sincronização dos seus runbooks](/files/f6fd3a5817953c24f7c1af6ffd694ab68c6f263b) Aguarde a mensagem "Sincronização concluída". 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 conta do Azure Automation ligada para ficar em sincronia 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 elementos de informação comuns, como localizações de escritório * Pré-preencher / pré-configurar parâmetros, como não permitir eliminar o objeto de utilizador ao desativar o utilizador * Ocultar determinados campos/parâmetros Ver [Personalização de Runbooks ](/pt/automacao/runbooks/runbook-customization.md)para mais detalhes. ## Âmbitos Os runbooks no RealmJoin Portal têm âmbito para os 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 têm âmbito por utilizador, como a reposição de uma palavra-passe. O RealmJoin Portal utiliza este âmbito 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 atribuídos 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 o acesso a este runbook apenas aos operadores de 3.º nível * Permitir apenas à nossa equipa de suporte VIP alterar o endereço de e-mail do CEO Ver [Permissões de Runbook](/pt/automacao/runbooks/runbook-permissions.md) para obter 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.