Criando um disco de boot TeraByte WinPE contendo
Image for Windows (TBWinPE)

Este tutorial é um guia para criar a mídia de boot WinPE padrão contendo o Image for Windows. A mídia de boot é baseada no Windows ADK (Windows 8/8.1/10/11) ou no Windows AIK (Windows 7).

Observação: Este tutorial aborda o uso do script TBWinPE.cmd. Se você estiver usando o programa para Windows TBWinPE/RE Builder, clique aqui para trocar de tutorial.

Importante: O script TBWinPE.cmd está obsoleto e pode não ser atualizado em versões futuras. Recomenda-se migrar para o TBWinPE/RE Builder. Se você tiver compilações personalizadas usando o script, as alterações necessárias para migrar normalmente são mínimas.

Requisitos:

Antes de começar, revise os seguintes requisitos do projeto:

• Sistema operacional:
  • Windows 11
  • Windows 10
  • Windows 8 / 8.1
  • Windows 7

  Observação: O computador usado para criar a mídia de boot do TBWinPE pode estar executando uma versão 32 bits ou 64 bits dos sistemas operacionais compatíveis. Em qualquer uma das versões, você pode criar versões de 32 bits ou 64 bits do TBWinPE, conforme suportado pelo WinPE de origem. A partir do Windows 11 ADK versão 22H2, não há mais suporte para criar compilações de 32 bits (x86). Se você precisar criar mídia TBWinPE de 32 bits, use a origem do Windows 10 ADK versão 2004.

• Windows ADK para Windows 11 ou
  Windows ADK para Windows 10 ou
  Windows Assessment and Deployment Kit (Windows ADK) para Windows 8.1 ou
  Windows Assessment and Deployment Kit (ADK) para Windows 8 ou
  Windows Automated Installation Kit (AIK) para Windows 7
  
  

  O Windows 11 ADK cria uma compilação baseada no Windows PE para Windows 11.
  O Windows 10 ADK cria uma compilação baseada no Windows PE para Windows 10.

  O tamanho do download varia dependendo de qual versão do ADK é selecionada e de quais opções são escolhidas. O espaço mínimo estimado em disco necessário é de 3,4 GB a 5,8 GB (o espaço instalado varia aproximadamente de 1,74 GB a 3 GB). Recomenda-se uma conexão de internet de alta velocidade.

  A página de download pode ser encontrada aqui:
  https://docs.microsoft.com/en-us/windows-hardware/get-started/adk-install
  

  Execute o(s) programa(s) de instalação baixado(s) para instalar o ADK (consulte a Etapa 2B).

  Observação: A partir do Windows 10, versão 1809, o recurso Windows Preinstallation Environment (Windows PE) é um download separado (um complemento do ADK). Ambos os downloads estão disponíveis na página vinculada acima. Instale primeiro o ADK e depois os arquivos do WinPE.

  Observação: A partir do Windows 11 ADK versão 22H2, as versões de 32 bits do WIndows PE não são mais incluídas. Se você precisar criar mídia TBWinPE de 32 bits, use a origem do Windows 10 ADK versão 2004.

  O Windows 8.0 / 8.1 ADK não está mais disponível para download pela Microsoft. No entanto, se você já tiver o ADK instalado ou tiver os arquivos de instalação do ADK, ainda poderá usá-lo.

  O Windows 7 AIK cria uma compilação baseada no WinPE 3.0. Como este é um download muito grande (aprox. 1,6 GB), recomenda-se uma conexão de internet de alta velocidade. Depois de baixado, o Windows 7 AIK deve ser gravado em um DVD e então instalado (consulte a Etapa 2A).

  A página de download pode ser encontrada aqui:
  https://www.microsoft.com/en-us/download/details.aspx?id=5753

  Se for usado um caminho não relacionado à instalação para a origem do AIK/ADK, você precisará definir a variável do script para o caminho correto (consulte o Apêndice 2). Por exemplo, se você instalou o ADK, copiou as pastas/arquivos instalados para outro local e depois desinstalou o ADK.

  Observação: Se várias origens estiverem instaladas (por exemplo, o Windows 7 AIK e o Windows 8 ADK) e os caminhos de instalação padrão forem usados, o script selecionará a versão mais recente. Se desejar, uma versão mais antiga pode ser usada especificando o caminho dela no script.

• Arquivos do TBWinPE:

  Os arquivos do TBWinPE devem ser baixados e extraídos para uma pasta no sistema que você está usando para criar a compilação.
  https://www.terabyteunlimited.com/downloads/wp/tbwinpe.zip

  Observação: Os arquivos do TBWinPE/RE Builder v1.38+ são necessários para compilações que usam o Image for Windows V4. Versões anteriores não oferecem suporte ao V4.

