# Instalando o agente do OpManager em dispositivos usando script de Inicialização

O agente do OpManager pode ser instalado em vários dispositivos usando o GPO do Windows. Você pode usar scripts de inicialização para implantar a instalação do agente automaticamente durante a inicialização do sistema, garantindo uma instalação consistente e sem complicações em todos os dispositivos alvo. Esse método é ideal para ambientes grandes onde é necessário um processo centralizado e automatizado de implantação.

> **Observação:** Certifique-se de que a rede tenha uma configuração baseada em domínio e não em grupo de trabalho (workgroup). Você pode até mapear o script para incluir todo o domínio, mesmo que tenha o agente do OpManager instalado apenas em alguns dispositivos, pois o agente será instalado apenas nos dispositivos que ainda não o tiverem instalado.

1. No console web do OpManager, acesse **Configurações → Descoberta → Implantar agente**.
2. Clique no botão **"Download"** para obter o arquivo zip do OpManager Agent. Extraia o arquivo zip e cole os arquivos extraídos **OpManagerAgent.msi** e **OPMAgentServerInfo.json** no diretório local.

> **OBSERVAÇÃO:** É obrigatório fazer o download de uma cópia nova do arquivo OpManagerAgent.zip e usar os arquivos contidos nele para o processo de instalação.

3. Identifique o(s) servidor(es) de domínio pai dos computadores cliente e copie os arquivos extraídos **OpManagerAgent.msi** e **OPMAgentServerInfo.json** para esse(s) servidor(es) de domínio.
4. No servidor de AD, clique em **Iniciar → Executar**.
5. Digite **gpmc.msc** e clique em **OK.**
6. Clique com o botão direito no domínio e selecione **Criar e vincular um GPO aqui.**

