Patchen eines Factory-Betriebssystemimages zum Testen
Für schnellere Tests können Sie Treiber, Anpassungspakete und Testinhalte direkt in Testimages hinzufügen. Dadurch müssen Sie das Image nicht jedes Mal neu generieren, wenn Sie eines dieser Arten von Paketen testen möchten.
Voraussetzungen
- Ein Testimage, das mithilfe von
ReleaseType=Test
in der Datei OEMInput erstellt wurde. - Mindestens eines der folgenden Elemente:
- Universelle Windows-Treiber, deren CPU-Architekturtyp dem Zieltestimage entsprechen muss
- Ein Ordner test content mit Material zum Testen
- Anpassungspakete
Verwendung
ImageApp.exe [OutputFile] /Patch [/Drivers:[List_of_INF_Files]] [/Customizations:[List_of_OEM_Customization_Cab]] [/TestContent:[Folder_Containing_Test_Collateral]] [/CPUType:x]
OutputFile: der Pfad zu dem zu ändernden Image.
/Patch: Hinzufügen zusätzlicher Anpassungen zu [OutputFile]
/CPUType:x: der CPU-Architekturtyp des geänderten Images. Werte: {arm|arm64|x86|amd64}
Dieser Befehl erfordert mindestens eine der folgenden Optionen:
- /Drivers: [Ordner_mit_Treiberdateien]: der Pfad zu einem Treiber oder einem Verzeichnis, das Treiber enthält. Unterstützt das Hinzufügen mehrerer Treiberdateien oder Verzeichnisse, getrennt durch Semikolons. Versucht rekursiv, Inhalte zu installieren.
- /Customizations: [Ordner_mit_CAB-Anpassungsdateien]: durch Semikolons getrennte Liste der OEM-CAB-Anpassungsdatei, die [OutputFile] hinzugefügt werden soll
- /TestContent: [Ordner_mit_Testmaterial]: Liste der Ordner mit signiertem Testmaterial, das dem Image unter dem Ordner „TestContent“ in der Benutzerdatenpartition hinzugefügt werden sollen
Beispiel:
ImageApp.exe image.ffu /Patch /Customizations:C:\workspace\Contoso_Customization\ /TestContent:c:\workspace\TestContent /CPUType:amd64
Hinweis
Sie können diesen Befehl nicht für ein Image ausführen, das sich in einem Stammordner befindet. Führen Sie diesen Befehl auf ein Image in einem anderweitig leeren Ordner aus, der kein Stammordner ist.
Problembehandlung
Fehlercode 0x800700ea
Wenn beim Hinzufügen eines Treibers zu einem FFU-Image Fehlercode 0x800700ea
angezeigt wird, sind möglicherweise noch einige VHDX-Dateien eingebunden. Verwenden Sie die Datenträgerverwaltung auf Ihrem Techniker-PC, um zu versuchen, alle eingebundenen VHDX-Objekte im Zusammenhang mit dem entsprechenden Image zu entfernen, und versuchen Sie es erneut.
Beispielprotokoll mit Fehler 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)