• Image for Windows:

  O Image for Windows deve estar instalado no sistema que você está usando para criar a compilação. A versão 2.71 ou posterior é necessária se você estiver criando uma versão de 64 bits do TBWinPE. Recomenda-se usar a versão mais atual do Image for Windows.

  Observação: Se o Image for Windows não estiver instalado no local padrão, consulte o Apêndice 2 abaixo. Se você não tiver certeza do local, é muito provável que esteja no local padrão.

  Observação: Se você estiver usando a versão de avaliação do Image for Windows V3 ou V4 na compilação, é necessário executar o Image for Windows pelo menos uma vez antes de criar a compilação. Caso contrário, a versão de avaliação não será ativada na compilação.

  Opcional: Os arquivos de boot do CD do Image for Linux serão incluídos se estiverem instalados. Os programas TBIView, TBIMount, TBIHD e TeraByte OSD Tool Suite Pro (TBOSDTS) também serão incluídos na compilação se estiverem instalados. Além disso, os scripts padrão instalados do TBOSDTS e os scripts na subpasta public serão incluídos. O TBOSDTS 1.47 ou posterior é necessário para criar o arquivo de boot TBWinPE.bin.

• Espaço em disco rígido:

  O espaço necessário depende da origem da compilação (versão do WinPE) e das opções de compilação. Recomenda-se ter pelo menos 2 GB de espaço livre disponível, além do espaço exigido pela instalação do AIK/ADK. Também é necessário espaço adicional se você for criar o arquivo de boot TBWinPE.bin (aprox. 500 MB).

  A instalação do Windows 10/11 ADK requer no mínimo 1,74 GB a 3 GB de espaço livre. A instalação do Windows 8/8.1 ADK requer no mínimo 1,6 GB de espaço livre. (Os requisitos de espaço do ADK variam conforme a versão e podem ser maiores do que os informados aqui.) A instalação do Windows 7 AIK requer até 1,5 GB de espaço livre.

• Memória (RAM):

  O sistema de destino requer no mínimo 512 MB. Não é recomendado nem suportado inicializar a compilação do TBWinPE em um sistema com menos de 512 MB.

• Drivers:

  Dependendo do sistema, pode ser necessário adicionar drivers do controlador de armazenamento à compilação para ter acesso às unidades ao inicializar no TBWinPE. Exemplos de outros drivers que podem precisar ser adicionados incluem drivers USB 3.0 e drivers de NIC. Consulte o Apêndice 5, se necessário.

  Observação: Compilações baseadas em versões do Windows 8.x/10/11 ADK incluem suporte nativo a USB 3.0 (não é necessário adicionar drivers USB 3.0). Se o TBWinPE/RE Builder já tiver baixado e instalado os drivers USB 3 do Windows 7, esses drivers serão incluídos automaticamente em compilações baseadas no Windows 7.

  Observação importante para sistemas que usam unidades maiores que 2,2 TB: As versões dos drivers Intel Rapid Storage Technology (RST) incluídas no WinPE do Windows 7 e 8 (versão 8.0) não oferecem suporte adequado a unidades maiores que 2,2 TB. Como resultado, quando esse driver é usado, a unidade será informada com um tamanho incorreto (por exemplo, uma unidade de 3 TB aparecendo como 746 GB) e o sistema de arquivos na unidade pode ser corrompido. Se você estiver usando unidades grandes em um sistema que utiliza o Intel RST, recomenda-se fortemente baixar o driver atual e incluí-lo na compilação do TBWinPE. Acesse a Intel Rapid Storage Technology (RST) página, clique no link do driver na seção Downloads mais recentes e, em seguida, baixe o arquivo f6flpy-x64.zip (para Windows de 64 bits) ou f6flpy-x86.zip (para Windows de 32 bits). Observação: se você precisar usar uma versão mais antiga do driver, a versão 10.1 é necessária para AHCI e a versão 10.5 é necessária para RAID.

Etapa 1: Baixar e extrair os arquivos do TBWinPE

Baixe o arquivo ZIP do TBWinPE pelo link abaixo:
https://www.terabyteunlimited.com/downloads/wp/tbwinpe.zip

O download do TBWinPE será um arquivo ZIP contendo o script CMD do TBWinPE e arquivos de suporte.

Observação importante: Como este arquivo vem de outro computador, o Windows pode bloqueá-lo. Isso pode ou não acontecer, dependendo da versão do Windows e das configurações de segurança. Se o arquivo estiver bloqueado, ele não funcionará corretamente. Para verificar se o arquivo está bloqueado, clique com o botão direito no arquivo baixado, selecione Propriedades no menu pop-up e veja se existe um botão ou caixa de seleção Desbloquear na guia Geral. Se existir, clique no botão Desbloquear ou marque a caixa e, em seguida, clique em OK. Um exemplo de arquivo bloqueado é mostrado abaixo:

Extraia o conteúdo deste arquivo para a pasta a partir da qual você deseja executar o TBWinPE. Recomenda-se criar uma nova pasta na raiz de uma unidade (C:\TBWinPE, D:\TBWinPE etc.) e extrair os arquivos ali.

Um exemplo dos arquivos extraídos para a pasta C:\TBWinPE é mostrado abaixo:

Se desejar, você pode deixar esta janela do Explorer aberta para uso na Etapa 3.

Etapa 2: Instalar o Windows 7 AIK ou o Windows 8/8.1/10/11 ADK

Consulte a Etapa 2A se estiver instalando o Windows 7 AIK.

Consulte a Etapa 2B se estiver instalando o Windows 8/8.1/10/11 ADK.

Observação: Se você usar um caminho de instalação personalizado, anote-o e consulte o Apêndice 2 ao finalizar.

Etapa 2A: Instalar o Windows 7 AIK

