Compartir a través de

Auditoría de imágenes

  • Artículo

Al ejecutar BuildWSKImg, se generan varios archivos junto con la imagen del sistema operativo Factory flashable. Dos de estos archivos contienen información sobre los componentes que se incluyen en una imagen del sistema operativo Factory. Puede usar estos archivos para auditar el contenido de una imagen integrada. Estos archivos se encuentran en la carpeta de salida de la imagen del sistema operativo Factory:

Archivo Descripción
<imagename>.DeviceDB.xml Inventario de todos los componentes del sistema operativo
<imageame>.BSPDB.xml Inventario de todos los componentes personalizados por OEM
<imageame>.WCOSCustomizationReport.xml Información sobre los paquetes de personalización en una imagen

Estos nombres de archivo tendrán el mismo nombre que la imagen con la que se generan, pero con extensiones de archivo diferentes. Por ejemplo:

  • 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 archivos contienen información sobre todos los paquetes del sistema operativo (paquetes proporcionados por Microsoft e incluidos en el WSK) que se incluyen en una imagen. Los paquetes que se agregan a una imagen dependen de lo especificado en el archivo de configuración de imagen (OEMInput) que se usa para generar una imagen del sistema operativo factory. La información de DeviceDB.xml incluye:

  • Características seleccionadas en una imagen
  • Los paquetes del sistema operativo, proporcionados por Microsoft y incluidos en el WSK, que componen una imagen determinada. La información sobre los paquetes del sistema operativo incluye:
    • Identificadores de paquete del sistema operativo
    • Versiones del paquete del sistema operativo

Al usar este archivo para auditar el contenido de la imagen, base la auditoría en los paquetes enumerados. Los paquetes ofrecen más granularidad que las características y los paquetes subyacentes a una característica podrían cambiar de lanzamiento a lanzamiento.

Nombre de archivo de ejemplo: FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.DeviceDB.xml

Ejemplo de DeviceDB.xml

Se trata de un archivo de DeviceDB.xml parcial que muestra los paquetes del sistema operativo que se incluyen en la imagen.

<?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>

Cada paquete del sistema operativo aparece en este archivo por su PackageID. Además del identificador de paquete, algunos paquetes incluyen información adicional, como el tamaño instalado y la versión:

    <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 archivos contienen información sobre las personalizaciones de OEM que se incluyen en una imagen del sistema operativo Factory, entre las que se incluyen:

  • Controladores personalizados agregados por el OEM
    • Enumerado en la <Packages> sección
    • Incluye información sobre los controladores instalados, incluida la versión y el tamaño.
  • Aplicaciones de la Tienda incluidas en la imagen
    • Enumerado en la <AppxPackages> sección
    • Incluye información sobre las aplicaciones instaladas de la Tienda
    • Enumera las dependencias instaladas

    Nota

    Incluso las aplicaciones que se envían con WSK se consideran personalizaciones de OEM y se enumeran en este archivo. Esto se debe a que factory OS Products no incluye ninguna aplicación de forma predeterminada y una aplicación incluida en una imagen ha sido elegida por un OEM para su inclusión en una imagen.

Al usar este archivo para auditar el contenido de la imagen, base la auditoría en los paquetes enumerados. Los paquetes ofrecen más granularidad que las características y los paquetes subyacentes a una característica podrían cambiar de lanzamiento a lanzamiento.

Nombre de archivo de ejemplo: FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.BSPDB.xml

Archivo de BSPDB.xml de ejemplo

En el fragmento de código siguiente se muestra cómo aparecen los controladores instalados y las aplicaciones instaladas en el archivo BSPDB.xml. Los controladores y las aplicaciones se separan en dos secciones diferentes, una que contiene <Packages>y otra que contiene <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

WCOSCustomizationReport contiene información relevante sobre los paquetes de personalización de OEM incluidos en una imagen, en relación con los paquetes del sistema operativo de Microsoft que se incluyen en la imagen.

El informe tiene elementos para:

  • Personalizaciones aplicables , personalizaciones en las que el paquete del sistema operativo expone la personalización.
  • Personalizaciones inaplicables , personalizaciones en las que el paquete del sistema operativo que expone la personalización no está presente.
  • Todas las personalizaciones disponibles, todas las personalizaciones disponibles en la imagen. Si se encuentran personalizaciones inaplicables que se incluyen en la imagen, el informe registrará una advertencia para cada una.

En el caso de las personalizaciones creadas por OEM, el valor de cada personalización aparece en el registro para todas las configuraciones del Registro (cadenas, numéricas, etc.), pero no en la configuración del tipo de archivo.

Puede deshabilitar la creación de este informe para reducir el tiempo de creación de imágenes. Para deshabilitar la creación del informe, desde el entorno del kit de sistema de Windows, establezca la variable en DISABLE_CUSTOMIZATION_REPORT 1 antes de ejecutar BuildWSKImage:

DISABLE_CUSTOMIZATION_REPORT=1

Configuración avanzada de personalización

Para los archivos de personalización de configuración que se especificaron mediante el -advanced parámetro , la configuración no aparecerá en la sección "Todas las personalizaciones disponibles" del registro. Sin embargo, aparecerán en la sección "Personalizaciones aplicables".

Ejemplo 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>