Definir configurações

Artigo
07/12/2024

Este tópico descreve como definir personalizações de configurações clássicas para suas imagens do sistema operacional de fábrica. Essas configurações serão incluídas em uma imagem e serão aplicadas a todos os dispositivos que são instalados com a imagem.

Consulte Configurações disponíveis para o sistema operacional de fábrica para ver quais configurações clássicas estão disponíveis no sistema operacional de fábrica.

Gerar um arquivo de personalização de configurações

Use o script CreateWSKCustomizationsXML no WSK para gerar um arquivo de personalização de configurações:

Monte o ISO do WSK e abra o ambiente do Kit de sistema do Windows como administrador:
```
D:\SetWSKImagGenEnv.cmd
```
Defina seu espaço de trabalho como a raiz do espaço de trabalho:
```
cd c:\workspace
SetWSKWorkspaceRoot.cmd
```

Gere um arquivo XML de personalização:

CreateWSKCustomizationsXML

Opcionalmente, você pode criar um conjunto de arquivos XML de personalização adicionando a opção -categorize. Isso gera um conjunto de arquivos XML de personalização, divididos por categoria:
```
CreateWSKCustomizationsXML -Categorize
```
Você também pode separar manualmente cada XML de personalização, desde que os arquivos XML de personalização criados não tenham o mesmo <FeatureArea> repetido em mais de um XML de personalização.

CreateWSKCustomizationsXML aproveita o Arquivo de configuração do espaço de trabalho para reduzir o número de parâmetros necessários. Estão disponíveis os seguintes parâmetros opcionais:

Parâmetros	Opções
-Categorize	Divide o CustomizationXML em vários arquivos, um arquivo por personalização. Se essa opção não for usada, um arquivo de personalização grande será criado
-OutputFolder	Especifica a pasta na qual o XML de personalização é criado

Observação

Esse script substituirá qualquer arquivo XML de personalização existente no diretório de saída. Se você tiver um arquivo XML de personalização existente, faça backup dele antes de executar esse script ou use a opção -OutputFolder para especificar uma pasta de saída diferente.

Depois de executar o script, você terá um ou mais arquivos de configuração em seu espaço de trabalho, em %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.

Personalizar o arquivo de personalização de configurações

Abra o arquivo de personalização de configurações em um editor de texto.

Defina os atributos no elemento <Identity>:

<Identity OwnerName="OEMName" ReleaseType="Test" />

Atributo	Descrição
OwnerName	O nome da entidade que cria a imagem
ReleaseType	Isso deve corresponder ao `ReleaseType` elemento OEMinput da imagem. O valor válido é: `Test`. Veja abaixo como escolher o valor correto.

Definir configurações. Cada configuração está em um elemento XML chamado <Customization>. Veja a aparência de um elemento <Customization>:
```
<Customization Name="SplitLayoutFile">
  <ReadOnlyMetadata Description="OEM/SV-owned split layout file. (File must be named DeviceLayoutOEM.xml)" Type="FILE" DefaultValue="" SupportedExtensions="xml" />
  <Value />
</Customization>
```
Esse exemplo mostra vários atributos para a configuração que abrangem informações sobre a configuração e valores possíveis. Ele também tem um elemento vazio chamado <Value>, que você usará para definir a configuração.
Personalize uma configuração modificando os elementos <Value> das configurações que você deseja personalizar. Ao terminar, salve o arquivo XML.
- Para ver todas as configurações disponíveis para o sistema operacional de fábrica, consulte Configurações disponíveis para o sistema operacional de fábrica.
O trecho abaixo mostra a SplitLayoutFile configuração preenchida com o caminho para o caminho do arquivo DeviceLayoutOEM.xml.
```
<Customization Name="SplitLayoutFile">
  <ReadOnlyMetadata Description="OEM/SV-owned split layout file. (File must be named DeviceLayoutOEM.xml)" Type="FILE" DefaultValue="" SupportedExtensions="xml" />
  <Value>%WSKWorkspaceRoot%\OEMCustomization\DeviceLayout\DeviceLayoutOEM.xml</Value>
</Customization>
```

Gere pacotes de personalização de configurações e adicione-os ao seu arquivo OEMInput

Observação

Para testes de personalizações mais rápidos, depois de gerar seus pacotes de personalização, você pode adicioná-los diretamente a uma imagem de teste.

Abra o ambiente do Kit do sistema do Windows como administrador

Configure a raiz do espaço de trabalho:

cd c:\workspace
SetWSKWorkspaceRoot.cmd

