Instalação de um MID Server no Windows

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 20 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.

    Configurar indicador para a fase de instalação Garantir que o MID Server pode se conectar a elementos dentro e fora da redeBaixar e instalar o MID Server em um host Linux ou WindowsConfigurar o seu MID ServerConfigurar a segurança do MID ServerGarantir que o MID Server pode se conectar a elementos dentro e fora da redeBaixar e instalar o MID Server em um host Linux ou WindowsConfigurar o seu MID ServerConfigurar a segurança do MID Server
    • Verifique se o computador host atende a Requisitos do sistema do MID Server.
    • 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.
    O Java 11.0.17 é fornecido com o pacote do instalador MID Server e é instalado no host para todos os novos MID Servers. O instalador configura automaticamente o Java 11.0.17 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 11.0.8 e a versão 11.0.17 recomendada. Se você estiver usando uma versão anterior à 11.0.8, 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
    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].

    Testes mostraram que o MID Server funciona conforme o esperado com o Oracle Java 11 versão 11.0.5. 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.

    Instalar um MID Server no Windows com instalação orientada

    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 em MID Server > Baixar.
    2. Faça login na máquina host do Windows em que deseja instalar o MID Server.
    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.

      Um exemplo de instalação do MID Server.

      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 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 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.

      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 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.
    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).

      Parâmetros do MID.

      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].

      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

      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.

      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.
      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.
    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.
      Iniciando o MID Server.

      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 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.
    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.
    13. Em Links relacionados, clique em Validar.
      O MID Server validado muda para Sim.

    O que Fazer Depois

    Para fazer upgrade do MID Server, consulte Upgrades do MID Server para procedimentos e requisitos.

    Desinstalar um MID Server no Windows com instalação orientada

    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é o Painel de controle > Programas > Programas e recursos > Desinstalar um programa.
      1. Desinstale o programa com o nome do MID Server.
    2. Opcional: Como alternativa, navegue até Configurações > Apps
      1. Desinstale o programa com o nome do MID Server.
    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.

    Configurar as credenciais de serviço do Windows MID Server

    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 para obter instruções sobre credenciais de usuário do MID Server.

    Procedimento

    1. Abra o console de serviços do Windows.
    2. Clique duas vezes no serviço ServiceNow <MID Server name> para cada MID Server.
    3. Selecione a guia Fazer Logon.
    4. Escolha um usuário que não seja administrador e forneça a senha desse usuário.
    5. Na guia Geral, defina o Tipo de inicialização.
      O campo é definido como Automático por padrão.
    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).
    8. Na instância à qual este MID Server está conectado, navegue até MID Server > Servidores.

      Se Descoberta estiver instalado, navegue alternativamente para Descoberta > MID 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.

    Instalação silenciosa e desinstalação do Windows MID Server

    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

    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. 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.
    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 ‘’.
    • 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.
    • 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.
    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

    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. 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

    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:

    Procedimento

    1. Faça login na máquina host do Windows em que deseja instalar o MID Server.
    2. Crie uma pasta para o MID Server no nível superior da unidade, como ServiceNow\MID Server1.
    3. Baixe o arquivo do MID para a nova pasta.
    4. Clique com o botão direito no arquivo e selecione Extrair tudo.
    5. Navegue até a pasta service-now\<mid server name>\agent que foi criada quando o arquivo foi extraído.
    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
    7. Execute start.bat para iniciar o MID Server.
    8. Na instância, em Links relacionados, selecione Validar.
      O MID Server validado muda para Sim.

    Executar um Windows MID Server como um não administrador após a instalação manual

    Os MID Servers podem ser configurados para serem executados usando contas não administrativas. O uso de contas de não administrador em conjunto com a imposição de permissão de arquivo pode melhorar a segurança, restringindo o acesso aos arquivos do MID Server.

    Antes de Iniciar

    Função necessária: administrador
    Nota:
    Em uma versão futura, as contas de não administrador serão obrigatórias para o MID Server e o suporte ao uso de uma conta administrativa será descontinuado.
    Este procedimento é somente para usuários que instalam o MID Server usando o arquivo ZIP. O instalador do Windows MID Server já requer que o MID Server seja executado como um usuário não administrador. Como parte do processo de instalação do MID Server, as listas de controle de acesso à pasta MID Server são restritas aos usuários e grupos a seguir.
    • Sistema
    • Administrador
    • A conta de serviço configurada

    Ao instalar usando o arquivo ZIP, instale o MID Server em uma máquina Windows usando uma conta de administrador. Crie uma conta de usuário do Windows sem privilégios administrativos.

    Executar um MID Server com uma conta de não administrador tem limitações e muda 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.
    • Contas que não sejam de administrador não podem iniciar serviços de upgrade em versões anteriores à versão Orlando.

    Procedimento

    1. Execute o serviço do MID Server como LocalSystem ou como um usuário com direitos de administrador.
    2. Crie um arquivo chamado GrantStartStopPerm.ps1 com o código a seguir.
      Function GrantStartStopPerm
      {
          Param( [string]$username, [string]$servicename )
          $user = New-Object System.Security.Principal.NTAccount($username) 
          $sid = $user.Translate([System.Security.Principal.SecurityIdentifier]).Value 
          Write-Output "Sid : $sid"
      
          $sd = sc.exe sdshow $servicename
          Write-Output "SD value   : $sd"
                         
          if( !($sd -like "*$sid*") ){
              $permsToAdd = [string]::Format(")(A;;RPWPCR;;;{0})S:(", $sid);
              if($sd -match [regex]::Escape(")S:(")){
                  $sd = $sd -replace [regex]::Escape(")S:("),"$permsToAdd"
                  $result = sc.exe sdset $servicename $sd
                  Write-Output "SD changed : $sd";
                  Write-Output "Result : $result";
              }
          }else{
              Write-Output "Sid is already part of SD"
          }
      }
    3. Inicie o console do PowerShell como administrador.
    4. Carregue o arquivo usando a função de origem de pontos do arquivo GrantStartStopPerm.ps1.
      Por exemplo: C:\Users\mid_account\Desktop> . .\GrantStartStopPerm.ps1
    5. Execute a função originada do PowerShell com conta de não administrador e o nome do serviço como entrada.
      Por exemplo:
      GrantStartStopPerm mid_account snc_mid_test
      Output line expection in success :
      Result : [SC] SetServiceObjectSecurity SUCCESS
    6. Adicione o nome da conta de não administrador ao parâmetro do MID Server mid.windows_host.file_permissions.allow_list no arquivo config.xml do host do MID Server.
      Esta etapa adiciona a conta de não administrador à lista de permissões. Consulte Parâmetros do MID Server para obter mais informações sobre mid.windows_host.file_permissions.allow_list, bem como instruções para adicionar um parâmetro ao arquivo config.xml.
    7. Reinicie o MID Server.
      As novas regras de imposição de permissão de arquivo entram em vigor quando o MID Server é iniciado.
    8. Alterne o MID Server para a conta de serviço de não administrador.
    9. Reinicie o MID Server.

    O que Fazer Depois

    Para obter mais informações sobre como gerenciar a lista de permissões e a imposição de permissões de arquivo, consulte Imposição de permissão de arquivo para MID Servers do Windows.

    Desinstalar um Windows MID Server após a instalação manual

    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 stop.bat.
      • Console de serviços do Windows: no console de serviços do Windows, clique com o botão direito do mouse em ServiceNow nome do MID Server e então selecione parar.
    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.

    O que Fazer Depois

    Valide o MID Server para prepará-lo para uso.

    Configurar um MID Server no Windows para usar um JRE existente

    É 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 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.

    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 de propriedade wrapper do serviço Java.

    3. Salve o arquivo.