Compartilhar via


Adicionar uma ferramenta personalizada ao menu de inicialização avançada do Windows RE

Você pode adicionar uma ferramenta personalizada de solução de problemas ou diagnóstico à imagem do WinRE (Ambiente de Recuperação do Windows). Essa ferramenta é exibida no menu Inicialização avançada.

Ao desenvolver sua ferramenta personalizada para ser executada no WinRE, você pode aproveitar o suporte ao teclado virtual e ao toque disponível no WinRE.

Novo para Windows 10: você não poderá adicionar componentes opcionais do WinRE que ainda não estão nas ferramentas padrão do WinRE. Por exemplo, se você tiver um aplicativo do Windows 8 que dependa dos componentes opcionais do .NET, precisará reescrever o aplicativo para Windows 10.

Adicionar uma ferramenta personalizada

  1. Extraia e monte uma imagem do Windows (install.wim) e sua imagem WinRE correspondente (winre.wim):

    md c:\mount
    xcopy D:\sources\install.wim C:\mount 
    md C:\mount\windows
    Dism /mount-image /imagefile:C:\mount\install.wim /index:1 /mountdir:C:\mount\windows 
    md C:\mount\winre 
    Dism /mount-image /imagefile:c:\mount\windows\windows\system32\recovery\winre.wim /index:1 /mountdir:C:\mount\winre
    

    Para obter mais informações sobre essas etapas, consulte o tópico: Personalizar Windows RE.

  2. No Bloco de Notas, crie um arquivo de configuração que especifique o nome de arquivo e os parâmetros da ferramenta personalizada (se houver):

    <?xml version="1.0" encoding="utf-8"?>
    <!-- WinREConfig.xml -->
    <Recovery>
       <RecoveryTools>
          <RelativeFilePath>OEMDiagnostics.exe</RelativeFilePath>
          <CommandLineParam>/param1 /param2</CommandLineParam>
       </RecoveryTools>
    </Recovery>
    

    Em que C:\Tools\OEMDiagnostics.exe é a ferramenta personalizada de solução de problemas ou diagnóstico e onde /param1 e /param2 são parâmetros opcionais usados ao executar essa ferramenta personalizada.

    Observação

    Você só pode adicionar uma ferramenta personalizada aos menus de inicialização do WinRE Advanced.

    Salve o arquivo usando a codificação UTF-8. Não use ANSI:

    Clique em Arquivo e em Salvar como. Na caixa Codificação , selecione UTF-8 e salve esse arquivo como C:\mount\WinREConfig.xml.

  3. Crie uma \Sources\Recovery\Tools pasta na pasta de montagem do WinRE e copie a ferramenta personalizada e seu arquivo de configuração para a nova pasta:

    md C:\mount\winre\sources\recovery\tools
    copy C:\Tools\OEMDiagnostics.exe C:\mount\winre\sources\recovery\tools
    copy C:\mount\WinREConfig.xml C:\mount\winre\sources\recovery\tools
    

    A ferramenta personalizada e todas as pastas associadas devem estar nessa pasta para que ela possa continuar funcionando após futuras atualizações do WinRE.

  4. Confirme suas personalizações e desmonte a imagem do WinRE:

    Dism /unmount-image /mountdir:C:\mount\winre /commit
    
  5. Opcional: faça uma cópia de backup da imagem do WinRE.

    copy C:\mount\windows\windows\system32\recovery\winre.wim C:\mount\winre_amd64_backup.wim
    

    Muitas vezes, você pode reutilizar as mesmas personalizações em várias imagens.

  6. Desmonte e salve as alterações da imagem base do Windows:

    Dism /unmount-image /mountdir:C:\mount\windows /commit
    

Implantar a imagem

  1. No Bloco de Notas, crie um arquivo de configuração que descreva a ferramenta personalizada no menu Inicialização avançada. Adicione descrições para cada idioma ao qual você dá suporte. Este exemplo especifica as versões em inglês e francês do nome e da descrição da ferramenta:

    <?xml version="1.0" encoding="utf-8"?>
    <!-- AddDiagnosticsToolToBootMenu.xml -->
    <BootShell>
       <WinRETool locale="en-us">
             <Name>Fabrikam Utility</Name>
             <Description>Troubleshoot your Fabrikam PC</Description>
       </WinRETool>
       <WinRETool locale="fr-fr">
          <Name>Utilité de Fabrikam</Name>
          <Description>Dépannez votre PC de Fabrikam</Description>
       </WinRETool>
    </BootShell>
    

    Aviso

    Limite os <Name> valores e <Description> a aproximadamente 30 caracteres ou menos para garantir que eles apareçam corretamente no menu Inicialização avançada.

    Salve o arquivo usando a codificação UTF-8:

    Clique em Arquivo e em Salvar como. Na caixa Codificação , selecione UTF-8 e salve esse arquivo como E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml.

    Em que E:\ é a letra da unidade de uma unidade removível ou local de rede.

  2. No computador de destino, durante a implantação da imagem, mas depois de registrar a imagem de inicialização personalizada do WinRE e o sistema operacional Windows, você deve registrar a descrição da ferramenta personalizada:

    Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
    

    Se a ferramenta personalizada for registrada corretamente, a saída da execução desse comando será: <OEM Tool = 1>.

    Observação

    Para obter mais informações sobre como implantar o Windows, consulte o tópico Implantar Windows RE.

Verifique se a ferramenta personalizada aparece no menu Inicialização avançada quando iniciada do Windows

  1. Reinicie o computador de destino e conclua o OOBE como seu usuário.

    Observação

    Se for solicitada uma chave do produto (Product Key), clique em Ignorar.

  2. Clique em Iniciar>configurações do computador e selecione Geral.

  3. Na seção Inicialização avançada , selecione Reiniciar agora.

    O menu de inicialização do Windows Advanced é exibido.

  4. No menu Inicialização avançada , selecione Solucionar problemas e clique no link Utilitário da Fabrikam .

    O computador é reiniciado no WinRE e a ferramenta especificada na <seção RecoveryTools> do arquivo WinREConfig.xml é exibida.

  5. Confirme se a ferramenta personalizada funciona corretamente e feche a ferramenta.

    Se a ferramenta personalizada não aparecer no menu Inicialização avançada, você poderá tentar o seguinte:

    • Verifique se o WinREConfig.xml e os arquivos de AddDiagnosticsToolToBootMenu.xml são salvos usando o formato de codificação UTF-8.

    • Desabilite o WinRE, registre a ferramenta personalizada novamente e habilite o WinRE. Por exemplo:

      Reagentc /disable 
      Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
      Reagentc /enable
      

Verifique se a ferramenta personalizada aparece no menu de recuperação do WinRE

  1. No menu de recuperação, selecione Solucionar problemas e clique no link Utilitário da Fabrikam .

  2. Confirme se a ferramenta personalizada funciona corretamente e feche a ferramenta.

  3. Clique em Continuar.

    O computador é reinicializado no sistema operacional.

Referência técnica do Ambiente de Recuperação do Windows (Windows RE)

Personalizar o Windows RE

Implantar o Windows RE

Recursos de solução de problemas do Windows RE