Поделиться через

Аудит изображений

  • Статья

При запуске BuildWSKImgсоздается несколько файлов вместе с мигаемым образом ОС фабрики. Два из этих файлов содержат сведения о компонентах, включенных в образ ОС фабрики. Эти файлы можно использовать для аудита содержимого созданного образа. Эти файлы находятся в выходной папке образа ОС фабрики:

Файл Описание
<imagename>.DeviceDB.xml Инвентаризация всех компонентов ОС
<imageame>.BSPDB.xml Инвентаризация всех компонентов, настроенных изготовителем оборудования
<imageame>.WCOSCustomizationReport.xml Сведения о пакетах настройки в образе

Эти имена файлов будут иметь то же имя, что и образ, с помощью которых они создаются, но с разными расширениями файлов. Пример:

  • 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 файлы содержат сведения обо всех пакетах ОС (предоставляемых корпорацией Майкрософт и включенных в WSK), включенных в образ. Пакеты, добавляемые в образ, зависят от того, что указано в файле конфигурации образа (OEMInput), который используется для создания образа ОС фабрики. Сведения в DeviceDB.xml включают:

  • Функции, выбранные на изображении
  • Пакеты ОС, предоставляемые корпорацией Майкрософт и включенные в WSK, составляют данный образ. Сведения о пакетах ОС включают:
    • Идентификаторы пакетов ОС
    • Версии пакетов ОС

При использовании этого файла для аудита содержимого образа следует основывать аудит на перечисленных пакетах. Пакеты обеспечивают более детализированную, чем функции, и пакеты, стоящие за функцией, могут изменяться от выпуска к выпуску.

Пример имени файла: FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.DeviceDB.xml

Пример DeviceDB.xml

Это частичный файл DeviceDB.xml с пакетами ОС, включенными в образ.

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

Каждый пакет ОС указан в этом файле по идентификатору PackageID. В дополнение к идентификатору пакета некоторые пакеты содержат дополнительные сведения, такие как размер и версия установленного пакета:

    <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 файлы содержат сведения о настройках изготовителя оборудования, включенных в образ ОС фабрики, в том числе:

  • Пользовательские драйверы, добавленные изготовителем оборудования
    • Указано в <Packages> разделе
    • Содержит сведения об установленных драйверах, включая версию и размер.
  • Приложения Из Магазина, включенные в изображение
    • Указано в <AppxPackages> разделе
    • Включает сведения об установленных приложениях Магазина
    • Список установленных зависимостей

    Примечание

    Даже приложения, поставляемые с WSK, считаются настройками OEM и перечислены в этом файле. Это связано с тем, что заводские продукты ОС не включают приложения по умолчанию, и любое приложение, входящее в образ, было выбрано изготовителем оборудования для включения в образ.

При использовании этого файла для аудита содержимого образа следует основывать аудит на перечисленных пакетах. Пакеты обеспечивают более детализированную, чем функции, и пакеты, стоящие за функцией, могут изменяться от выпуска к выпуску.

Пример имени файла: FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.BSPDB.xml

Пример файла BSPDB.xml

В следующем фрагменте кода показано, как установленные драйверы и установленные приложения отображаются в файле BSPDB.xml. Драйверы и приложения разделены на два разных раздела: один содержит <Packages>, а другой — <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 содержит соответствующие сведения о пакетах настройки изготовителя оборудования, включенных в образ, относительно пакетов ОС Майкрософт, включенных в образ.

Отчет содержит элементы для:

  • Применимые настройки, настройки, в которых присутствует пакет ОПЕРАЦИОННОй системы, предоставляющий настройку.
  • Неприменимые настройки, настройки, в которых отсутствует пакет ОПЕРАЦИОННОй системы, предоставляющий настройку.
  • Все доступные настройки, все доступные настройки в образе. Если какие-либо неприменимые настройки будут включены в образ, отчет будет записывать в журнал предупреждение для каждого из них.

Для настроек, созданных изготовителем оборудования, значение каждой настройки отображается в журнале для всех параметров реестра (строк, цифр и т. д.), но не для параметров типа файлов.

Вы можете отключить создание этого отчета, чтобы сократить время создания образа. Чтобы отключить создание отчета, перед выполнением BuildWSKImageв среде системного комплекта Windows задайте для переменной DISABLE_CUSTOMIZATION_REPORT значение 1.

DISABLE_CUSTOMIZATION_REPORT=1

Дополнительные параметры настройки

Для файлов настройки параметров, указанных с помощью -advanced параметра , параметры не будут отображаться в разделе "Все доступные настройки" журнала. Однако они будут отображаться в разделе "Применимые настройки".

Пример 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>