Freigeben über

Image-Konfigurationsdateien (oder OEMInput)

  • Artikel

Die Image-Konfigurationsdatei (oder OEMInput) ist eine XML-Datei zum Definieren der Pakete und Anpassungen, die in das Design eines Images einfließen, einschließlich der Hardware- und Laufwerkkonfiguration, Factory OS Product, Sprachen und Informationen dazu, welche produktspezifischen Features, Apps, Treiber und Pakete enthalten sind.

Wenn Sie ein Image generieren, erstellt der Image-Generierungsprozess ein Image mithilfe von Paketen, die den in OEMInput.xml konfigurierten Werten und Attributen zugeordnet werden. Das Konfigurieren einiger OEMInput-Elemente wie Sprachen und Produkte fügt Pakete aus dem Windows System Kit (WSK) direkt und ohne zusätzliche Konfiguration Ihrem Image hinzu. Sie können auch Featuremanifeste konfigurieren und hinzufügen, die zusätzliche Paketspeicherorte definieren und zusätzliche Features, Apps, Treiber und Einstellungen aktivieren.

Zeigt an, dass einer Image-Konfigurationsdatei ein Featuremanifest hinzugefügt werden kann, um die Funktionalität zu erweitern. Nach dem Anpassen einer Image-Konfigurationsdatei wird mithilfe von Begleitmaterialien aus dem WSK und dem OEM-Arbeitsbereich ein Image erstellt.

OEMInput-Speicherort

Wenn Sie einen Arbeitsbereich vorbereiten, erhalten Sie eine initiale Image-Konfigurationsdatei im Stammverzeichnis des Arbeitsbereichs, das mit Geräteinformationen, Featuremanifesten, Features und Apps für das ausgewählte Produkt vorkonfiguriert ist. Suchen Sie nach einer Datei mit dem folgenden Benennungsschema im Arbeitsbereichsverzeichnis: <Product>_<architecture>_<boottype>_<hardware or VM>_<imagetype>.xml

Sie können den Pfad und den Dateinamen der Datei "OEMInput.xml" abrufen, indem Sie echo %WSKOEMInputFileName% aus der WSK-Umgebung ausführen.

Schemabeschreibung

Im Folgenden ist die Datei "OEMInput.xml" leer. In diesem Abschnitt werden der Zweck und die Verwendung der einzelnen Elemente beschrieben.

<OEMInput>
  <Description></Description>
  <DeviceLayoutType></DeviceLayoutType>
  <Device></Device>
  <ReleaseType></ReleaseType>
  <BuildType></BuildType>
  <Languages>
    <Language></Language>
  </Languages>
  <AdditionalFMs>
    <AdditionalFM></AdditionalFM>
  </AdditionalFMs>
  <Features>
    <Microsoft>
      <Feature></Feature>
    </Microsoft>
    <OEM>
      <Feature></Feature>
    </OEM>
  </Features>
  <AppXOptionalPackages>
    <AppXID></AppXID>
  </AppXOptionalPackages>
  <DevicePlatformIDs>
    <DevicePlatformID></DevicePlatformID>
  </DevicePlatformIDs>​
  <Product></Product>
  <TestContent></TestContent>
  <UserInstallableFeatures>​
      <Feature></Feature>​
  </UserInstallableFeatures>
</OEMInput>

Beschreibung

Image-Beschreibung und Architektur des Images. Die Architektur (AMD64, x86) muss in diesem Feld angegeben werden. Wenn die Architektur nicht in diesem Feld angegeben ist, kann es dazu führen, dass der Build fehlschlägt.

Beispiel:

<Description>Factory OS Hardware Validation image. UEFI Hardware OEMInput for AMD64</Description>

DeviceLayoutType

Definiert Datenträgerlayouteigenschaften für das Image.

Optionen Beschreibung
GPT Wird für UEFI-basierte Geräte und virtuelle Computer der Hyper-V Generation 2 verwendet.
GPT_SPACES_512 Wird für UEFI-basierte Geräte und virtuelle Computer der Hyper-V Generation 2 mit Leerzeichenlayout verwendet. Wenn Sie neue Beispieldateien mit PrepWSKWorkspace erstellen, ist dies die Standardeinstellung.
GPT_SPACES_4096 Wird für UEFI-basierte Geräte und virtuelle Computer der Hyper-V Generation 2 mit Leerzeichenlayout und 4096-Sektordatenträgern verwendet.
GPT_SPACES_SPLIT Wird bei Verwendung eines geteilten Gerätelayouts verwendet.

Beispiel:

<DeviceLayoutType>GPT_SPACES_512</DeviceLayoutType>

Sicherungsmedium

