이미지 감사

  • 아티클
  • 읽는 데 8분 걸림

BuildWSKImg를 실행하면 플래시 가능한 팩터리 OS 이미지와 함께 여러 파일이 생성됩니다. 이 파일 중 두 개에는 팩터리 OS 이미지에 포함된 구성 요소에 대한 정보가 포함되어 있습니다. 이 파일을 사용하여 기본 제공 이미지의 내용을 감사할 수 있습니다. 이러한 파일은 팩터리 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 파일에는 이미지에 포함된 모든 OS 패키지(Microsoft에서 제공하고 WSK에 포함된 패키지)에 대한 정보가 들어 있습니다. 이미지에 추가되는 패키지는 팩터리 OS 이미지를 생성하는 데 사용되는 이미지 구성(OEMInput) 파일에 지정된 항목에 따라 다릅니다. DeviceDB.xml의 정보에는 다음이 포함됩니다.

  • 이미지에서 선택한 기능
  • Microsoft에서 제공하고 WSK에 포함된 OS 패키지로, 주어진 이미지를 구성합니다. OS 패키지에 대한 정보는 다음과 같습니다.
    • OS 패키지 ID
    • OS 패키지 버전

이 파일을 사용하여 이미지 내용을 감사할 때 나열된 패키지를 기반으로 감사를 수행합니다. 패키지는 기능보다 더 세분화되어 있으며 기능 뒤에 있는 패키지는 릴리스마다 변경될 수 있습니다.

샘플 파일 이름: FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.DeviceDB.xml

샘플 DeviceDB.xml

이미지에 포함된 OS 패키지를 보여 주는 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>

각 OS 패키지는 PackageID별로 이 파일에 나열됩니다. 패키지 ID 외에도 일부 패키지에는 설치된 크기 및 버전과 같은 추가 정보가 포함됩니다.

    <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 파일에는 다음을 포함하여 팩터리 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에는 이미지에 포함된 Microsoft OS 패키지와 관련하여 이미지에 포함된 OEM 사용자 지정 패키지에 대한 관련 정보가 포함되어 있습니다.

보고서에는 다음에 대한 요소가 있습니다.

  • 적용 가능한 사용자 지정, 사용자 지정을 노출하는 OS 패키지가 있는 사용자 지정입니다.
  • 적용 불가 사용자 지정, 사용자 지정을 노출하는 OS 패키지가 없는 사용자 지정입니다.
  • 사용 가능한 모든 사용자 지정, 이미지에서 사용 가능한 모든 사용자 지정입니다. 이미지에 적용할 수 없는 사용자 지정이 포함된 것으로 확인되면 각각에 대한 경고가 보고서에 기록됩니다.

OEM으로 작성된 사용자 지정의 경우 각 사용자 지정 값은 모든 레지스트리 설정(문자열, 숫자 등)을 위해 로그에 표시되지만 파일 형식 설정은 표시되지 않습니다.

이 보고서 만들기를 사용하지 않도록 설정하여 이미지 만들기 시간을 줄일 수 있습니다. 보고서 만들기를 사용하지 않도록 설정하려면 Windows 시스템 키트 환경에서 BuildWSKImage를 실행하기 전에 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>