Patch de uma imagem do sistema operacional de fábrica para teste
Para testes mais rápidos, você pode adicionar drivers, pacotes de personalização e testar conteúdo diretamente em imagens de teste, eliminando a necessidade de gerar novamente sua imagem sempre que quiser testar um desses tipos de pacotes.
Pré-requisitos
- Uma imagem de teste, criada usando
ReleaseType=Test
no arquivo OEMInput. - Um ou mais:
- Drivers universais do Windows, cujo tipo de arquitetura de CPU deve corresponder à imagem de teste de destino.
- Uma pasta de conteúdo de teste que contém o teste colateral
- Pacotes de personalização
Uso
ImageApp.exe [OutputFile] /Patch [/Drivers:[List_of_INF_Files]] [/Customizations:[List_of_OEM_Customization_Cab]] [/TestContent:[Folder_Containing_Test_Collateral]] [/CPUType:x]
OutputFile: o caminho para a imagem a ser modificada.
/Patch: adicionar personalizações adicionais a [OutputFile]
/CPUType:x: O tipo de arquitetura de CPU da imagem que está sendo modificada. Valores: {arm|arm64|x86|amd64}
Esse comando requer pelo menos uma destas opções:
- /Drivers:[Folder_containing_driver_files]: o caminho para um driver ou um diretório que inclui drivers. Dá suporte à adição de vários arquivos de driver e/ou diretórios, separados por ponto e vírgula. Tenta instalar conteúdo recursivamente.
- /Customizations:[Folder_containing_Customization_Cabs]: Lista separada por ponto e vírgula do arquivo cab de personalização OEM a ser adicionada a [OutputFile]
- /TestContent:[Folder_containing_test_collateral]: Lista de pastas que contêm garantias de teste assinadas para adicionar à imagem, na pasta TestContent na partição de dados do usuário
Exemplo:
ImageApp.exe image.ffu /Patch /Customizations:C:\workspace\Contoso_Customization\ /TestContent:c:\workspace\TestContent /CPUType:amd64
Observação
Não é possível executar esse comando em uma imagem que esteja em uma pasta raiz. Execute esse comando em uma imagem que esteja em uma pasta limpo que não seja uma pasta raiz.
Solução de problemas
Código de erro 0x800700ea
Se você vir o código 0x800700ea
de erro ao tentar adicionar um driver a uma imagem FFU, talvez ainda tenha alguns arquivos VHDX montados. Use o Gerenciamento de Disco em seu computador tecnico para tentar desmontar todos os VHDXs montados relacionados à imagem com a qual você está trabalhando e tente novamente.
Log de exemplo mostrando o erro 0x800700ea
:
{2/24/2020 4:56:43 PM} Imaging: FFU file '\\?\C:\FFU\ImageApp\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.ffu' loaded.
{2/24/2020 4:56:48 PM} Error: GetVolumeFromPartitionName: Waiting for DATA with store ID 0x0 failed with error code 0x800700ea.
{2/24/2020 4:56:48 PM} Error: [00:00:00] 'Failed call to GetPartitionPath for the ‘????’ partition': HRESULT_FROM_WIN32(234)
{2/24/2020 4:56:48 PM} Error: Imaging!UpdateImage: Failed to Initialize UpdateDLL::UpdateMain with error code: -2147024662 (0x800700EA)