Gerar uma imagem do sistema operacional de fábrica

Depois de configurar um workspace para o tipo de dispositivo para o qual você planeja produzir imagens, use BuildWSKImage para criar a imagem (aproximadamente 15 a 35 minutos).

Criar a imagem

1. Inicie o Ambiente de Build do Kit de Sistema do Windows (por exemplo, E:\SetImagGenEnv.cmd) como administrador.

2. Atualize a variável de ambiente WSKWorkspaceRoot para apontar para o workspace da imagem que você deseja criar.

   %WSKWorkspaceRoot%\SetWSKWorkspaceRoot.cmd
   

   Observação

   A variável %WSKWorkspaceRoot% que você verá em todo este laboratório é definida automaticamente quando você executa prepwskworkspaceo . Se você fechar e reabrir o ambiente do Kit de Sistema do Windows, poderá definir a raiz do workspace navegando até a pasta do workspace e executando SetWSKWorkspaceRoot.cmd.

3. Compile a imagem (15 a 35 minutos). Você obterá um arquivo de disco rígido .ffu ou virtual, dependendo do workspace preparado.

   BuildWSKImage %WSKWorkspaceRoot%\FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.xml
   

   Observação

   O nome do arquivo de .xml especificado nesta etapa pode ser diferente, dependendo das opções escolhidas quando você criou o workspace. Você pode exibir o caminho completo e o nome do arquivo de OEMInput.xml executando echo %WSKOEMInputFileName no ambiente do WSK.

Por padrão, a saída é colocada no mesmo local que o workspace acrescentado com '.output', por exemplo, se o workspace estiver em C:\Workspace, a saída será em C:\Workspace.output\FactoryOS_AMD64_UEFI_VM_ValidationImage.vhdx.

Importante

Se você tentar gerar uma imagem na pasta de destino que já inclui um . Imagens FFU ou discos rígidos virtuais com o mesmo nome, a criação da imagem falhará com o seguinte erro:

imageapp : ERROR : ThreadId18164 OutputFile C:\FactoryOS.Output\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.ffu already exists.

Antes de gerar uma imagem, :

• Especifique o Overwrite parâmetro em seu BuildWSKImage comando para substituir automaticamente uma imagem na pasta de saída
• Verifique se a pasta de saída ainda não contém uma imagem gerada com o mesmo nome.

Sintaxe BuildWSKImage

BuildWSKImage [OEMInput] [Destination] [Overwrite]

Parâmetro	Descrição
OEMInput	Opcional. Caminho para o arquivo de configuração de imagem.
Destino	Opcional. Diretório de destino para a saída. Por padrão, o script cria uma pasta além da pasta WSKWorkspace, com ".output" acrescentado ao nome.
Overwrite	Opcional. Substitui o arquivo de saída. Se você não especificar esse parâmetro e um arquivo de imagem já existir na pasta de saída, a criação da imagem falhará.

Implantar sua imagem

• Para saber como implantar um disco rígido da máquina virtual, confira Implantar uma imagem de disco rígido virtual
• Para saber mais sobre as diferentes maneiras de exibir o dispositivo, confira Visão geral da implantação de imagem