O Windows 7 AIK cria uma compilação baseada no WinPE 3.0. Como este é um download grande (aprox. 1,6 GB), recomenda-se uma conexão de internet de alta velocidade. Depois de baixado, o Windows 7 AIK deve ser gravado em um DVD e então instalado.

A página de download pode ser encontrada aqui:
https://www.microsoft.com/en-us/download/details.aspx?id=5753

O download do Windows 7 AIK pela Microsoft será um arquivo ISO, com aproximadamente 1,6 GB. Depois de baixado, grave o arquivo ISO em um DVD com um utilitário como o BurnCDCC. Esse utilitário está incluído no IFW e também pode ser baixado da TeraByte Unlimited pelo link abaixo:
https://www.terabyteunlimited.com/downloads-free-software.htm

Para iniciar a instalação, insira o DVD e aguarde a tela de boas-vindas do Windows 7 AIK aparecer. Se o DVD não iniciar automaticamente ao ser inserido, você pode abrir a unidade de DVD em uma janela do Explorer e então clicar duas vezes em startcd.exe.

Selecione Windows AIK Setup no menu da tela de boas-vindas. Após alguma inicialização e a tela do contrato de licença, a seguinte caixa de diálogo será exibida:

Os padrões mostrados acima funcionam bem e recomenda-se mantê-los. Se você não tiver certeza se há espaço livre suficiente na unidade de instalação, verifique o espaço em disco necessário antes de prosseguir usando o botão Disk Cost. Quando estiver pronto, clique em Next para iniciar a instalação. Ao concluir, a seguinte tela será exibida:

Observação: O Windows AIK requer que o .NET Framework e o MSXML 6.0 estejam instalados. Se eles ainda não estiverem instalados no sistema, o Windows AIK Setup detectará isso e solicitará que você instale um ou ambos primeiro. Ambos estão disponíveis para instalação no mesmo DVD e aparecem no menu da tela de boas-vindas como .NET Framework Setup e MSXML 6.0 [SP1] Setup. O Windows XP (em particular) normalmente exigirá a instalação desses programas.

Etapa 2B: Instalar o Windows 8/8.1/10/11 ADK

A menos que você tenha uma necessidade específica de usar um ADK mais antigo, recomenda-se usar a versão atual do Windows 10 ADK. O tamanho do download varia dependendo de quais opções são selecionadas. O espaço mínimo estimado em disco necessário varia de 3,0 GB a 5,8 GB (o tamanho real do download geralmente é menor, com um espaço instalado de 1,6 GB a 3,0 GB). Recomenda-se uma conexão de internet de alta velocidade.

Para iniciar a instalação, execute o programa de instalação do ADK baixado (adksetup.exe). Para o Windows 11 ADK e o Windows 10 ADK (versão 1809 ou posterior), você também baixará e executará o instalador do complemento do Windows PE (adkwinpesetup.exe).

Você pode optar por fazer com que o instalador baixe os itens selecionados ou pode baixar o ADK para instalação em um computador separado. Neste tutorial, será usada a opção Instalar.

Selecione a opção Install the Assessment and Deployment Kit to this computer e clique em Next .

Observação: Usar o caminho de instalação padrão permitirá que o script encontre a instalação automaticamente. Se você usar um caminho personalizado, consulte o Apêndice 2.

Na próxima tela, selecione se deseja ou não participar do CEIP e/ou enviar dados de uso anônimos para a Microsoft e clique em Next. Na tela License Agreement , clique em Accept.

A tela a seguir exibirá os recursos do ADK disponíveis para instalação. Para manter o download no mínimo, recomenda-se limitar a seleção aos recursos Deployment Tools e Windows Preinstallation Environment (Windows PE) (se o recurso Microsoft .NET Framework 4.0/4.5 estiver disponível, ele também deve ser selecionado). Se você estiver instalando o Windows 11 ADK ou o Windows 10 ADK (versão 1809 ou posterior), você terá o recurso Deployment Tools disponível no instalador do ADK e o recurso Windows Preinstallation Environment (Windows PE) no instalador do complemento do Windows PE.

Selecionando Deployment Tools no instalador do Windows 10 ADK (versão 1809):

Selecionando Windows Preinstallation Environment (Windows PE) no instalador do complemento do Windows PE do Windows 10 ADK (versão 1809):

Clique no botão Install. Se você receber um prompt do UAC, clique em Continue ou Yes para permitir que o programa seja executado.

Aguarde a conclusão da instalação. Isso pode levar um tempo considerável, dependendo da velocidade da conexão com a internet.

Etapa 3: Editar o arquivo imagew.ini

Observação importante: Ignore esta etapa se você estiver incluindo o Image for Windows V3 ou V4 na compilação (o imagew.ini não é usado nas versões 3.x/4.x).

O Image for Windows requer uma chave de produto válida para funcionar no modo de uso completo. Essas informações são armazenadas no arquivo imagew.ini, que o Image for Windows lê quando é executado.

Esta etapa é opcional, pois o script solicitará que você edite o arquivo se ele não parecer conter uma chave válida. Se nenhuma chave for fornecida, o Image for Windows será executado no modo de avaliação. Se você estiver criando a compilação usando a versão de avaliação do Image for Windows, pode ignorar esta etapa e selecionar a opção 1, Use existing imagew.ini file and continue, quando solicitado.

