影像稽核

發行項
06/19/2023

當您執行 BuildWSKImg 時，會產生數個檔案以及可快閃的處理站 OS 映射。這兩個檔案包含 Factory OS 映射中包含的元件相關資訊。您可以使用這些檔案來稽核內建映射的內容。這些檔案位於 Factory OS 映射的輸出檔案夾中：

檔案	描述
`<imagename>.DeviceDB.xml`	清查所有 OS 元件
`<imageame>.BSPDB.xml`	所有 OEM 自訂群組件的清查
`<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檔案包含 Microsoft 提供的所有 OS 套件 (套件的相關資訊，並包含在映射中包含的 WSK) 中。新增至映射的套件取決於映射組態中指定的專案， (OEMInput) 檔案中用來產生 Factory OS 映射。 DeviceDB.xml中的資訊包括：

影像中選取的功能
由 Microsoft 提供的 OS 套件，並包含在 WSK 中，構成指定映射。 OS 套件的相關資訊包括：
- OS 套件識別碼
- OS 套件版本

使用此檔案來稽核映射內容時，請根據列出的套件進行稽核。套件提供比功能更細微的細微性，而功能背後的套件可能會從發行變更為發行。

範例檔案名： FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.DeviceDB.xml

範例DeviceDB.xml

這是部分DeviceDB.xml檔案，其中顯示映射中包含的 OS 套件。

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

每個 OS 套件都會依其 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檔案包含 FACTORY OS 映射中包含的 OEM 自訂相關資訊，包括：

OEM 新增的自訂驅動程式
- 列在區 <Packages> 段中
- 包含已安裝驅動程式的相關資訊，包括版本和大小
映射中包含的市集應用程式
- 列在區 <AppxPackages> 段中
- 包含已安裝市集應用程式的相關資訊
- 列出已安裝的相依性
注意

即使是隨附于 WSK 的應用程式也會被視為 OEM 自訂專案，並列在此檔案中。這是因為原廠 OS 產品預設不包含任何應用程式，而且 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 包含映射中包含的 OEM 自訂套件相關資訊，相對於映射中包含的 Microsoft OS 套件。

報表有下列專案的元素：

適用的 自訂專案、公開自訂專案之 OS 套件所在的自訂專案。
無法套用 的自訂專案，其中公開自訂的 OS 套件不存在。
所有可用的 自訂專案，映射中的所有可用自訂專案。如果找到任何無法套用的自訂專案包含在影像中，報表將會記錄每個自訂專案的警告。

針對 OEM 撰寫的自訂，每個自訂的值都會出現在所有登錄設定的記錄檔中， (字串、數值等) ，但不會顯示檔案類型設定。

您可以停用此報表的建立，以減少映射建立時間。若要停用報表建立，請在執行 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>

共用方式為