[![Instalação do agente do OpManager em dispositivos usando script de inicialização: janela Criar e vincular um novo GPO](https://www.manageengine.com/network-monitoring/help/images/agent-create-and-link-gpo.jpg)](https://www.manageengine.com/network-monitoring/help/images/agent-create-and-link-gpo.jpg)

7. Especifique um nome para o GPO.
8. Selecione o GPO.

> **Observação:** Estas etapas precisam ser seguidas caso você deseje instalar agentes apenas em alguns dispositivos selecionados (consulte esta [imagem](https://www.manageengine.com/network-monitoring/help/images/agent-gpo-select-devices.jpg)). Não siga estas etapas se quiser instalar agentes em todos os dispositivos.
>
> - Clique na aba **Scope**.
> - Na seção **Security Filtering**, clique em **Add.**
> - Na caixa de diálogo **Select User, Computer, or Group**, clique em **Object Types.**
> - Selecione tipos específicos de objeto de computador e clique em **"Okay".**
> - Especifique os nomes dos computadores e clique em **"Okay".**
> - Por fim, clique em **Check Names** e depois clique em **"Okay"** novamente.

9. Clique com o botão direito no GPO e clique em **"Edit".**
10. Para executar o **VBScript**, siga estas etapas (consulte esta [imagem](https://www.manageengine.com/network-monitoring/help/images/agent-gpo-vbscript.jpg)):

    - Expanda **Computer Configuration → Policies → Windows Settings → Scripts**
    - Clique com o botão direito em **Startup,** e clique em **Properties.**
    - Clique em **Show Files.**
    - Arraste e solte o arquivo [InstallOPMAgent.vbs](https://www.manageengine.com/network-monitoring/help/files/InstallOPMAgent.txt) (faça o download do arquivo .txt e renomeie-o para .vbs) e os arquivos extraídos **OpManagerAgent.msi** e **OPMServerInfo.json** para este local. Copie o caminho deste local:
      
      ```
      \\Nome do domínio\SysVol\Nome do domínio\Policies\{ID}\Machine\Scripts\Startup
      ```
      
      e feche a janela.
    - Na caixa de diálogo **Startup Properties**, clique em **Add.**
    - Navegue até o local e copie o caminho acessado:
      
      ```
      \\Nome do domínio\SysVol\Nome do domínio\Policies\{ID}\Machine\Scripts\Startup
      ```
    - Selecione o script **InstallOPMAgent.vbs.** Em seguida, especifique o caminho (local copiado) e o script conforme indicado abaixo:
      
      ```
      (\\Nome do domínio\SysVol\Nome do domínio\Policies\{ID}\Machine\Scripts\Startup)\InstallOPMAgent.vbs
      ```
    - Especifique o parâmetro do script conforme indicado abaixo:  
      **OpManagerAgent.msi**

11. Como alternativa ao VBScript, você também pode executar um **script PowerShell** para instalação do agente usando GPO. Para executar scripts PowerShell, siga estas etapas (consulte esta [imagem](https://www.manageengine.com/network-monitoring/help/images/agent-gpo-powershell-script.jpg)):

    - Certifique-se de que o PowerShell esteja habilitado em todos os computadores cliente antes da execução deste script.
    - Expanda **Computer Configuration → Policies → Windows Settings → PowerShell scripts.**
    - Clique com o botão direito em **Startup,** e clique em **Properties.**
    - Clique em **Show Files.**
    - Arraste e solte o arquivo [psinstallopmagent.ps1](https://www.manageengine.com/network-monitoring/help/files/psinstallopmagent.txt) (faça o download do arquivo .txt e renomeie-o para .ps1) e os arquivos extraídos **OpManagerAgent.msi** e **OPMAgentServerInfo.json** para este local. Copie o caminho deste local:
      
      ```
      \\Nome do domínio\SysVol\Nome do domínio\Policies\{ID}\Machine\Scripts\Startup
      ```
      
      e feche a janela.
    - Na caixa de diálogo **Startup Properties**, clique em **Add.**
    - Navegue até o local e copie o caminho acessado:
      
      ```
      \\Nome do domínio\SysVol\Nome do domínio\Policies\{ID}\Machine\Scripts\Startup
      ```
    - Selecione o script **psinstallopmagent.ps1.** Em seguida, especifique o caminho (local copiado) e o script conforme indicado abaixo:
      
      ```
      (\\Nome do domínio\SysVol\Nome do domínio\Policies\{ID}\Machine\Scripts\Startup)\psinstallopmagent.ps1
      ```
    - Especifique os parâmetros do script conforme indicado abaixo:  
      **OpManagerAgent.msi**

12. Clique em **"Okay"** para fechar a caixa de diálogo **Add a Script** e a caixa de diálogo **Startup Properties**, e feche também as janelas **Group Policy Object Editor** e **Group Policy Management**.

> **Observação:** Este script pode ser usado para implantar o agente em todos os computadores do domínio. Observe que o alvo não deve ser um grupo de usuários.

Este script será executado na próxima reinicialização dos computadores cliente após a implantação. Quando o script for executado com sucesso, o agente do OpManager será instalado em todos os computadores cliente. Você pode verificar esses dispositivos recém-adicionados na página Inventário no OpManager.

> **Observação:**
>
> - As propriedades de associação de arquivos .vbs devem estar definidas como **'Microsoft Windows (r) based script host'** em todos os computadores cliente, para garantir que o script seja executado corretamente. Se as propriedades de associação de arquivos tiverem sido modificadas para abrir o arquivo de script em um editor de texto, a execução falhará.
> - O objeto GPO do OpManager pode ser mantido como está para instalar o agente automaticamente em futuros computadores cliente.
> - Você não precisa se preocupar com a reinstalação do agente, pois o script foi escrito de forma a evitar reinstalações desnecessárias.
> - Você também não precisa se preocupar em atualizar o agente periodicamente. As atualizações do agente do OpManager são liberadas junto com os arquivos de instalação do OpManager, e o OpManager enviará automaticamente a atualização do agente para os computadores cliente sempre que ela estiver disponível.

Instalar o agente do OpManager em vários dispositivos usando o GPO do Windows pode ser útil, especialmente quando outros métodos de instalação falham. Abaixo estão alguns motivos comuns de falha na instalação do agente para ajudá-lo a identificar e resolver o problema.

- [Acesso negado](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#access_denied)
- [Caminho de rede não encontrado](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#network_path_not_found)
- [Nome de usuário ou senha desconhecidos](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#login_failure)
- [Nenhum provedor de rede aceitou o caminho de rede fornecido](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#network_path_not_accepted)
- [Espaço de armazenamento insuficiente para instalar o agente](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#not_enough_server_storage)

Se você tiver qualquer outro problema com a instalação do agente, por favor [entre em contato com nossa equipe de suporte](mailto:opmanager-support@manageengine.com) para que ele seja resolvido.