Compartilhar via

Auditoria de imagem

  • Artigo

Quando você executa BuildWSKImg, vários arquivos são gerados junto com a imagem do sistema operacional de fábrica que pode ser flash. Dois desses arquivos contêm informações sobre os componentes incluídos em uma imagem do sistema operacional de fábrica. Você pode usar esses arquivos para auditar o conteúdo de uma imagem criada. Esses arquivos estão na pasta de saída da imagem do sistema operacional de fábrica:

Arquivo Descrição
<imagename>.DeviceDB.xml Inventário de todos os componentes do sistema operacional
<imageame>.BSPDB.xml Inventário de todos os componentes personalizados do OEM
<imageame>.WCOSCustomizationReport.xml Informações sobre pacotes de personalização em uma imagem

Esses nomes de arquivo terão o mesmo nome que a imagem com a qual são gerados, mas com extensões de arquivo diferentes. Por exemplo:

  • 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 arquivos contêm informações sobre todos os pacotes do sistema operacional (pacotes fornecidos pela Microsoft e incluídos no WSK) incluídos em uma imagem. Os pacotes que são adicionados a uma imagem dependem do que é especificado no arquivo de configuração de imagem (OEMInput) usado para gerar uma imagem do sistema operacional de fábrica. As informações em DeviceDB.xml incluem:

  • Os recursos selecionados em uma imagem
  • Os pacotes do sistema operacional, fornecidos pela Microsoft e incluídos no WSK, que compõem uma determinada imagem. As informações sobre pacotes do sistema operacional incluem:
    • IDs do pacote do sistema operacional
    • Versões do pacote do sistema operacional

Ao usar esse arquivo para auditar o conteúdo da imagem, baseie sua auditoria nos pacotes listados. Os pacotes oferecem mais granularidade do que os recursos, e os pacotes por trás de um recurso podem mudar de versão para lançamento.

Nome do arquivo de exemplo: FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.DeviceDB.xml

Exemplo de DeviceDB.xml

Esse é um arquivo de DeviceDB.xml parcial que mostra os pacotes do sistema operacional incluídos na imagem.

<?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 pacote do sistema operacional é listado nesse arquivo por sua PackageID. Além da ID do Pacote, alguns pacotes incluem informações adicionais, como tamanho e versão instalados:

    <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 arquivos contêm informações sobre personalizações OEM incluídas em uma imagem do sistema operacional de fábrica, incluindo:

  • Drivers personalizados adicionados pelo OEM
    • Listado na <Packages> seção
    • Inclui informações sobre drivers instalados, incluindo versão e tamanho
  • Aplicativos da Store incluídos na imagem
    • Listado na <AppxPackages> seção
    • Inclui informações sobre aplicativos instalados da Store
    • Lista as dependências instaladas

    Observação

    Até mesmo os aplicativos fornecidos com o WSK são considerados personalizações OEM e listados neste arquivo. Isso ocorre porque os produtos do sistema operacional de fábrica não incluem nenhum aplicativo por padrão, e qualquer aplicativo incluído em uma imagem foi escolhido por um OEM para inclusão em uma imagem.

Ao usar esse arquivo para auditar o conteúdo da imagem, baseie sua auditoria nos pacotes listados. Os pacotes oferecem mais granularidade do que os recursos, e os pacotes por trás de um recurso podem mudar de versão para lançamento.

Nome do arquivo de exemplo: FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.BSPDB.xml

Arquivo de BSPDB.xml de exemplo

O snippet a seguir mostra como os drivers instalados e os aplicativos instalados aparecem no arquivo BSPDB.xml. Drivers e aplicativos são separados em duas seções diferentes, uma contendo <Packages>e outra contendo <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

O WCOSCustomizationReport contém informações relevantes sobre os pacotes de personalização OEM incluídos em uma imagem, em relação aos pacotes do sistema operacional da Microsoft incluídos na imagem.

O relatório tem elementos para:

  • Personalizações aplicáveis , personalizações em que o pacote do sistema operacional que expõe a personalização está presente.
  • Personalizações inaplicáveis , personalizações em que o pacote do sistema operacional que expõe a personalização não está presente.
  • Todas as personalizações disponíveis , todas as personalizações disponíveis na imagem. Se forem encontradas personalizações inaplicáveis na imagem, o relatório registrará um aviso para cada uma delas.

Para personalizações criadas por OEM, o valor de cada personalização aparece no log para todas as configurações do Registro (cadeias de caracteres, numéricas etc.), mas não configurações de tipo de arquivo.

Você pode desabilitar a criação deste relatório para reduzir o tempo de criação da imagem. Para desabilitar a criação do relatório, no ambiente do kit de sistema do Windows, defina a DISABLE_CUSTOMIZATION_REPORT variável como 1 antes de executar BuildWSKImage:

DISABLE_CUSTOMIZATION_REPORT=1

Configurações avançadas de personalização

Para arquivos de personalização de configurações que foram especificados usando o -advanced parâmetro , as configurações não aparecerão na seção "Todas as Personalizações Disponíveis" do log. No entanto, eles aparecerão na seção "Personalizações Aplicáveis".

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