> 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 oferece aos administradores a capacidade de automatizar tarefas usando [Azure Automation](https://learn.microsoft.com/en-us/azure/automation/overview) para executar [PowerShell Runbooks](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 (integração/desligamento de usuários) * Criar Temporary Access Passes (TAPs) * Relatar uso de licenças M/O365 * Gerenciar aliases de email Você pode oferecer o RealmJoin Portal às suas equipes de suporte e administração para simplificar e melhorar a qualidade das suas operações diárias. ![](/files/c7f61bb967827c2b5944e1eef80b445bd8fdb60b) ### Migração para Ambientes de Execução do PowerShell O RealmJoin está atualmente no processo de migração do Windows PowerShell v5.1 para um 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 "Runtime Environment" na sua Conta de Automação esteja ativada. {% endhint %}
Ao executar uma [sincronização](#syncing-from-the-shared-repository), um ambiente personalizado de execução do PowerShell "RJ-PowerShell-7.4" será criado; os runbooks sincronizados serão movidos para esse ambiente. Se necessário, os módulos 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" %} **Runbooks personalizados / não sincronizados não serão atualizados automaticamente.** Você pode usar o Azure Portal e usar "Edit in Portal" nesses runbooks para migrá-los manualmente. Certifique-se de "publicar" os runbooks para que a alteração entre em vigor. {% endhint %}
## 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 aprimorados. É claro que você também pode incluir os seus próprios runbooks personalizados. O RealmJoin Portal permite que você importe esses runbooks por meio de [RealmJoin Runbook Management App](/pt/automacao/connecting-azure-automation/required-permissions.md#b31d828b-8bcb-45fc-8d72-5418777a5376) para o seu ambiente e oferece à sua equipe de suporte e administração uma interface fácil e não técnica para as tarefas cobertas pelos runbooks. ### Sincronização a partir do Repositório Compartilhado Você pode iniciar uma sincronização do repositório compartilhado 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. Conforme descrito na [convenção de nomenclatura](/pt/automacao/runbooks/naming-conventions.md) isso adicionará, atualizará e, se necessário, removerá runbooks da Conta do Azure Automation conectada para ficarem em sincronia com o repositório compartilhado do RealmJoin. Isso garante que seus runbooks estejam atualizados, incluindo melhorias, correções e novos recursos. ## Personalização Você pode personalizar os runbooks existentes e novos para o seu ambiente. Por exemplo, você pode * Usar modelos para partes comuns de informações, como locais de escritório * Pré-preencher / pré-configurar parâmetros, como não permitir a exclusão do objeto do usuário ao fazer o desligamento * Ocultar determinados campos/parametros Veja [Personalização de Runbooks ](/pt/automacao/runbooks/runbook-customization.md)para mais detalhes. ## Escopos Os runbooks no RealmJoin Portal têm escopo para os diferentes tipos de objetos no seu ambiente. Alguns runbooks operam no nível do Tenant / organização, como a criação de um relatório de licenças. Alguns runbooks têm escopo por usuário, como redefinir uma senha. O RealmJoin Portal usa esse escopo para oferecer os runbooks certos no contexto certo. Veja [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. ## Controle de Acesso O acesso/permissões para usar determinados runbooks pode ser concedido de forma granular no nível de um runbook. Por exemplo, as Permissões de Runbook podem ajudar você a: * Permitir acesso a este runbook apenas aos operadores de 3º nível * Permitir que apenas nossa equipe de suporte VIP altere o endereço de email do CEO Veja [Permissões de Runbook](/pt/automacao/runbooks/runbook-permissions.md) para detalhes sobre como implementar tais 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: ``` GET https://docs.realmjoin.com/pt/automacao/runbooks.md?ask= ``` 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.