Observação: Se você já tiver um arquivo imagew.ini válido de uma compilação anterior do TBWinPE/RE, BartPE, VistaPE ou Win7RescuePE, você pode copiar esse arquivo para esta pasta e ignorar esta etapa.

Usando o Windows Explorer, navegue até a pasta com os arquivos do TBWinPE extraídos ou selecione a janela do Explorer já aberta na Etapa 1.

Clique duas vezes no arquivo imagew.ini nesta pasta (ou clique com o botão direito nele e selecione Open no menu pop-up). O arquivo será aberto no Bloco de Notas.

Após Key=, digite o Name e a Key que você recebeu com o Image for Windows. Um exemplo é mostrado acima e também no arquivo.

Ao finalizar, salve o arquivo e feche o Bloco de Notas.

Etapa 4: Executar o TBWinPE

O script do TBWinPE precisa ser executado como administrador. Clique com o botão direito no arquivo TBWinPE.cmd e selecione Run as administrator no menu pop-up. Se o UAC estiver habilitado (padrão), clique em Continue ou Yes no prompt do UAC para permitir que o TBWinPE.cmd seja executado.

Uma janela do Prompt de Comando será aberta e o script começará a ser executado.

As seguintes opções estão disponíveis:

Build 32-bit (x86) TBWinPE: Selecione esta opção para criar a versão de 32 bits (x86) do TBWinPE. Se você for adicionar drivers ou outros programas, eles precisarão ser as versões de 32 bits. Observação: Você não conseguirá criar uma compilação de 32 bits se estiver usando o Windows 11 22H2 ADK ou posterior como origem (o suporte a 32 bits não é mais incluído).

Build 64-bit (AMD64) TBWinPE: Selecione esta opção para criar a versão de 64 bits (AMD86) do TBWinPE. Se você for adicionar drivers ou outros programas, eles precisarão ser as versões de 64 bits. Esta compilação requer o Image for Windows 2.71 ou posterior.

Alternar criação de arquivo de boot: Selecione para ativar/desativar a criação do arquivo de boot TBWinPE.bin para uso com o programa BOOTFILE da TeraByte (oferece suporte para inicializar diretamente no arquivo a partir do Windows). Quando ativado, as opções de compilação criarão o arquivo de boot em vez da mídia de boot padrão.

Listar códigos de fuso horário: Selecione para ver uma lista de códigos de fuso horário válidos. Definir o fuso horário é opcional. Se não for definido, o padrão será o fuso horário usado pela versão do Windows AIK/ADK que você baixou.

Listar pacotes de idiomas disponíveis: O pacote de idiomas usado por padrão depende da versão do Windows AIK/ADK baixada. Você pode usar esta opção para ver uma lista de pacotes de idiomas válidos que podem ser instalados. Instalar um pacote de idiomas é opcional.

Gerenciar configurações salvas: Selecione para abrir um menu para gerenciar as configurações salvas. Se as configurações salvas serão ou não usadas (se encontradas) é mostrado no menu. Salvar as configurações atuais da compilação é útil quando você usa configurações personalizadas e/ou caminhos de instalação personalizados, pois elas serão mantidas quando os arquivos do script forem atualizados. Você pode selecionar entre as seguintes opções:

Salvar configurações atuais da compilação: Salva as configurações atuais da compilação.

Excluir configurações salvas: Exclui as configurações salvas e desativa o uso de configurações salvas. Observação: Esta opção só está disponível se existirem configurações salvas.

Alternar uso de configurações salvas para a compilação: Alterna entre usar ou não usar as configurações salvas para a compilação. Essa configuração é salva e o estado atual é mostrado no menu. Se as configurações salvas não forem usadas, serão usadas as configurações normais da compilação. Observação: Esta opção só está disponível se existirem configurações salvas.

Selecione a opção de compilação desejada e o script continuará. O script exibirá uma mensagem de erro se encontrar um problema (consulte o Apêndice 1, abaixo). Se o arquivo imagew.ini não parecer conter uma chave válida, você será solicitado a editá-lo, continuar ou abortar.

O processo pode levar vários minutos, dependendo da velocidade do computador.

Ao finalizar, o script fará uma pausa e aguardará que uma tecla seja pressionada antes de iniciar o utilitário MakeDisk da TeraByte para criar a mídia inicializável do TBWinPE.

Observação: Se você tiver uma mídia de boot TBWinPE/RE existente que deseja atualizar, mas não quer que a mídia seja reformatada pelo MakeDisk (os arquivos existentes seriam perdidos), consulte o seguinte artigo da KB: Manually Updating the TBWinPE/RE Boot Media

Clique em Next para iniciar o processo e então selecione o tipo de mídia inicializável que você deseja criar. No exemplo abaixo, uma unidade flash USB é selecionada.

Importante: Ao criar uma unidade flash USB (UFD) inicializável do TBWinPE, recomenda-se usar uma opção de layout USB do tipo Partition (por exemplo, Partition - MBR FAT/FAT32 Partition). Usar o modo No Partition pode não permitir que a unidade inicialize corretamente. Se você tiver problemas para inicializar a UFD, consulte este artigo da KB: Using a UFD (USB Flash Drive) as installation/boot media for TeraByte Unlimited products.

