Partager via

Audit d’image

  • Article

Lorsque vous exécutez BuildWSKImg, plusieurs fichiers sont générés avec l’image de système d’exploitation flashable Factory. Deux de ces fichiers contiennent des informations sur les composants inclus dans une image de système d’exploitation d’usine. Vous pouvez utiliser ces fichiers pour auditer le contenu d’une image telle qu’elle est générée. Ces fichiers se trouvent dans le dossier de sortie de votre image de système d’exploitation d’usine :

Fichier Description
<imagename>.DeviceDB.xml Inventaire de tous les composants du système d’exploitation
<imageame>.BSPDB.xml Inventaire de tous les composants personnalisés oem
<imageame>.WCOSCustomizationReport.xml Informations sur les packages de personnalisation dans une image

Ces noms de fichiers auront le même nom que l’image avec laquelle ils sont générés, mais avec des extensions de fichier différentes. Par exemple :

  • FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.DeviceDB.xml
  • FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.BSPDB.xml
  • FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.WCOSCustomizationReport.xml

DeviceDB.xml

DeviceDB.xml fichiers contiennent des informations sur tous les packages de système d’exploitation (packages fournis par Microsoft et inclus dans WSK) qui sont inclus dans une image. Les packages ajoutés à une image dépendent de ce qui est spécifié dans le fichier de configuration d’image (OEMInput) utilisé pour générer une image de système d’exploitation d’usine. Les informations contenues dans DeviceDB.xml incluent :

  • Fonctionnalités sélectionnées dans une image
  • Les packages de système d’exploitation, fournis par Microsoft et inclus dans le WSK, qui composent une image donnée. Les informations sur les packages de système d’exploitation incluent :
    • ID de package de système d’exploitation
    • Versions du package de système d’exploitation

Lorsque vous utilisez ce fichier pour auditer le contenu de l’image, basez votre audit sur les packages répertoriés. Les packages offrent plus de granularité que les fonctionnalités, et les packages derrière une fonctionnalité peuvent changer d’une mise en production à l’autre.

Exemple de nom de fichier : FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.DeviceDB.xml

Exemple de DeviceDB.xml

Il s’agit d’un fichier de DeviceDB.xml partiel qui affiche les packages de système d’exploitation inclus dans l’image.

<?xml version="1.0" encoding="utf-8"?>
<CompDB xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" CreatedDate="2019-04-15T17:00:53.0428689Z" Revision="1" SchemaVersion="1.2" Product="FactoryOS" BuildID="737b6f27-951a-1b5e-f0ae-0e9b8924999b" BuildInfo="rs_prerelease.18865.1000.190322-1503" OSVersion="10.0.18865.1000" BuildArch="AMD64" ReleaseType="Test" Type="Device" BSPBuildID="00000000-0000-0000-0000-000000000000" xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate">
<Tags Type="Device">
  <Tag Name="UpdateType" Value="Canonical" />
</Tags>
<Features>
    <Feature Type="MobileFeature" FeatureID="BASE" FMID="WCPFM" Group="Microsoft">
      <Packages>
        <Package ID="Microsoft.FactoryOS.WindowsCoreProductionFM~31bf3856ad364e35~AMD64~~" FIP="true" PackageType="FeaturePackage" />
      </Packages>
    </Feature>
    <Feature Type="MobileFeature" FeatureID="MS_WCOS_DEVICEPORTAL" FMID="WCPFM" Group="Microsoft">
      <Packages>
        <Package ID="WindowsDevicePortal-WCOS-Package~31bf3856ad364e35~AMD64~~" PackageType="FeaturePackage" />
        <Package ID="WindowsDevicePortal-WCOS-Package_en-us~31bf3856ad364e35~AMD64~en-us~" PackageType="FeaturePackage" />
        <Package ID="Microsoft.FactoryOS.MS_WCOS_DEVICEPORTAL.WCPFM.FIP~31bf3856ad364e35~amd64~~" FIP="true" PackageType="FeaturePackage" />
      </Packages>
    </Feature>