O script CreateWSKCustomizationsFM no WSK gera pacotes de configurações e um manifesto de recurso de personalização de configurações que incluem os pacotes de configurações. Em seguida, o script adiciona o manifesto do recurso de personalização ao arquivo OEMInput. Por padrão, CreateWSKCustomizationsFM processará todos os arquivos XML de personalização de uma pasta %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML de espaço de trabalho.

CreateWSKCustomizationsFM

Observação

Esse comando não aceita mais os parâmetros -OEMInput, -OEMName ou -Architecture.

Se você criou um conjunto de arquivos de personalização categorizados, use a opção -customizationXML para apontar para a pasta na qual os arquivos XML de personalização são salvos. Por exemplo:
```
CreateWSKCustomizationsFM -customizationXML %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML
```

CreateWSKCustomizationsFM aproveita o Arquivo de configuração do espaço de trabalho para reduzir o número de parâmetros necessários. Você pode usar os seguintes parâmetros opcionais com CreateWSKCustomizationsFM:

Parâmetro	Opções
-OEMPackagesFolder	Especificado o caminho da pasta na qual os pacotes de personalização são armazenados. Todos os pacotes de personalização nesta pasta serão incluídos no manifesto do recurso. O caminho padrão é `%WSKWorkspaceRoot%\OEMCustomization\CustomizationXML`.
-Version	Permite adicionar um número de versão anexado aos nomes dos pacotes. O formato é `xxxx.y.z.z`. O padrão é `1000.0.0.0`.
-FMFile	Permite especificar o caminho do arquivo de manifesto do recurso Personalização que define suas configurações personalizadas. Esse FM é adicionado ao seu arquivo OEMInput para que as configurações sejam incluídas na sua imagem. O padrão é `%WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml`.
-CustomizationXML	Caminho para um arquivo ou pasta CustomizationXML que contém arquivos de personalização. Se você especificar um caminho de pasta, todos os arquivos xml de configurações de personalização serão processados e produzirão um único FM de configurações. Se esta opção não for especificada, o caminho padrão será `%WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.xml`.

Verifique se o arquivo OEMCustomizationsFM.xml está no arquivo OEMInput. Você vai encontrá-lo no elemento <AdditionalFMs>:

<AdditionalFMs>
...
  <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM>
  <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM>
  <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml</AdditionalFM>
</AdditionalFMs>

Gere uma imagem. Quando você gera uma imagem, as configurações que você configurou serão definidas em sua imagem.

Observação

É possível adicionar pacotes de personalização diretamente às imagens para uma iteração mais rápida durante o teste. Consulte Corrigir uma imagem do sistema operacional de fábrica para testar para obter mais informações.

Esquema do arquivo de personalização de configurações

Os arquivos de personalização de configurações são compostos por vários elementos que classificam as configurações em vários grupos. As configurações dentro de cada grupo estão relacionadas. Cada configuração tem atributos que mostram como cada configuração pode ser configurada. Para definir uma configuração, adicione um valor ao elemento <Value> da configuração que deseja personalizar.

<?xml version="1.0" encoding="utf-8"?>
<CustomizationFile xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" SchemaVersion="1.0" BuildArch=" " Product=" " BuildInfo=" " xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate">
  <Identity OwnerName="" ReleaseType="" />
  <Categories>
    <Category Name="Default">
      <FeatureAreas>
        <FeatureArea Name="Area1">
          <Customizations>
            <Customization Name="Example1">
              <ReadOnlyMetadata Description="Attributes in this element describe values for configuring this setting" Type="REG_DWORD" DefaultValue="1" Minimum="0" Maximum="1" />
              <Value />
            </Customization>
            <Customization Name="Example2">
              <ReadOnlyMetadata Description="Set the value element to configure settings" Type="REG_SZ" DefaultValue="" />
              <Value />
            </Customization>
          </Customizations>
        </FeatureArea>
      </FeatureAreas>
    </Category>
    <Category Name="Category2">
      <FeatureAreas>
        <FeatureArea Name="Area2">
          <Customizations>
            <Customization Name="Example3">
              <ReadOnlyMetadata Description="Set the value element to configure settings" Type="REG_SZ" DefaultValue="" />
              <Value />
            </Customization>
          </Customizations>
        </FeatureArea>
      </FeatureAreas>
    </Category>
  </Categories>
</CustomizationFile>

Auditar as configurações em uma imagem

Quando você gera uma imagem, a pasta de saída do espaço de trabalho inclui um log que contém informações sobre configurações. Consulte WCOSCustomizationReport.xml para obter mais informações.

Compartilhar via

Definir configurações

Gerar um arquivo de personalização de configurações

Personalizar o arquivo de personalização de configurações

Gere pacotes de personalização de configurações e adicione-os ao seu arquivo OEMInput

Esquema do arquivo de personalização de configurações

Auditar as configurações em uma imagem

Recursos adicionais