Definir configuración

Artículo
07/12/2024

En este tema se describe cómo configurar las personalizaciones de la configuración clásica para las imágenes del sistema operativo de fábrica. Esta configuración se incluirá en una imagen y se aplicará a todos los dispositivos que se instalen con la imagen.

Consulte Configuración disponible para el sistema operativo de fábrica para ver qué configuración clásica está disponible en el sistema operativo de fábrica.

Generar un archivo de personalización de la configuración

Use el script CreateWSKCustomizationsXML de WSK para generar un archivo de personalización de la configuración:

Monte la ISO de WSK y abra el entorno del Kit de sistema de Windows como administrador:
```
D:\SetWSKImagGenEnv.cmd
```
Establezca su área de trabajo como raíz del área de trabajo:
```
cd c:\workspace
SetWSKWorkspaceRoot.cmd
```

Genere un archivo XML de personalización:

CreateWSKCustomizationsXML

Opcionalmente, puede crear un conjunto de archivos XML de personalización agregando la opción -categorize. Esto genera un conjunto de archivos XML de personalización divididos por categoría:
```
CreateWSKCustomizationsXML -Categorize
```
También puede separar manualmente cada XML de personalización, siempre que los archivos XML de personalización que cree no tengan la misma <FeatureArea> repetida en más de un XML de personalización.

CreateWSKCustomizationsXML aprovecha el archivo de configuración del área de trabajo para reducir el número de parámetros necesarios. Están disponibles los siguientes parámetros opcionales:

Parámetros	Opciones
-Categorize	Divide CustomizationXML en varios archivos, uno por personalización. Si no se usa esta opción, se creará un único archivo de personalización grande.
-OutputFolder	Especifica la carpeta en la que se crea el XML de personalización.

Nota:

Este script sobrescribirá cualquier archivo XML de personalización presente en el directorio de salida. Si ya tiene un archivo XML de personalización, haga una copia de seguridad antes de ejecutar este script o use la opción -OutputFolder para especificar una carpeta de salida diferente.

Una vez que se ejecute el script, tendrá uno o varios archivos de configuración en el área de trabajo, en %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.

Personalizar el archivo de personalización de la configuración

Abra el archivo de personalización de la configuración en un editor de texto.

Establezca los atributos del elemento <Identity>:

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

Atributo	Descripción
OwnerName	Nombre de la entidad que crea la imagen
ReleaseType	Esto debe coincidir con el `ReleaseType` elemento OEMinput de la imagen. El valor válido es: `Test`. Consulte la sección siguiente para ver cómo puede elegir el valor correcto.

Configure las opciones. Cada ajuste está en un elemento XML denominado <Customization>. Este es el aspecto de un 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>
```
En este ejemplo se muestran varios atributos del ajuste que contienen información sobre el ajuste y sus posibles valores. También hay un elemento vacío denominado <Value>, que se usará para configurar el ajuste.
Personalice un ajuste modificando los elementos <Value> de los ajustes que desee personalizar. Cuando haya acabado, guarde el archivo XML.
- Para ver todas las opciones disponibles del sistema operativo de fábrica, consulte Configuración disponible para el sistema operativo de fábrica.
En el fragmento de código siguiente, se muestra el ajuste SplitLayoutFile rellenado con la ruta de acceso del archivo de 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>
```

Generar paquetes de personalización de la configuración y agregarlos al archivo OEMInput

Nota:

Para realizar pruebas de personalización más rápidas, una vez que genere los paquetes de personalización, puede agregarlos directamente a una imagen de prueba.

Abra el entorno del Kit de sistema de Windows como administrador.
Configure la raíz de su área de trabajo:
```
cd c:\workspace
SetWSKWorkspaceRoot.cmd
```

El script CreateWSKCustomizationsFM del WSK genera paquetes de configuración y un manifiesto de características de personalización de la configuración que incluye los paquetes de configuración. A continuación, el script agrega el manifiesto de características de personalización al archivo OEMInput. De forma predeterminada, CreateWSKCustomizationsFM procesará todos los archivos XML de personalización de la carpeta %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML del área de trabajo.

CreateWSKCustomizationsFM

Nota:

Este comando ya no acepta los parámetros -OEMInput, -OEMName o -Architecture.

Si creó un conjunto de archivos de personalización categorizados, use la opción -customizationXML para seleccionar la carpeta en la que se guardan los archivos XML de personalización. Por ejemplo:
```
CreateWSKCustomizationsFM -customizationXML %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML
```

CreateWSKCustomizationsFM aprovecha el archivo de configuración del área de trabajo para reducir el número de parámetros necesarios. También puede configurar los siguientes parámetros opcionales con CreateWSKCustomizationsFM:

Parámetro	Opciones
-OEMPackagesFolder	Especifica la ruta de acceso de la carpeta en la que se almacenan los paquetes de personalización. Todos los paquetes de personalización de esta carpeta se incluirán en el manifiesto de características. La ruta de acceso predeterminada es `%WSKWorkspaceRoot%\OEMCustomization\CustomizationXML`.
-Version	Permite agregar un número de versión anexado a los nombres de paquete. El formato es `xxxx.y.z.z`. El valor predeterminado es `1000.0.0.0`.
-FMFile	Permite especificar la ruta de acceso del archivo de manifiesto de características de personalización que define la configuración personalizada. Este FM se agrega al archivo OEMInput para que la configuración se incluya en la imagen. El valor predeterminado es `%WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml`.
-CustomizationXML	Ruta de acceso a un archivo o carpeta CustomizationXML que contiene archivos de personalización. Si especifica una ruta de acceso de carpeta, se procesarán todos los archivos XML de configuración de personalización y se generará un único FM de configuración. Si no se especifica esta opción, la ruta de acceso predeterminada es `%WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.xml`.

Compruebe que el archivo OEMCustomizationsFM.xml está en el archivo OEMInput. Lo encontrará en el elemento <AdditionalFMs>:

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

Genere una imagen. Al generar una imagen, la configuración creada se establecerá en la imagen.

Nota:

Es posible agregar paquetes de personalización directamente a imágenes para una iteración más rápida durante las pruebas. Consulte Revisar una imagen del sistema operativo de fábrica para pruebas para obtener más información.

Esquema de archivo de personalización de la configuración

Los archivos de personalización de la configuración se componen de varios elementos que clasifican los ajustes en varios grupos. Los ajustes de cada grupo están relacionados. Cada ajuste tiene atributos que muestran cómo se puede configurar. Para configurar un ajuste, agregue un valor al elemento <Value> del ajuste que desee 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 la configuración de una imagen

Al generar una imagen, la carpeta de salida del área de trabajo incluye un registro que contiene información sobre la configuración. Consulte WCOSCustomizationReport.xml para obtener más información.

Compartir a través de

Definir configuración

Generar un archivo de personalización de la configuración

Personalizar el archivo de personalización de la configuración

Generar paquetes de personalización de la configuración y agregarlos al archivo OEMInput

Esquema de archivo de personalización de la configuración

Auditar la configuración de una imagen

Recursos adicionales