Clique em Finish para criar a mídia inicializável. Se você quiser criar outra mídia de boot (por exemplo, você criou um CD e também quer uma UFD), pode executar o MakeDisk a partir da pasta do TBWinPE (não é necessário recriar a compilação, a menos que você tenha atualizado os programas TeraByte instalados ou os arquivos de script do TBWinPE).

Etapa 5: Usar o TBWinPE

Inicializar no TBWinPE normalmente levará vários minutos, dependendo do sistema.

A área de trabalho do TBWinPE será semelhante à captura de tela abaixo. Observe que este tipo de compilação é um WinPE relativamente simples e não inclui barra de tarefas nem shell no estilo do Windows. O TBLauncher pode ser usado para executar facilmente os programas incluídos ou para desligar ou reiniciar o sistema.

Para sair do TBWinPE, remova a mídia de boot do TBWinPE e clique no botão Shut down ou Restart no TBLauncher.

Observação: Alguns sistemas que usam o TBWinPE criado a partir do Windows 8 ADK podem apresentar um atraso ao desligar ou reiniciar. Se isso acontecer, você pode manter a tecla Shift pressionada ao clicar no botão para forçar a ação.

Os programas da TeraByte incluídos na compilação também podem ser executados a partir de uma janela do Prompt de Comando digitando o nome do programa e pressionando ENTER: imagew, tbiview, tbimount, tbosdtw, tbihd

---

Apêndice 1 - Erros e avisos

O script do TBWinPE exibirá uma mensagem de erro e abortará nos seguintes problemas:

• Foi encontrada uma versão incorreta do tbutil.
• O script é executado sem privilégios de administrador.
• O Windows AIK/ADK, DISM.EXE ou WINPE.WIM não foi encontrado.
• O Image for Windows não foi encontrado.
• O TBOSDTS 1.47 ou posterior não foi encontrado (somente ao criar arquivo de boot).
• O arquivo INI de licença aplicável não existe e o script não consegue criá-lo.
• O DISM não consegue montar, salvar ou desmontar a imagem do WinPE.

Além disso, será exibida uma mensagem de erro se a pasta Drivers existir, mas não contiver drivers, ou se houver um problema ao adicionar um driver. A compilação não fará pausa nem abortará nesses erros.

Uma mensagem de aviso será exibida para os seguintes problemas:

• A licença aplicável não parece ser válida. Você poderá corrigir o problema e continuar.
• A pasta mount está em uso.
• Houve um erro ao configurar o WinPE.

Apêndice 2 - Usar caminhos personalizados de programas

Por padrão, o script do TBWinPE (TBWinPE.cmd) espera que os programas da TeraByte e o Windows AIK/ADK estejam instalados em seus locais padrão. Se algum desses programas não estiver instalado em seus locais padrão, você precisará editar a(s) variável(is) de caminho apropriada(s) e definir o caminho correto.

Observação: Use um editor de texto simples (por exemplo, Bloco de Notas) para editar o arquivo TBWinPE.cmd.

ifwpath - caminho do Image for Windows
tbiviewpath - caminho do TBIView e TBIMount
tbosdtpath - caminho do TeraByte OSD Tool Suite Pro
sourcepath - caminho de instalação do Windows AIK/ADK

Observação: Os programas TBIView, TBIMount e TeraByte OSD Tool Suite Pro são opcionais. O script os incluirá se forem encontrados.

Por exemplo, se você instalou o Windows 10 ADK em D:\Win10ADK, você especificaria o seguinte para sourcepath:
set sourcepath=D:\Win10ADK

Importante: Se os arquivos de origem estiverem instalados, a variável sourcepath deve ser definida como o caminho de instalação da origem (o mesmo caminho usado como destino de instalação na Etapa 2A/2B). Se os arquivos de origem não estiverem instalados, a variável deve ser definida como o local dos arquivos de origem, selecionando a pasta que teria sido especificada caso tivesse sido instalada naquele local.

Importante: Não inclua uma barra invertida final nos caminhos. Não inclua espaços antes ou depois do sinal de igual.

Apêndice 3 - Opções avançadas

Opções do script

Várias opções podem ser definidas no script do TBWinPE (TBWinPE.cmd). Essas opções ficam perto do início do arquivo (logo após a seção de caminhos personalizados, mostrada no Apêndice 2).

Observação: Use um editor de texto simples (por exemplo, Bloco de Notas) para editar o arquivo TBWinPE.cmd.

screenresolution - Use esta opção para alterar a resolução de tela usada pelo WinPE. A resolução padrão é 1024x768 (-m3). Para opções de resolução, consulte o Apêndice 4, abaixo.
Exemplo: set screenresolution=-m5

pausebuild - Esta opção pausará o script após as modificações da TeraByte terem sido concluídas, mas antes de o arquivo WIM ser desmontado. Isso permite que o usuário navegue pela subpasta mount para verificar o conteúdo ou adicionar conteúdo à compilação. Defina como 1 para ativar.
Exemplo: set pausebuild=1

usestartnetcmd - Use esta opção para fazer com que a compilação use o arquivo startnet.cmd para controlar a inicialização de programas em vez do padrão (winpeshl.ini). A janela do Prompt de Comando será o shell em vez do TBLauncher. Defina como 1 para ativar.
Exemplo: set usestartnetcmd=1