Definiert, ob das Image für UEFI-basierte Geräte dient.

Optionen Beschreibung
GenericUEFIDevice Wird für UEFI-basierte Geräte und virtuelle Computer der Hyper-V Generation 2 verwendet. Wenn Sie neue Beispieldateien mit PrepWSKWorkspace erstellen, ist dies die Standardeinstellung.

Beispiel:

<Device>GenericUEFIDevice</Device>

ReleaseType

Bestimmt, ob Test-Apps, Treiber und andere Pakete verwendet werden können.

Optionen Beschreibung
Test Verwenden Sie dies, um ein Image als Testbild zu identifizieren. Für diesen Imagetyp existieren weniger Einschränkungen bei der Imageerstellung. 
<ReleaseType>Test</ReleaseType>

BuildType

Gibt an, dass ein Produktionsbuild verwendet wird.

Optionen Beschreibung
fre Dies ist die Standardoption. Ändern Sie diesen Wert nicht.

Beispiel:

<BuildType>fre</BuildType>

Languages

Gibt an, welche Sprachen in einem Image verfügbar sind.

  • Sprachen werden in den <Language>-Elementen angegeben.
  • Die Standardsprache wird mithilfe des Default-Attributs für eine Sprache angegeben. Sie müssen eine Sprache als Standard angeben. Geben Sie nur eine Standardsprache an.

Weitere Informationen zum Hinzufügen von Sprachen finden Sie unter Hinzufügen von Sprachen.

Beispiel (en-us als Standard festgelegt):

<Languages>
    <Language Default="true">en-us</Language>
    <Language>zh-cn</Language>
</Languages>

AdditionalFMs

Listet die Featuremanifeste auf, die im Gerätedesign verwendet werden. Featuremanifeste listen die Apps, Treiber und weitere Komponenten auf, die Sie Ihrem Image hinzufügen können. Einige dieser Elemente werden beim Erstellen eines neuen Arbeitsbereichs und einer Reihe von Beispieldateien vordefiniert, z. B.:

Beispiel für vordefinierte Featuremanifeste:

<AdditionalFMs> 
    <!-- You MUST include GenericDeviceFM.xml and FOSNonProductionFM.xml! -->
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\FOSNonProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreNonProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\GenericDeviceFM.xml</AdditionalFM>
    <!-- Add OEM FMs here. -->
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM>
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM>
</AdditionalFMs>

Funktionen

Mit dem <Features>-Element können Sie ihrem Image optionale Features hinzufügen.

Beispiel:

<Features>
    <Microsoft>
        <Feature>WCOS_EVENTLOG_SERVICE</Feature>        
        <Feature>WCOS_PNP_RUNTIMEDEVICEINSTALL</Feature>
        <Feature>FONTSIZE_15</Feature>
        <Feature>DEVICEPORTAL_OPTIONAL_MONITORCONFIG</Feature>
        <Feature>SERVICING_STACK</Feature>
        <Feature>ALLOW_CONNECTEDSTANDBY</Feature>
        <Feature>MICROSOFT_EDGE</Feature>
        <Feature>OEM_IMAGE</Feature>
        <Feature>SHELL_BOOT</Feature>
        <Feature>DEVSHELL_MFG</Feature>
        <Feature>MANUFACTURING_TOOLS</Feature>
        <Feature>STATESEPARATION_ON</Feature>
        <Feature>TESTSIGNING_ON</Feature>
        <Feature>ENABLE_WOW</Feature>
        <Feature>WCOS_DEVICEPORTAL</Feature>
        <Feature>WCOS_DEVICEPORTAL_WOW</Feature>
        <Feature>WCOS_POWERSHELLCORE</Feature>
        <Feature>FACTORY_ORCHESTRATOR_SERVICE</Feature>
        <Feature>STORAGESPACES_LAYOUT</Feature>
        <Feature>KDNETUSB_ON</Feature>
    </Microsoft>
    <OEM>
        <Feature>OEMDriver</Feature>
    </OEM>
</Features>

AppXOptionalPackages

Fügen Sie die App-ID optionaler Apps hinzu, die im Image enthalten sein sollen.

Beispiel:

<AppXOptionalPackages>
    <AppXID>Microsoft.WindowsCalculator_8wekyb3d8bbwe</AppXID>
    <AppXID>Microsoft.FactoryTestFrameworkUWP_8wekyb3d8bbwe</AppXID>
</AppXOptionalPackages>

DevicePlatformIDs

DevicePlatofrmID ist eine Zeichenfolge, die aus Werten aus der SMBIOS-Systeminformationsstruktur besteht und mit allen Werten verkettet ist, die durch Punkte voneinander getrennt sind. Die Datei "OEMInput.xml" kann mehrere DevicePlaformIDs enthalten.