Chaque package de système d’exploitation est répertorié dans ce fichier par son PackageID. En plus de l’ID de package, certains packages incluent des informations supplémentaires, telles que la taille et la version installées :

    <Package ID="Microsoft-OneCore-SS-Boot-Package~31bf3856ad364e35~AMD64~~" Partition="mainos" PublicKeyToken="31bf3856ad364e35" InstalledSize="278039" Version="10.0.18865.1000">
      <Payload />
    </Package>

BSPDB.xml

BSPDB.xml fichiers contiennent des informations sur les personnalisations OEM incluses dans une image de système d’exploitation d’usine, notamment :

  • Pilotes personnalisés ajoutés par l’OEM
    • Répertorié dans la <Packages> section
    • Inclut des informations sur les pilotes installés, y compris la version et la taille
  • Applications du Store incluses dans l’image
    • Répertorié dans la <AppxPackages> section
    • Inclut des informations sur les applications du Windows Store installées
    • Répertorie les dépendances installées

    Notes

    Même les applications fournies avec WSK sont considérées comme des personnalisations OEM et sont répertoriées dans ce fichier. Cela est dû au fait que les produits du système d’exploitation d’usine n’incluent pas d’applications par défaut, et qu’une application incluse dans une image a été choisie par un oem pour l’inclure dans une image.

Lorsque vous utilisez ce fichier pour auditer le contenu de l’image, basez votre audit sur les packages répertoriés. Les packages offrent plus de granularité que les fonctionnalités, et les packages derrière une fonctionnalité peuvent changer d’une mise en production à l’autre.

Exemple de nom de fichier : FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.BSPDB.xml

Exemple de fichier BSPDB.xml

L’extrait de code suivant montre comment les pilotes installés et les applications installées apparaissent dans le fichier BSPDB.xml. Les pilotes et les applications sont séparés en deux sections différentes, l’une contenant <Packages>et l’autre contenant <AppxPackages>.

<?xml version="1.0" encoding="utf-8"?>
<CompDB xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" CreatedDate="2019-04-15T17:00:53.0428689Z" Revision="1" SchemaVersion="1.3" Product="FactoryOS" BuildID="737b6f27-951a-1b5e-f0ae-0e9b8924999b" BuildInfo="rs_prerelease.18865.1000.190322-1503" OSVersion="10.0.18865.1000" BuildArch="AMD64" ReleaseType="Test" Type="BSP" BSPVersion="" BSPProductName="Factory OS.BSP." xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate">
  <Tags Type="BSP">
    <Tag Name="UpdateType" Value="Canonical" />
  </Tags>
  <Features>
    <Feature Type="DriverSet" FeatureID="BASE-DRIVERSET "Group="OEM" />
  </Features>
  <Packages>
      <Package ID="Microsoft-universalblender.inf" Partition="BSP" OwnerType="OEM" InstalledSize="42703" CompressedSize="26212" Type="DriverPackage" Version="19.7.8.216">
        <Payload />
      </Package>
  </Package>
...
  <AppX>
    <AppXPackages>
      <Package OwnerType="OEM" AppXPackageType="AppXFramework" FullName="Microsoft.VCLibs.140.00_14.0.26706.0_x64__8wekyb3d8bbwe" FamilyName="Microsoft.VCLibs.140.00_8wekyb3d8bbwe">
        <Payload>
          <PayloadItem PayloadSize="848261" Path="Appx\Frameworks\Microsoft.VCLibs.x64.14.00.appx" PayloadType="Canonical" />
        </Payload>
      </Package>
...
    </AppXPackages>
  </AppX>

WCOSCustomizationReport.xml

Le rapport SUR LESCUSTOMizationReport contient des informations pertinentes sur les packages de personnalisation OEM inclus dans une image, par rapport aux packages de système d’exploitation Microsoft inclus dans l’image.