bootprompt - Esta opção fará com que o CD do TBWinPE solicite que o usuário pressione uma tecla antes de inicializar (assim como o CD/DVD do instalador do Windows). Se nenhuma tecla for pressionada em alguns segundos, o computador inicializará normalmente a partir do disco rígido. Defina como 1 para ativar.
Exemplo: set bootprompt=1

timezone - Use esta opção para definir o fuso horário. Para ver uma lista de fusos horários válidos, execute o script do TBWinPE e selecione a opção 3 no menu.
Exemplo (para definir Eastern Time): set timezone=16

languagepack - Use esta opção para instalar um pacote de idiomas. Para ver uma lista de pacotes de idiomas válidos, execute o script do TBWinPE e selecione a opção 4 no menu. O pacote de idiomas selecionado será instalado e definido como padrão.
Exemplo: set languagepack=FR-FR

inputlocale - Use esta opção para definir o locale de entrada para um valor alternativo. O locale selecionado deve ser suportado pelo pacote de idiomas atual em uso.
Exemplo: set inputlocale=fr-CH

screendpi - Use esta opção para definir o valor de DPI da tela. Isso pode ser útil ao usar monitores FHD/QHD/QFHD que não são detectados corretamente automaticamente. O DPI padrão será usado se a opção não for definida ou se o valor especificado for inválido. Defina como 0 (zero) ou deixe em branco para usar o padrão. Os valores válidos são: 0, 96, 120, 144, 168, 192, 240, 288
Exemplo: set screendpi=144

Scripts personalizados de inicialização, execução e compilação

Esses scripts podem ser usados na compilação para facilitar o tratamento de tarefas personalizadas de compilação, inicialização e automação. O InitScript e o RunScript são executados a partir do TBLauncher na inicialização e fornecem uma alternativa ao uso do script startnet.cmd. Observação: Compilações personalizadas usando startnet.cmd que não executam o TBLauncher ainda podem usar esses scripts chamando-os diretamente a partir do startnet.cmd.

Para usar esses scripts, coloque o(s) arquivo(s) de script desejado(s) na pasta TBWinRE antes de criar a compilação. Os arquivos InitScript e RunScript serão copiados para a pasta \Windows\System32 da compilação (X:\Windows\System32 quando inicializado).

InitScript.cmd - Este script será executado antes de o TBLauncher ser exibido e imediatamente antes do programa configurado para iniciar automaticamente (por exemplo, Image for Windows). Observação: Se este script não puder ser executado até depois que a inicialização padrão do WinPE tiver sido concluída, certifique-se de desativar a opção BackgroundInit do TBLauncher.

RunScript.cmd - Este script será executado na inicialização (imediatamente após o InitScript.cmd, se usado) e substituirá o programa configurado para iniciar automaticamente (por exemplo, Image for Windows). Observação: Compilações personalizadas usando autorun.cmd precisarão chamá-lo diretamente a partir do RunScript.cmd para usá-lo, pois ele não será executado automaticamente (por exemplo, call %TBDrive%\TBData\autorun.cmd).

BuildScript.cmd - Este script será executado durante o processo de compilação, permitindo que operações personalizadas de compilação sejam automatizadas.

Apêndice 4 - Alterar a resolução de tela

A resolução de tela padrão do WinPE do Windows 7 é 800x600. Essa resolução não é alta o suficiente para exibir toda a janela do Image for Windows. O programa ChgRes.exe é usado para alterar a resolução para 1024x768 após o WinPE inicializar (antes de o Image for Windows ser executado).

Uma resolução diferente pode ser selecionada no TBWinPE executando o programa ChgRes e especificando as opções necessárias. Executar o ChgRes sem nenhuma opção exibirá informações de uso.

Também é possível definir a resolução padrão para um modo diferente usando o Bloco de Notas para editar a variável screenresolution no TBWinPE.cmd (ou a linha chgres no startnet.cmd, se a opção usestartnetcmd estiver ativada no TBWinPE.cmd), substituindo as opções do ChgRes pelas novas e então recriando a compilação executando o script do TBWinPE. Aviso: Não é recomendado fazer quaisquer outras alterações no arquivo startnet.cmd, a menos que você esteja familiarizado com o processo de criação do WinPE.

Tenha em mente que as resoluções suportadas ao inicializar no WinPE diferem das do Windows. Alguns sistemas podem suportar apenas um número muito limitado de resoluções. Antes de especificar uma resolução alternativa, você deve verificar se a resolução que deseja usar é válida no WinPE testando-a com o ChgRes enquanto estiver inicializado no TBWinPE.

Apêndice 5 - Adicionar drivers do Windows

Drivers do Windows podem ser adicionados à compilação colocando-os na pasta Drivers. Essa pasta deve estar localizada na pasta da compilação (C:\TBWinPE neste exemplo): C:\TBWinPE\Drivers

A pasta Drivers será pesquisada em busca de drivers quando a compilação estiver sendo criada. Colocar os arquivos de cada driver adicionado em sua própria pasta geralmente é o método mais simples. Por exemplo, se você estiver criando a compilação TBWinPE de 64 bits usando o Windows 7 AIK e precisar adicionar drivers USB 3.0 de 64 bits, você pode colocar os arquivos do driver em C:\TBWinPE\Drivers\usb3x64 (como mostrado abaixo):

