---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Capacidades da Now Platform da Yokohama

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Instalação de um MID Server no Windows

# Instalação de um MID Server no Windows {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 19 min. de leitura

Instale MID Servers com o pacote de instalação do Windows orientado por MID Server. O pacote inclui um instalador que configura automaticamente o OpenJDK para ser executado no ambiente. O MID Server pode usar um JRE existente em vez do OpenJDK fornecido. Desinstale o MID Server para redistribuí-lo.  

|-|
|   |
[ ]

{#mid-server-install-prereqs__table_jvn_ds4_nhb}
* Verifique se o computador host atende a [Requisitos do sistema do MID Server](https://servicenow-prod.fluidtopics.net/NXzOqUZMfKAor4chulECSQ "Use estes requisitos mínimos de sistema para alocar recursos para hospedagem de computadoresMID Servers.").
* O MID Server requer a versão mínima do PowerShell 3.0 e suporta versões até o PowerShell 5.1.
* Certifique-se de que o serviço Pesquisa de experiência de aplicação da Microsoft esteja habilitado no host do MID Server. Se este serviço estiver desabilitado, o upgrade automático do MID Server poderá falhar, fazendo com que o MID Server fique inativo. Para obter informações sobre como gerenciar problemas com o serviço de experiência de aplicação, consulte [KB0597552](https://support.servicenow.com/nav_to.do?uri=/kb_view.do?sysparm_article=KB0597552).

{#mid-server-install-prereqs__ul_l5g_qpt_1gb} Java 17.0.12 é fornecido com o pacote do instalador do MID Server e é instalado no host para todos os novos MID Servers. O instalador configura automaticamente o Java 17.0.12 para ser executado no ambiente. Nenhuma configuração adicional é necessária. Esta versão oferece suporte para Windows MID Servers 64 bits e Linux MID Servers 64 bits. O MID Server requer uma versão mínima do JRE 17.0.10 e a versão 17.0.12 recomendada. Se você estiver usando uma versão anterior à 17.0.10, poderá ter problemas relacionados à criptografia.  
Nota:  
ServiceNow não é mais compatível com novas instalações de MID Servers de 32 bits ou upgrades para a versão Rome. A instalação do novo MID Server está bloqueada e pelo instalador MSI e RPM nos seguintes sistemas operacionais:

* CentOS 7
* Servidor Windows 2008
* Servidor Windows 2008 R2
* Windows 8
* Windows 10

{#mid-server-install-prereqs__ul_i2x_sht_4pb}Os MID Servers podem ser instalados manualmente em qualquer sistema operacional com o arquivo ZIP. No entanto, o Windows 10 não é compatível. A atualização automática de MID Servers não compatíveis com Rome cria um registro de problema em Problemas do MID Server (ecc_agent_issue). Para obter mais informações, consulte [Mudanças de plataforma compatíveis com MID Server \[KB0863694\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0863694).

Testes mostraram que o MID Server funciona conforme o esperado com o Oracle Java 11 versão 17.0.10. Se for necessário fazer upgrade do JRE para uma versão diferente, entre em contato com o representante de conta apropriado para obter suporte.  
Os MID Servers atualizados podem usar diferentes versões do Java, dependendo das versões do sistema operacional.

* Os MID Servers atualizados de versões anteriores usam o OpenJDK fornecido com o instalador do MID Server. Essa versão do OpenJDK foi testada e certificada para uso com esses MID Servers.
* MID Servers atualizados em qualquer outra versão do sistema operacional também fazem upgrade automaticamente do JRE para a versão fornecida com o pacote de instalação.
{#mid-server-install-prereqs__ul_zgd_42z_cgb}

## Instalar um MID Server no Windows com instalação orientada {#ariaid-title2}

Instale MID Servers com o pacote de instalação do Windows orientado por MID Server. O pacote inclui um instalador que configura automaticamente o OpenJDK para ser executado no ambiente.

### Antes de Iniciar

Função necessária: administrador ou mid_server

### Por Que e Quando Desempenhar Esta Tarefa

O instalador do Windows nativo guiado pelo MID Server configurará o MID Server com as configurações fornecidas. O instalador cria o serviço do MID Server e o atribui ao usuário fornecido. O instalador define as permissões do arquivo na pasta de instalação do MID Server. O instalador permite a definição das configurações de proxy. Opcionalmente, o instalador pode iniciar o MID Server automaticamente.

### Procedimento

1. Na instância, baixe o arquivo .msi de instalação do MID Server de MID ServerDownload.
2. Faça login na máquina host do Windows em que deseja instalar o MID Server. {#t_InstallAMIDServerOnWindows__step_MIDServerWindowsLogin}
{#t_InstallAMIDServerOnWindows__step_MIDServerWindowsLogin}
3. Coloque o instalador .msi no host do MID Server desejado.
4. Abra o instalador com privilégios de nível de administrador.
5. Use o instalador para inserir as seguintes informações.  
   {#t_InstallAMIDServerOnWindows__table_ohg_3xm_wcb__entry__2}{#t_InstallAMIDServerOnWindows__MIDproxyBypassNote}

   | Campo | Descrição |
   |-|-|
   | Tipo de Autenticação | Básico :   Autenticação baseada em nome de usuário e senha. Mútua :   Autenticação baseada em certificado de cliente. Consulte [Armazenamento de chaves unificado do MID Server](https://servicenow-prod.fluidtopics.net/NAhZXwJ~NZMHrfv1uUC4~g#mid-unified-keystore "O armazenamento de chave unificado do MID Server permite que todos os produtos no MID Server usem certificados comuns e pares de chaves. Este recurso permite que as aplicações usem o mesmo canal de comunicação seguro com o MID Server que o MID Server usa para se conectar à instância.") para obter mais informações sobre autenticação mútua. Nota: A seleção da autenticação mútua desabilita os campos de nome de usuário e senha do MID Server. Os campos desabilitados não são gravados no config.xml. |
   | URL da instância da ServiceNow | Insira o URL completo da sua instância, por exemplo: `https://mycompanyinstace.service-now.com` |
   | Nome dos usuário do MID Server da ServiceNow | Insira o nome de [usuário do MID Server](https://servicenow-prod.fluidtopics.net/GEVKZHPzV05ZhNOU1C9ihQ#t_SetupMIDServerRole "Para se comunicar com a instância, os MID Servers precisam de um ID de usuário e a função apropriada. Crie o ID do usuário para um MID Server e conceda ao ID a função mid_server. Para evitar falha na validação do MID Server, o sistema executa regras de negócios para monitorar as configurações selecionadas para usuários do MID Server.") que você já criou. O usuário do MID Server deve ter a função mid_server. |
   | Senha do MID Server da ServiceNow | Insira a senha do usuário no nome de usuário do MID Server da ServiceNow. |
   | Revogação de certificado | Esta caixa de seleção é marcada por padrão para habilitar políticas de revogação de certificado para melhorar a segurança. Para obter mais informações sobre a revogação de certificados, consulte [Políticas de verificação de certificação do MID Server](https://servicenow-prod.fluidtopics.net/Gj_1D_G_I0W5Xvrs0b6ZJg "O MID Server usa três tipos de verificações de segurança para proteger o tráfego externo. As verificações de segurança usam validação de certificado TLS/SSL, validação de nome de host e validação de OCSP para melhorar a segurança. Controle essas verificações de segurança com a tabela de políticas de verificação de certificados do MID Server."). Ao testar uma conexão com a revogação de certificado habilitada, o instalador verifica se a porta OCSP 80 está aberta e a página de confiança está acessível. Se o teste de conexão falhar devido à verificação de revogação do certificado, o erro deverá ser corrigido e testado novamente ou a verificação de revogação do certificado deverá ser desabilitada. A verificação de revogação do certificado não é necessária para a instalação bem-sucedida. |
   | Usar proxy | Marque esta caixa de seleção se seu MID Server se comunicar por meio de um proxy para se conectar à instância. Nota: O servidor proxy deve usar a autenticação básica para que o MID Server se conecte à instância. O MID Server pode ignorar servidores proxy cujo endereço DNS/IP esteja listado no parâmetro de configuração mid.cloud.discovery.proxy.exclusion.list. Consulte [Propriedade do MID Server](https://servicenow-prod.fluidtopics.net/vcqAscy_gDX5fVfG3rBq2g#r_MIDServerProperties "As propriedades controlam o comportamento de todos os MID Servers ou de um determinado MID Server.") para obter mais informações. |
   | Host do proxy | Insira o nome do host do servidor proxy ou o endereço IP. Não inclua o protocolo no nome do host. Por exemplo, insira `proxyserver.domain.com` e não insira `https://proxyserver.domain.com`. |
   | Porta do proxy | Insira a porta pela qual o servidor proxy se comunica. Se você deixar este campo em branco, ele deverá usar o número da porta padrão do servidor proxy. |
   | Nome de usuário do proxy | Insira o nome de usuário que tem direitos de administrador para o servidor proxy. |
   | Senha do Proxy | Insira a senha para o nome de usuário. |
   [ ]

   {#t_InstallAMIDServerOnWindows__table_ohg_3xm_wcb} {#t_InstallAMIDServerOnWindows__step_WindowsEnterInfo}
{#t_InstallAMIDServerOnWindows__step_WindowsEnterInfo}
6. Clique em Testar sua conexão para validar as credenciais e as informações da instância.  
   Se você encontrar algum erro, verifique as informações inseridas.
7. Clique em Avançar.
8. Configure o nome do MID Server e os parâmetros da conta de serviço (consulte a tabela).  
   {#t_InstallAMIDServerOnWindows__table_epz_ngn_wcb__entry__2}

   | Campo | Descrição |
   |-|-|
   | Nome do MID Server | Insira o nome do MID Server. Aviso: Os nomes do MID Server não podem começar com mid.server. |
   | Nome da conta de serviço | Nome de usuário da conta de serviço que será usada para executar o serviço do MID Server. Para obter informações sobre como criar contas de serviço, consulte [Criar uma conta de serviço do Windows com "Fazer logon como serviço" \[KB0867669\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867669). O campo Nome da conta de serviço é um menu suspenso editável. Selecione um valor no menu suspenso ou digite um novo valor no campo de texto. Somente as contas com a política log on as service são exibidas na lista suspensa. As Contas de serviço gerenciado de grupo (gMSA) que herdam a política log on as service de seus grupos não são exibidas na lista suspensa. No entanto, você pode instalar o serviço do MID Server usando essas contas, inserindo manualmente o nome da conta de serviço no menu suspenso editável. O nome pode seguir três formatos. 1. Se a conta de serviço for local para o computador, você poderá fornecer apenas o nome.Exemplo: My_Local_Service_Account 2. Se a conta de serviço for local para o computador, você poderá fornecer "." como o nome de domínio da conta.Exemplo: .\\My_Local_Service_Account 3. Qualquer conta pode seguir o formato {domain}\\{username}.Por exemplo: MY-COMPUTER-DOMAIN\\My_Domain_Service_Account {#t_InstallAMIDServerOnWindows__ol_a52_w2f_tlb} Adicione uma nova conta de serviço local selecionando o botão +. Este botão abre a janela Configurar novo usuário local, que tem três campos. * Nome da conta de serviço: digite o nome da nova conta de serviço. * Senha da conta de serviço: digite a senha da nova conta de serviço. * Redigitar a senha: confirme a senha da nova conta de serviço. {#t_InstallAMIDServerOnWindows__ul_ifr_kr2_vrb} Quando um usuário de Conta de serviço gerenciado (gMSA) do grupo é selecionado, o campo de senha é removido porque as senhas dos usuários do gMSA são gerenciadas pelo Active Directory. Nota: As credenciais da conta de serviço fornecidas devem atender aos requisitos a seguir, além de ser uma conta válida. * O usuário não pode ser um sistema local ou uma conta de nível de administrador (administrador local, administrador de domínio etc.) * A conta de serviço fornecida tem a permissão de log on as service, que é necessária para que uma conta seja usada como log on user para um serviço. {#t_InstallAMIDServerOnWindows__ul_o2s_rpn_hmb} |
   | Senha da conta de serviço | Senha da conta de serviço que será usada para executar o serviço do MID Server. |
   | Definir nome do serviço manualmente | Marque esta caixa de seleção se quiser definir manualmente o nome do serviço e o nome de exibição do MID Server. Observação: o servidor proxy deve usar a autenticação básica para que o MID Server se conecte à instância. |
   | Nome do wrapper do MID Service | Modifique este campo se necessário. Ele é preenchido automaticamente com o prefixo `snc_mid_` no nome do MID Server. Na maioria dos casos, você não precisa modificar isso. |
   | Nome de exibição do wrapper do MID Server | Modifique este campo se necessário. Ele é preenchido automaticamente com o prefixo `ServiceNow MID Server_` ao nome do MID Server. Na maioria dos casos, você não precisa modificar isso. |
   [ ]

   {#t_InstallAMIDServerOnWindows__table_epz_ngn_wcb}
9. Clique em Avançar e selecione uma pasta de destino para a instalação.  
   Os usuários podem inserir manualmente um caminho de arquivo válido existente ou usar o botão "Alterar" para abrir uma página de navegação onde podem escolher o local de instalação.
10. Clique em Avançar para exibir o resumo.  

    Selecione Iniciar MID Server após a instalação se quiser iniciar o MID Server imediatamente após a instalação. Se você quiser fazer mudanças de configuração adicionais, antes de iniciar o MID Server, deixe esta caixa desmarcada. Se a autenticação mútua for selecionada, os campos de nome de usuário e senha do MID Server serão removidos.  
    Nota:  
    Se o MID Server não iniciar, a causa pode ser um nome duplicado ou vários serviços que apontam para o mesmo caminho do executável. Isso pode acontecer quando você tem MID Servers não instalados anteriormente por meio do instalador. Consulte [Falha ao iniciar o MID Server](https://servicenow-prod.fluidtopics.net/pMI_hZgUj1rOxqMoI9Fh3Q "Quando um MID Server recém-instalado falha ao iniciar ou é encerrado prematuramente, a configuração incorreta pode ser a responsável.") para obter detalhes.
11. Clique em Página da lista de MID Servers.  
    O instalador abre a lista de MID Servers da sua instância. {#t_InstallAMIDServerOnWindows__step_OpenMIDServerList}
{#t_InstallAMIDServerOnWindows__step_OpenMIDServerList}
12. Selecione o nome do MID Server na lista.  
    Nota:  
    Pode levar alguns segundos para que o MID Server estabeleça uma conexão com sua instância.  
    O sistema exibe o registro do MID Server. {#t_InstallAMIDServerOnWindows__step_SelectMIDServer}
{#t_InstallAMIDServerOnWindows__step_SelectMIDServer}
13. Em Links relacionados, clique em Validar.  
    O MID Server validado muda para Sim. {#t_InstallAMIDServerOnWindows__step_StartValidateMidServer}
{#t_InstallAMIDServerOnWindows__step_StartValidateMidServer}{#t_InstallAMIDServerOnWindows__steps_gy2_wzp_15}

### O que Fazer Depois

Para fazer upgrade do MID Server, consulte [Upgrades do MID Server](https://servicenow-prod.fluidtopics.net/BUH86E6VZA5MlYcoDLORHQ "Faça upgrade dos MID Servers manualmente ou automaticamente na instância. O upgrade automático do MID Server é acionadao quando a instância é atualizada e o MID Server não tem mais a mesma versão. O novo pacote do MID Server é baixado em install.service-now.com, substitui o anterior e o MID Server é iniciado com a nova versão.") para procedimentos e requisitos.

## Desinstalar um MID Server no Windows com instalação orientada {#ariaid-title3}

O instalador do Windows nativo guiado pelo MID Server também oferece suporte à desinstalação orientada do MID Server.

### Antes de Iniciar

Função necessária: administrador

Há três maneiras de desinstalar um MID Server depois de instalá-lo com o instalador nativo guiado do Windows.

### Procedimento

1. No host do MID Server, navegue até Painel de controleProgramasProgramas e recursosDesinstalar um programa.
   1. Desinstale o programa com o nome do MID Server.
   {#mid-windows-guided-uninstall__substeps_mdl_blq_3mb}
2. **Opcional:** Como alternativa, navegue até ConfiguraçõesApps
   1. Desinstale o programa com o nome do MID Server.
   {#mid-windows-guided-uninstall__substeps_x4t_clq_3mb}
3. **Opcional:** O MID Server também pode ser desinstalado com o script de desinstalação silenciosa.  
   Isso é útil para desinstalar vários MID Servers. Para obter mais informações, consulte [Instalação silenciosa e desinstalação do Windows MID Server](https://servicenow-prod.fluidtopics.net/zTGu7Gii3RvU_oDDE6hpzw#mid-windows-silent-install "A instalação silenciosa do MID Server usa parâmetros predefinidos e não requer entrada do usuário depois de iniciada. Você pode usar a instalação silenciosa em várias máquinas ao mesmo tempo para configurar rapidamente uma rede e para garantir que todos os MID Servers tenham as mesmas configurações de instalação.").
{#mid-windows-guided-uninstall__steps_w3h_v5j_3mb}

## Configurar as credenciais de serviço do Windows MID Server {#ariaid-title4}

As credenciais de serviço do MID Server são necessárias para gerenciar o serviço do MID Server na máquina host, incluindo sua capacidade de upgrade automático com êxito.

### Antes de Iniciar

Função necessária: administrador

### Por Que e Quando Desempenhar Esta Tarefa

Se você instalou o MID Server usando o instalador nativo, não será necessário concluir este procedimento. No entanto, para mudar o usuário do serviço após a instalação por qualquer motivo, use este procedimento.

As credenciais de serviço do Windows controlam o nível de privilégio no dispositivo. O usuário não deve ser um sistema local ou uma conta de nível de administrador (administrador local, administrador de domínio etc.) A conta de serviço fornecida deve ter a permissão de logon como serviço, que é um requisito para uma conta a ser usada como logon de usuário para um serviço.  
Nota:  
As credenciais de serviço do Windows não são iguais às credenciais de usuário do MID Server, que permitem a comunicação entre o MID Server e a instância. Você deve configurar essas duas credenciais separadamente. Consulte [Criar o usuário do MID Server e conceder a função](https://servicenow-prod.fluidtopics.net/GEVKZHPzV05ZhNOU1C9ihQ#t_SetupMIDServerRole "Para se comunicar com a instância, os MID Servers precisam de um ID de usuário e a função apropriada. Crie o ID do usuário para um MID Server e conceda ao ID a função mid_server. Para evitar falha na validação do MID Server, o sistema executa regras de negócios para monitorar as configurações selecionadas para usuários do MID Server.") para obter instruções sobre credenciais de usuário do MID Server.

### Procedimento

1. Abra o console de serviços do Windows. {#t_ConfigMIDSvrSvcCredentials__step_OpenWinServicesConsole}
{#t_ConfigMIDSvrSvcCredentials__step_OpenWinServicesConsole}
2. Clique duas vezes no serviço ` `ServiceNow` ` `<MID Server name>` para cada MID Server. {#t_ConfigMIDSvrSvcCredentials__step_OpenMidServer}
{#t_ConfigMIDSvrSvcCredentials__step_OpenMidServer}
3. Selecione a guia Fazer Logon. {#t_ConfigMIDSvrSvcCredentials__step_SelectLogOn}
{#t_ConfigMIDSvrSvcCredentials__step_SelectLogOn}
4. Escolha um usuário que não seja administrador e forneça a senha desse usuário. {#t_ConfigMIDSvrSvcCredentials__step_LogOnAs}
{#t_ConfigMIDSvrSvcCredentials__step_LogOnAs}
5. Na guia Geral, defina o Tipo de inicialização.  
   O campo é definido como Automático por padrão. {#t_ConfigMIDSvrSvcCredentials__step_StartupType}
{#t_ConfigMIDSvrSvcCredentials__step_StartupType}
6. Clique em OK.
7. Reinicie o serviço ServiceNow \<nome do MID Server\> e certifique-se de que ServiceNow\\\<MID Server name\>\\agent\\logs\\agent0.log não tem mensagens de erro.  
   Se o MID Server não iniciar, consulte o artigo de conhecimento ServiceNow Analise o log do agente em busca de erros do MID Server (artigo [KB0535148](https://support.servicenow.com/nav_to.do?uri=/kb_view.do?sysparm_article=KB0535148)). {#t_ConfigMIDSvrSvcCredentials__step_RestartService}
{#t_ConfigMIDSvrSvcCredentials__step_RestartService}
8. Na instância à qual este MID Server está conectado, navegue até MID ServerServidores.  
   Se Descobertase estiver instalado, navegue alternadamente até DescobertaMID Servers. Todos os MID Servers conectados a esta instância são listados.
9. Certifique-se de que o Status do MID Server que você acabou de instalar esteja Ativo. {#t_ConfigMIDSvrSvcCredentials__step_StatusUp}
{#t_ConfigMIDSvrSvcCredentials__step_StatusUp}

## Instalação silenciosa e desinstalação do Windows MID Server {#ariaid-title5}

A instalação silenciosa do MID Server usa parâmetros predefinidos e não requer entrada do usuário depois de iniciada. Você pode usar a instalação silenciosa em várias máquinas ao mesmo tempo para configurar rapidamente uma rede e para garantir que todos os MID Servers tenham as mesmas configurações de instalação.

### Instalação silenciosa do MID Server {#mid-windows-silent-install__section_aqb_2fm_hmb}

Nota:  
Todos os comandos de instalação/desinstalação silenciosa devem ser executados com privilégios de administrador.  
Para instalar silenciosamente o MID Server em um sistema Windows, baixe o script anexado ao artigo da Base de conhecimento [Instalação e desinstalação silenciosa do MID Server do Windows](https://support.servicenow.com/kb_view.do?sysparm_article=KB0854442). Coloque o arquivo na máquina host do MID Server de destino e execute o seguinte comando no prompt de comando. Você também pode executar o script diretamente do powershell.

```
powershell -command “.\SilentInstall.ps1 -<parameter_name1> ‘<value for parameter1>’ -<parameter_name2> ‘<value for parameter2>’ etc…”
```

O script verifica os seguintes parâmetros obrigatórios:

* MSI_FILE_NAME: o nome do arquivo MSI usado para a instalação.
* INSTALL_LOCATION : o local para instalar o MID Server.
* INSTANCE_URL: a instância de destino da ServiceNow à qual o MID Server se conectará.
* MID_USERNAME: o nome da conta da instância.
* MID_PASSWORD: a senha da conta da instância.
* MID_NAME: o nome do MID Server.
* SERVICE_ACCOUNT_NAME: o nome da conta de serviço.
* SERVICE_ACCOUNT_PASSWORD: a senha da conta de serviço.
{#mid-windows-silent-install__ul_qgf_4fm_hmb}  
Os parâmetros a seguir são opcionais:

* LOG_NAME: habilita o registro em log e coloca os logs no arquivo nomeado por este parâmetro.
* START_MID: define o MID Server para iniciar automaticamente após o término da instalação.
* USE_PROXY: habilita o uso de um proxy. Se você escolher este comando, os parâmetros a seguir se tornarão obrigatórios.
  * PROXY_HOST: o nome do host do proxy.
  * PROXY_PORT: o número da porta do proxy.
  * PROXY_USERNAME: o nome de usuário do proxy. Se não houver nome de usuário, insira ''.
  * PROXY_PASSWORD: a senha do proxy. Se não houver senha, insira ''.
  {#mid-windows-silent-install__ul_dwz_lgm_hmb}
* MANUAL_SERVICE_NAME: o nome do serviço. Se você escolher este comando, os parâmetros a seguir se tornarão obrigatórios:
  * SERVICE_NAME: o nome do serviço.
  * SERVICE_DISPLAY_NAME: o nome de exibição do serviço.
  {#mid-windows-silent-install__ul_grk_ngm_hmb}
* MUTUAL_AUTH: habilita a autenticação mútua. Se esta opção estiver habilitada, MID_USERNAME e MID_PASSWORD não serão necessários. Para mais informações, consulte [Armazenamento de chaves unificado do MID Server](https://servicenow-prod.fluidtopics.net/NAhZXwJ~NZMHrfv1uUC4~g#mid-unified-keystore "O armazenamento de chave unificado do MID Server permite que todos os produtos no MID Server usem certificados comuns e pares de chaves. Este recurso permite que as aplicações usem o mesmo canal de comunicação seguro com o MID Server que o MID Server usa para se conectar à instância.").

{#mid-windows-silent-install__ul_whv_cgm_hmb}  
Nota:  
Os parâmetros START_MID, USE_PROXY, MUTUAL_AUTH e MANUAL_SERVICE_NAME são interruptores. Eles usam o formato -\<switch_param_name\> e não são seguidos por um valor.

Depois que o script for executado, verifique se os arquivos do MID Server, o serviço e a entrada em Programas e Recursos estão instalados. Se você habilitou o registro em log, verifique as informações de log no arquivo especificado pelo parâmetro LOG_NAME.  
Um exemplo de comando de instalação silenciosa do MID Server:

```
powershell -command ".\SilentInstall.ps1 -MSI_FILE_NAME 'MID-Installer.msi' -INSTALL_LOCATION 'C:\Users\Administrator' -INSTANCE_URL 'https://my-instance-name.service-now.com' -MID_USERNAME 'mid_server' -MID_PASSWORD 'mid_password' -MID_NAME 'Silent_Install_MID' -SERVICE_ACCOUNT_NAME 'DOMAIN\My_Service_Account' -SERVICE_ACCOUNT_PASSWORD 'Service_Account_Password' -LOG_NAME 'Silent_Install_Log.txt'"
```

Um exemplo de comando usando a opção START_MID:

```
powershell -command ".\SilentInstall.ps1 -MSI_FILE_NAME 'MID-Installer-Wix.msi' -INSTALL_LOCATION 'C:\Users\Administrator' -INSTANCE_URL 'https://my-instance-name.service-now.com' -MID_USERNAME 'DOMAIN\My_Service_Account' -MID_PASSWORD 'mid_password' -MID_NAME 'Silent_Install_MID' -SERVICE_ACCOUNT_NAME 'DOMAIN\My_Service_Account’ -SERVICE_ACCOUNT_PASSWORD 'Service_Account_Password' -LOG_NAME 'Silent_Install_Log.txt' -START_MID"
```

### Desinstalação silenciosa do MID Server {#mid-windows-silent-install__section_o23_12m_hmb}

Para desinstalar silenciosamente o MID Server em um sistema Windows, baixe o script anexado ao artigo da Base de conhecimento [Instalação e desinstalação silenciosa do MID Server do Windows](https://support.servicenow.com/kb_view.do?sysparm_article=KB0854442). Em seguida, execute o script usando o prompt de comando. Também pode ser executado diretamente do powershell.

```
powershell -command “.\SilentUninstall.ps1 -MID_NAME ‘<value for MID_NAME>’ -LOG_NAME ‘<value for LOG_NAME>’”
```

O script requer o parâmetro obrigatório MID_NAME, que é o nome do MID Server que você deseja desinstalar.

O parâmetro opcional LOG_NAME ativa o registro em log da desinstalação e coloca os registros no arquivo nomeado por este parâmetro.

Depois que o script for executado, verifique se os arquivos do MID Server, o serviço e a entrada em Programas e Recursos foram desinstalados. Se você habilitou o registro em log, verifique as informações de log no arquivo especificado pelo parâmetro LOG_NAME.  
Um exemplo de comando de desinstalação silenciosa do MID Server:

```
powershell -command ".\SilentUninstall.ps1 -MID_NAME 'silent_install_cmd' -LOG_NAME
      'uninstall.txt'"
```

## Instalação manual de um MID Server no Windows {#ariaid-title6}

Instale MID Servers com o pacote de instalação do arquivo ZIP e verifique se ele está ativo.

### Antes de Iniciar

Função necessária: administrador ou mid_server

### Por Que e Quando Desempenhar Esta Tarefa

Clique neste link para exibir o vídeo de instalação:  
Os MID Servers podem ser configurados para serem executados usando contas não administrativas. O uso de contas não administrativas em conjunto com a imposição de permissão de arquivo pode melhorar a segurança restringindo o acesso aos arquivos do MID Server. Se você optar por executar um MID Server com uma conta não administrativa, há limitações que mudam o comportamento de outras aplicações. As seguintes mudanças de comportamento podem ocorrer:

* A conta do MID Server precisa de credenciais apropriadas para executar uma programação de Descoberta. Se as credenciais forem insuficientes, o MID Server retornará para os privilégios da conta do usuário. Uma conta de usuário que não seja administrador pode não ter os privilégios necessários para acessar o destino da Descoberta.
* O Mapeamento de Dependência de Aplicação Aprimorada (ADME) e a Descoberta Baseada em Arquivo (FBD) podem não funcionar por padrão. Para corrigir esse problema, os usuários que não são administradores precisam ter permissão para ler/gravar na pasta de compartilhamento do administrador.
{#mid-windows-manual-install__ul_k1y_mmb_sjb}

### Procedimento

1. Faça login na máquina host do Windows em que deseja instalar o MID Server. {#mid-windows-manual-install__step_MIDServerWindowsLogin}
{#mid-windows-manual-install__step_MIDServerWindowsLogin}
2. Crie uma pasta para o MID Server no nível superior da unidade, como ServiceNow\\MID Server1. {#mid-windows-manual-install__step_MIDServerWindowsCreateDir}
{#mid-windows-manual-install__step_MIDServerWindowsCreateDir}
3. Baixe o arquivo do MID para a nova pasta. {#mid-windows-manual-install__step_MIDServerWindowsMoveFile}
{#mid-windows-manual-install__step_MIDServerWindowsMoveFile}
4. Clique com o botão direito no arquivo e selecione Extrair tudo. {#mid-windows-manual-install__step_MIDServerWindowsExtract}
{#mid-windows-manual-install__step_MIDServerWindowsExtract}
5. Navegue até a pasta service-now\\\<mid server name\>\\agent que foi criada quando o arquivo foi extraído. {#mid-windows-manual-install__step_MIDServerWindowsGoToAgent}
{#mid-windows-manual-install__step_MIDServerWindowsGoToAgent}
6. Para configurar o MID Server manualmente, edite o arquivo config.xml com um editor de texto como o WordPad:
   1. Encontre o elemento de \<parameter name="url" value="https://YOUR_INSTANCE.service-now.com" /\> e altere o valor para o URL da sua instância.
   2. Insira as credenciais do usuário MID nos parâmetros mid.instance.username e mid.instance.password .  
      Por padrão, o MID Server usa autenticação básica para mensagens SOAP. O valor da senha também é autenticação criptografada.
   3. **Opcional:** Encontre o elemento \<parameter name="name" value="YOUR_MIDSERVER_NAME_GOES_HERE" /\> e altere o valor do nome do MID Server.
   4. **Opcional:** Insira as informações de conexão do servidor proxy.  
      Remova as tags de comentário apropriadas das informações de configuração do proxy.  
      Por exemplo, você pode configurar estes parâmetros:
      * mid.proxy.use_proxy
      * mid.proxy.host
      * mid.proxy.port
      * mid.proxy.username
      * mid.proxy.password
      {#mid-windows-manual-install__ul_iy2_wzp_15}
   {#mid-windows-manual-install__substeps_hy2_wzp_15} {#mid-windows-manual-install__step_MIDServerWindowsEditConfigFile}
{#mid-windows-manual-install__step_MIDServerWindowsEditConfigFile}
7. **Opcional:** Se você quiser instalar o MID Server como um usuário não administrador, siga estas etapas.
   1. Edite o. `wrapper-override.conf `arquivo.
   2. Descomente o. `wrapper.ntservice.conta `E especifique o Nome da conta de serviço.
   3. Ou descomentar `wrapper.ntservice.password.prompt `ou descomentar `wrapper.ntservice.senha `e forneça uma senha.  
      Habilitando `wrapper.ntservice.password.prompt `solicita uma senha ao instalar o serviço. Habilitando `wrapper.ntservice.senha `define uma senha imediatamente, mas é menos seguro.
   4. Descomente o. `wrapper.ntservice.permissions.1.conta `E especifique o Nome da conta de serviço.
   5. Descomentar `wrapper.ntservice.permissions.1.permitir `mas não edite.
   6. Descomentar `wrapper.name `e especifique o nome do serviço desejado e remova o comentário `wrapper.displayname `e especifique o nome de exibição desejado.  
      . `wrapper.name `deve ser exclusivo no host e nenhum outro serviço pode compartilhar o mesmo nome.
   {#mid-windows-manual-install__substeps_ll2_bwz_12c}
8. Execute start.bat para iniciar o MID Server.  
   Se `wrapper.ntservice.password.prompt `foi definido na etapa 7c, insira a senha quando solicitado. Se não houver senha, prossiga sem inserir uma.
9. Na instância, em Links relacionados, selecione Validar.  
   O MID Server validado muda para Sim. {#mid-windows-manual-install__step_StartValidateMidServer}
{#mid-windows-manual-install__step_StartValidateMidServer}{#mid-windows-manual-install__steps_gy2_wzp_15}

## Desinstalar um Windows MID Server após a instalação manual {#ariaid-title7}

O MID Server funciona como um serviço autônomo. É possível remover um serviço de MID Server autônomo para acomodar tarefas como a reimplantação do MID Server em outra máquina host ou a mudança do nome exclusivo de um MID Server ao implantar vários MID Servers.

### Antes de Iniciar

Função necessária: administrador

Este procedimento é somente para usuários que instalam o MID Server usando o arquivo ZIP.

### Procedimento

1. Interrompa o serviço do MID Server em execução, usando um destes procedimentos:  
   * Linha de comando do Windows: no diretório inicial do MID Server (agente), execute <kbd class="ph userinput">stop.bat</kbd>.
   * Console de serviços do Windows: no console de serviços do Windows, clique com o botão direito do mouse em ServiceNow <var class="keyword varname">nome do MID Server</var> e então selecione parar.
   {#uninstall-windows-mid-server__ul_gpm_s3g_b2b}
2. Em um prompt de comando, acesse o diretório \\agent\\bin no diretório de instalação do MID Server e clique duas vezes no arquivo UninstallMID-NT.bat.
{#uninstall-windows-mid-server__steps_esv_43g_b2b}

### O que Fazer Depois

[Valide](https://servicenow-prod.fluidtopics.net/X0AsWziv8iQ24U_GC5H_jw "Você deve validar manualmente o MID Server após sua instalação para habilitá-lo a executar tarefas de automação. Você pode invalidar um MID Server que você suspeita que tenha sido comprometido para impedir que ele acesse as credenciais de automação na instância ou execute probes de saída de ECC.") o MID Server para prepará-lo para uso.

## Configurar um MID Server no Windows para usar um JRE existente {#ariaid-title8}

É possível optar por usar um JRE existente para o MID Server em vez do OpenJDK fornecido com o instalador do MID Server.

### Antes de Iniciar

Certifique-se de que sua versão do JRE seja compatível. Consulte [Requisitos do sistema do MID Server](https://servicenow-prod.fluidtopics.net/NXzOqUZMfKAor4chulECSQ "Use estes requisitos mínimos de sistema para alocar recursos para hospedagem de computadoresMID Servers.") para obter detalhes.

Função necessária: administrador

### Por Que e Quando Desempenhar Esta Tarefa

Ao optar por usar seu próprio JRE, você se torna responsável por atualizá-lo conforme necessário. Para obter um procedimento detalhado e avisos sobre como mudar o JRE, consulte [KB0778272](https://support.servicenow.com/kb_view.do?sysparm_article=KB0778272).

### Procedimento

1. Navegue até este arquivo no diretório de instalação do MID Server:  
   agent/conf/wrapper-override.conf
2. Para especificar o executável Java existente que deseja usar, adicione esta linha ao arquivo:  
   `wrapper.java.command={`your_java_executable`}`

   Para obter mais informações, consulte a [documentação](https://wrapper.tanukisoftware.com/doc/english/prop-java-command.html) de propriedade wrapper do serviço Java.
3. Salve o arquivo.
{#configure-customer-jre-windows__steps_bpp_3nw_bgb}