Le rapport contient des éléments pour :

  • Personnalisations applicables, personnalisations où le package de système d’exploitation exposant la personnalisation est présent.
  • Personnalisations inapplicables, personnalisations où le package de système d’exploitation exposant la personnalisation n’est pas présent.
  • Toutes les personnalisations disponibles, toutes les personnalisations disponibles dans l’image. Si des personnalisations inapplicables sont incluses dans l’image, le rapport enregistre un avertissement pour chacune d’elles.

Pour les personnalisations créées par OEM, la valeur de chaque personnalisation s’affiche dans le journal pour tous les paramètres du Registre (chaînes, numériques, etc.), mais pas pour les paramètres de type de fichier.

Vous pouvez désactiver la création de ce rapport pour réduire le temps de création de l’image. Pour désactiver la création du rapport, à partir de l’environnement du kit système Windows, définissez la DISABLE_CUSTOMIZATION_REPORT variable sur 1 avant d’exécuter BuildWSKImage:

DISABLE_CUSTOMIZATION_REPORT=1

Paramètres de personnalisation avancés

Pour les fichiers de personnalisation des paramètres qui ont été spécifiés à l’aide du -advanced paramètre , les paramètres n’apparaissent pas dans la section « Toutes les personnalisations disponibles » du journal. Toutefois, elles apparaîtront dans la section « Personnalisations applicables ».

Exemple de WCOSCustomizationReport.xml

<?xml version="1.0" encoding="utf-8"?>
<WCOSCustomizationReport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate">
  <ApplicableCustomizationsAuthored>
    <Customization FeatureArea="Cellular" Name="OEM COSA Provisioning package" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableCommandPromptPage" Value="1" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableFileTransferPage" Value="1" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableManageTasklistsPage" Value="1" />
    <Customization FeatureArea="FactoryProduct" Name="HideMouseCursor" Value="1" />
    <Customization FeatureArea="OOBE" Name="OOBE_Assets" />
    <Customization FeatureArea="TextInput" Name="InputPanelImageCustomization" />
  </ApplicableCustomizationsAuthored>
  <InapplicableCustomizationsAuthored>
    <Customization FeatureArea="DisplayEnhancement" Name="DefaultAdaptiveColorAdaptationStrength" Value="66" />
    <Customization FeatureArea="DisplayEnhancement" Name="DefaultBatterySaverBrightnessMultiplier" Value="99" />
    <Customization FeatureArea="DisplayEnhancement" Name="IsAdaptiveColorOnByDefault" Value="1" />
  </InapplicableCustomizationsAuthored>
  <AllAvailableCustomizationsInThisImage>
    <Customization FeatureArea="Cellular" Name="OEM COSA Provisioning package" />
    <Customization FeatureArea="DeviceLayout" Name="SplitLayoutFile" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableCommandPromptPage" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableFileTransferPage" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableManageTasklistsPage" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableNetworkAccess" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableUWPAppsPage" />
    <Customization FeatureArea="FactoryProduct" Name="BackgroundImagePath" />
    <Customization FeatureArea="FactoryProduct" Name="DisableSSHUser" />
    <Customization FeatureArea="FactoryProduct" Name="HideMouseCursor" />
    <Customization FeatureArea="FactoryProduct" Name="OEMVersion" />
    <Customization FeatureArea="FactoryProduct" Name="SSHPassword" />
    <Customization FeatureArea="FactoryProduct" Name="SSHUsername" />
    <Customization FeatureArea="FactoryProduct" Name="UWPLaunchOnBoot" />
    <Customization FeatureArea="OOBE" Name="OOBE_Assets" />
    <Customization FeatureArea="Start" Name="PrimaryOEMApps" />
    <Customization FeatureArea="Start" Name="SecondaryOEMApps" />
    <Customization FeatureArea="TextInput" Name="InputPanelImageCustomization" />
    <Customization FeatureArea="Theme" Name="DefaultBackgroundImage" />
    <Customization FeatureArea="Theme" Name="OEMBackgrounds" />
    <Customization FeatureArea="Theme" Name="SystemUsesLightTheme" />
  </AllAvailableCustomizationsInThisImage>
</WCOSCustomizationReport>