Os drivers devem ser do tipo INF (.inf) e todos os arquivos de suporte (.cat, .pnf, .sys, .oem, .dll etc.) devem ser incluídos. Todos os arquivos relacionados ao driver e subpastas devem estar na mesma pasta do arquivo .inf. Na maioria dos casos, os arquivos do driver são empacotados juntos em uma pasta e você pode simplesmente copiar essa pasta para a pasta Drivers (isso copiará todos os arquivos e quaisquer subpastas).

Instaladores do Windows (por exemplo, arquivos .msi) ou outros tipos de pacotes de driver (como arquivos .exe) não são suportados. Além disso, arquivos INF que não sejam pacotes de driver válidos serão ignorados.

Os drivers usados devem ser versões de 32 bits (x86) para compilações de 32 bits (x86) e versões de 64 bits (AMD64) para compilações de 64 bits. Use drivers do Windows 7 para compilações baseadas no Windows 7 AIK, use drivers do Windows 8 para compilações baseadas no Windows 8 ADK, use drivers do Windows 10 para compilações baseadas no Windows 10 ADK etc.

Apêndice 6 - As pastas de compilação “ISO” e “mount”

A pasta ISO contém os arquivos usados para criar a compilação (versões do script anteriores à 1.3 usavam winpe para compilações de 32 bits e winpe64 para compilações de 64 bits). Quando a compilação tiver sido concluída e a mídia de boot tiver sido criada, a pasta de compilação pode ser excluída para recuperar espaço (aproximadamente 135–300 MB, dependendo da compilação). Se for excluída, a pasta será recriada quando o script for executado novamente. A pasta de compilação não é excluída automaticamente pelo script, pois pode ser útil para usuários avançados.

A pasta mount é usada para montar o arquivo boot.wim do WinPE que está sendo modificado.

Apêndice 7 - Personalizar o TBLauncher

O arquivo TBLauncher.ini pode ser editado para modificar as opções de inicialização e os itens de menu. As seguintes opções estão disponíveis:

Mode - Esta opção controla qual programa é iniciado automaticamente quando o TBLauncher é executado. Os modos válidos são:

• WinRE - O programa Opções de Recuperação do Sistema é executado, se for encontrado. Caso contrário, o IFW é executado.
  Nota: Embora esta configuração seja válida, ela será ignorada, pois o WinPE não inclui o programa de recuperação. O modo WinPE será utilizado.
• WinPE - O IFW é executado.
• IFW - O IFW é executado utilizando os parâmetros especificados na opção IFWModeParameters.

Exemplo: Mode=WinPE

RunWpeinit - O TBLauncher executa o programa de inicialização do WinPE (wpeinit) na inicialização (0 = desativado, 1 = ativado). Quando desativado, você pode executá-lo manualmente a partir do menu Arquivo do TBLauncher, se necessário. Desativar esta opção pode acelerar a inicialização do TBWinPE.

Exemplo: RunWpeinit=0

RunNetworkInit - O TBLauncher executa a inicialização da rede na inicialização (0 = desativado, 1 = ativado). Quando desativado, você pode executá-lo manualmente a partir do menu Arquivo do TBLauncher, se necessário. Isso precisa ser executado se o acesso à rede for necessário. Desativar esta opção pode acelerar a inicialização do TBWinPE.

Exemplo: RunNetworkInit=1

DisableFirewall - Desativa o firewall do Windows (0 = firewall ativado, 1 = firewall desativado). Isso é necessário para usar multicasting com o Image for Windows.

Exemplo: DisableFirewall=1

BackgroundInit - Esta opção fará com que o TBLauncher execute os programas de inicialização em segundo plano, em vez de esperar que terminem antes de executar o IFW ou o programa Opções de Recuperação do Sistema (0 = desativado, 1 = ativado). Dependendo do sistema, ainda pode haver um atraso antes que o IFW ou o programa Opções de Recuperação do Sistema seja executado. Por exemplo, se você configurou o IFW para ser executado automaticamente e ele exigir acesso à rede, você deve desativar esta opção para que a rede esteja disponível quando o IFW for executado.

Exemplo: BackgroundInit=1

IFWModeParameters - Use esta opção para especificar as opções de linha de comando para o IFW ao usar o modo IFW. Isso é útil se você deseja configurar a compilação do TBWinPE para executar o IFW automaticamente e realizar uma tarefa específica (por exemplo, criar um backup ou restaurar uma imagem).

Exemplo: IFWModeParameters=/b /v /d:w0 /f:"e:\backups\win7.tbi" /desc:"Windows 7 Drive"

FindBootDrive - Procura pela unidade de mídia de inicialização do TBWinPE após a inicialização (0 = desativado, 1 = ativado). Se ativado, o TBLauncher procurará pela mídia de inicialização. Se encontrada, o seguinte se aplica:

• A variável de ambiente %TBDrive% será definida com a letra da unidade da mídia de inicialização e poderá ser usada em scripts personalizados ou itens de menu.

• Se o arquivo \TBData\TBLauncher.ini existir na unidade, ele será usado em vez do arquivo INI integrado. Observe que as opções de inicialização no arquivo de substituição não serão usadas, pois a inicialização já ocorreu. No entanto, a opção Mode e os itens de menu serão utilizados.