Wenn Sie einen Arbeitsbereich erstellen, enthält die OEMInput-Datei <DevicePlatformID>Manufacturer.Family.Product.Version</DevicePlatformID>. Aktualisieren Sie die <DevicePlatformID>-Zeichenfolge, sodass sie Ihre Hardware widerspiegelt. Weitere Informationen finden Sie unter DevicePlatformID.

Wenn die Datei "OEMInput.xml" das <DevicePlatformIDs>-Element nicht enthält, stellen Sie sicher, dass Sie es hinzufügen. Sie können für Ihr Image keinen Flash auf Ihrer Hardware ausführen, wenn dieses Element nicht in der Datei "OEMInput.xml" vorhanden ist.

Beispiel:

<DevicePlatformIDs>
    <DevicePlatformID>Manufacturer.FamilyName.ProductName.ProductVersion</DevicePlatformID>
    <DevicePlatformID>Contoso.Laptops.ContosoBook.V1</DevicePlatformID>
    <DevicePlatformID>Contoso.ContosoLaptop.*.1</DevicePlatformID>
</DevicePlatformIDs>

Produkt

Das Produkt definiert das Hauptfeaturemanifest, das in einem Image verwendet wird.

Optionen BESCHREIBUNG
Factory-Betriebssystem Wird für Factory OS verwendet.

Beispiel:

<Product>Factory OS</Product>

TestContent

Wird zum Hinzufügen eines Ordners mit Testbegleitmaterial zu Images verwendet. Weitere Informationen zum Hinzufügen von Testinhalten finden Sie unter Testinhalt.

Beispiel:

<TestContent>%WSKWorkspaceRoot%\TestContent</TestContent>

Image-Beispielkonfigurationsdatei für eine leerzeichenfähige Factory OS AMD64 UEFI VM

<?xml version="1.0" encoding="utf-8"?>
<OEMInput xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/embedded/2019/06/ImageUpdate">
  <Description>FactoryOS Test en-us image. VM2 OEMInput for VMGen2 on amd64</Description>
  <DeviceLayoutType>GPT_SPACES_512</DeviceLayoutType>
  <Device>GenericUEFIDevice</Device>
  <ReleaseType>Test</ReleaseType>
  <BuildType>fre</BuildType>
  <Languages>
    <Language Default="true">en-us</Language>
  </Languages>
  <AdditionalFMs> 
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreNonProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\MobileDeviceSpaceFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\FOSNonProductionFM.xml</AdditionalFM>
    <!-- Add OEM FMs here. -->
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM>
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM>
  </AdditionalFMs> 
  <Features>
    <Microsoft>
        <Feature>STATESEPARATION_ON</Feature>
        <Feature>STORAGESPACES_LAYOUT</Feature>
        <Feature>UEFI_VM</Feature>
        <Feature>WCOS_EVENTLOG_SERVICE</Feature>        
        <Feature>FONTSIZE_15</Feature>
        <Feature>DEVICEPORTAL_OPTIONAL_MONITORCONFIG</Feature>
        <Feature>WCOS_STORAGE_CDDVD</Feature>        
        <Feature>WCOS_POWERSHELL</Feature>
        <Feature>TESTSIGNING_ON</Feature>
        <Feature>SHELL_BOOT</Feature>
        <Feature>MANUFACTURING_TOOLS</Feature>
        <Feature>ENABLE_WOW</Feature>
        <Feature>WCOS_DEVICEPORTAL</Feature>
        <Feature>WCOS_DEVICEPORTAL_WOW</Feature>
        <Feature>FACTORY_ORCHESTRATOR_SERVICE</Feature>
        <Feature>MANUFACTURING_POWER_SCHEME</Feature>
        <Feature>MANUFACTURING_MODE_EMPTY_PROFILE</Feature>
        <Feature>RESOLUTION_1080X1920</Feature>
        <Feature>OEM_IMAGE</Feature>
        <Feature>KDNETUSB_ON</Feature>        
        <Feature>WCOS_HYPERV_GUEST_UEFI</Feature>
    </Microsoft>
  </Features>
  <AppXOptionalPackages>
    <AppXID>Microsoft.FactoryTestFrameworkUWP_8wekyb3d8bbwe</AppXID>
  </AppXOptionalPackages>
      <DevicePlatformIDs>
      <DevicePlatformID>*.*.*.**</DevicePlatformID>
    </DevicePlatformIDs>
  <Product>Factory OS</Product>
  <TestContent>%WSKWorkspaceRoot%\TestContent</TestContent>
</OEMInput>