• Se o arquivo \TBData\autorun.cmd existir na unidade, ele será executado, substituindo a configuração de Mode. Isso permite a configuração e o uso fácil de um script de execução automática sem a necessidade de recriar a compilação. Importante: Deve-se ter cuidado ao usar um script de execução automática. Dependendo do script, executá-lo no sistema errado ou quando não for aplicável pode ter consequências indesejáveis.

Recomenda-se ter apenas uma mídia de inicialização TBWinPE conectada ao sistema (aquela que está sendo inicializada) ao usar esta opção, pois a busca para quando a primeira correspondência é encontrada. O uso desta opção geralmente retarda a inicialização do TBLauncher em 6 a 10 segundos devido ao tempo exigido pelo WinPE para inicializar os dispositivos conectados.

A unidade de inicialização não poderá ser encontrada ao inicializar pelo arquivo de boot TBWinPE.bin. Isso ocorre porque ela deixa de existir como uma unidade no momento em que a busca ocorre. No entanto, se outra mídia de inicialização TBWinPE estiver conectada, ela será encontrada. Por exemplo, se você inicializar pelo arquivo de boot e tiver seu UFD TBWinPE personalizado conectado, ele será encontrado e o TBLauncher.ini e o autorun.cmd contidos nele serão usados.

Exemplo: FindBootDrive=1

MaxSearchTime - Especifica o número máximo de segundos (até 20) para procurar a unidade de inicialização. Aplica-se apenas quando o FindBootDrive está ativado. O padrão é 8 segundos. Se o tempo de busca não for longo o suficiente, a unidade pode não ser encontrada ou ser encontrada apenas esporadicamente.

Exemplo: MaxSearchTime=10

UpdatePrograms - Procura por versões atualizadas dos programas da TeraByte (0=desativado, 1=atualização automática, 2=perguntar ao usuário). Após a inicialização, se a opção não estiver desativada, o TBLauncher procurará nos caminhos de compilação especificados e nos caminhos de instalação padrão pelos programas da TeraByte (IFW, TBIView, TBIMount, TBOSDT). Se uma versão mais recente for encontrada, ela será usada em vez da versão incluída na compilação (o usuário será questionado primeiro se a opção 2 for especificada). Importante: Recomenda-se atualizar a mídia de inicialização sempre que você atualizar o Image for Windows. Se você depender desta opção e a unidade que contém as versões atualizadas não estiver acessível (por exemplo, em branco, corrompida, etc.), a busca falhará e você poderá não conseguir acessar seus backups usando a versão mais antiga incluída na compilação. Nota: Esta busca pode ser realizada manualmente a partir do menu Ferramentas do TBLauncher.

Exemplo: UpdatePrograms=2

ClosedTransparency - Permite que a janela do TBLauncher fique transparente quando fechada (inativa). Isso pode ser útil em telas menores, onde a saída de outros programas normalmente seria ocultada pelo TBLauncher. Os valores válidos são de 0 a 4, sendo 0 opaco (padrão) e de 1 a 4 aumentando a transparência.

Exemplo: ClosedTransparency=3

Log - Cria um arquivo de log (0=desativado, 1=ativado). O arquivo de log não é criado se o TBLauncher for executado no Windows normal.

Exemplo: Log=1

AlwaysOnTop - Mantém a janela do TBLauncher sobre as outras janelas (0=desativado, 1=ativado). Recomenda-se ativar esta opção.

Exemplo: AlwaysOnTop=1

AccessibilityOpts - Controla as seguintes opções de acessibilidade:
0 - Nenhum programa de acessibilidade é executado na inicialização
1 - Executar o Narrador
2 - Executar o OSK (Teclado Virtual)
3 - Executar tanto o Narrador quanto o OSK
Nota: O Narrador é suportado apenas no TBWinRE baseado no Windows 10 1703 ou posterior.

Exemplo: AccessibilityOpts=1

Itens de Menu Personalizados
Entradas de menu podem ser adicionadas editando a variável ItemCount (na seção [Menu]) e adicionando uma seção para o novo item (por exemplo, [Menu_Item_10]). Especifique o Name, Path, WorkingDir (se aplicável), Parameters (se aplicável) e o valor do índice do Icon (geralmente 0). As strings de ambiente serão expandidas (por exemplo, %ProgramFiles%). Observe que X: é a letra da unidade atribuída à unidade de RAM do WinPE inicializada (caso precise codificá-la rigidamente).

Se a opção FindBootDrive for utilizada, você também poderá usar a variável de ambiente %TBDrive% nos caminhos dos itens de menu para especificar a mídia de inicialização. Isso permite adicionar aplicativos portáteis à unidade quando a letra é desconhecida até a inicialização.

Para exemplos, consulte os itens de menu existentes no arquivo. Também há exemplos no artigo da KB Adding Programs to TBWinPE/RE Builds.

Apêndice 8 - Inicializando Diretamente o Arquivo WIM do TBWinPE/RE no Windows 7 ou Posterior

O TBWinPE/RE Builder pode configurar o Windows para inicializar diretamente o arquivo WIM a partir de uma compilação padrão do TBWinPE ou TBWinRE ao usar o Windows 7 ou posterior. Isso permite a inicialização no ambiente TBWinPE/RE com um simples reinício do Windows, sem a necessidade de mídia de inicialização.

Consulte o tutorial do TBWinPE/RE Builder TBWinPE (Apêndice 4) para obter detalhes.