Configurare le impostazioni

Articolo
05/30/2023

Questo argomento descrive come configurare le personalizzazioni delle impostazioni classiche per le immagini del sistema operativo factory. Queste impostazioni verranno incluse in un'immagine e verranno applicate a tutti i dispositivi lampeggiati con l'immagine.

Vedere Impostazioni disponibili per il sistema operativo factory per vedere quali impostazioni classiche sono disponibili nel sistema operativo factory.

Generare un file di personalizzazione delle impostazioni

Usare lo CreateWSKCustomizationsXML script in WSK per generare un file di personalizzazione delle impostazioni:

Montare l'ISO WSK e aprire l'ambiente Windows System Kit come amministratore:
```
D:\SetWSKImagGenEnv.cmd
```
Impostare l'area di lavoro come radice dell'area di lavoro:
```
cd c:\workspace
SetWSKWorkspaceRoot.cmd
```

Generare un file XML di personalizzazione:

CreateWSKCustomizationsXML

Facoltativamente, è possibile creare un set di file XML di personalizzazione aggiungendo l'opzione -categorize . In questo modo viene generato un set di file XML di personalizzazione, divisi per categoria:
```
CreateWSKCustomizationsXML -Categorize
```
È anche possibile separare manualmente ogni XML di personalizzazione, purché i file XML di personalizzazione creati non abbiano più volte lo stesso <FeatureArea> codice XML di personalizzazione.

CreateWSKCustomizationsXMLsfrutta il file di configurazione dell'area di lavoro per ridurre il numero di parametri necessari. Sono disponibili i parametri facoltativi seguenti:

Parametri	Opzioni
-Categorizzare	Suddivide CustomizationXML in più file, un file per ogni personalizzazione. Se questa opzione non viene usata, verrà creato un file di personalizzazione di grandi dimensioni
-OutputFolder	Specifica la cartella in cui viene creato il codice XML di personalizzazione

Nota

Questo script sovrascriverà qualsiasi file XML di personalizzazione esistente nella directory di output. Se si dispone di un file XML di personalizzazione esistente, eseguirne il backup prima di eseguire questo script oppure usare l'opzione -OutputFolder per specificare una cartella di output diversa.

Dopo l'esecuzione dello script, nell'area di lavoro si avranno uno o più file di configurazione delle impostazioni, in %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.

Personalizzare il file di personalizzazione delle impostazioni

Aprire il file di personalizzazione delle impostazioni in un editor di testo.

Impostare gli attributi nell'elemento <Identity> :

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

Attributo	Descrizione
OwnerName	Nome dell'entità che crea l'immagine
ReleaseType	Deve corrispondere all'elemento OEMinput dell'immagine.`ReleaseType` Il valore valido è: `Test`. Vedere di seguito per informazioni su come scegliere il valore corretto.

Configurare le impostazioni. Ogni impostazione si trova in un elemento XML denominato <Customization>. Ecco l'aspetto di un <Customization> elemento:
```
<Customization Name="SplitLayoutFile">
  <ReadOnlyMetadata Description="OEM/SV-owned split layout file. (File must be named DeviceLayoutOEM.xml)" Type="FILE" DefaultValue="" SupportedExtensions="xml" />
  <Value />
</Customization>
```
In questo esempio vengono illustrati vari attributi per l'impostazione che illustrano le informazioni sull'impostazione e i valori possibili. Include anche un elemento vuoto denominato <Value>, che verrà usato per configurare l'impostazione.
Personalizzare un'impostazione modificando gli <Value> elementi delle impostazioni da personalizzare. Al termine, salvare il file XML.
- Per visualizzare tutte le impostazioni disponibili per il sistema operativo factory, vedere Impostazioni disponibili per il sistema operativo factory.
Il frammento di codice seguente mostra l'impostazione SplitLayoutFile popolata con il percorso del file 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>
```

Generare pacchetti di personalizzazione delle impostazioni e aggiungerli al file OEMInput

Nota

Per un test delle personalizzazioni più rapido, dopo aver generato i pacchetti di personalizzazione, è possibile aggiungerli direttamente a un'immagine di test.

Aprire l'ambiente Windows System Kit come amministratore

Impostare la radice dell'area di lavoro:

cd c:\workspace
SetWSKWorkspaceRoot.cmd

Lo CreateWSKCustomizationsFM script in WSK genera pacchetti di impostazioni e un manifesto della funzionalità di personalizzazione delle impostazioni che includono i pacchetti di impostazioni. Lo script aggiunge quindi il manifesto della funzionalità di personalizzazione al file OEMInput. Per impostazione predefinita, CreateWSKCustomizationsFM elabora tutti i file XML di personalizzazione della cartella di un'area di %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML lavoro.

CreateWSKCustomizationsFM

Nota

Questo comando non accetta più i -OEMInputparametri , -OEMNameo -Architecture .

Se è stato creato un set di file di personalizzazione categorizzati, usare l'opzione -customizationXML per puntare alla cartella in cui vengono salvati i file XML di personalizzazione. Ad esempio:
```
CreateWSKCustomizationsFM -customizationXML %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML
```

CreateWSKCustomizationsFMsfrutta il file di configurazione dell'area di lavoro per ridurre il numero di parametri necessari. È possibile usare i parametri facoltativi seguenti con CreateWSKCustomizationsFM:

Parametro	Opzioni
-OEMPackagesFolder	Specifica il percorso della cartella in cui sono archiviati i pacchetti di personalizzazione. Tutti i pacchetti di personalizzazione in questa cartella verranno inclusi nel manifesto della funzionalità. Il percorso predefinito è `%WSKWorkspaceRoot%\OEMCustomization\CustomizationXML`.
-Version	Consente di aggiungere un numero di versione aggiunto ai nomi dei pacchetti. Il formato è `xxxx.y.z.z`. Il valore predefinito è `1000.0.0.0`.
-FMFile	Consente di specificare il percorso del file manifesto della funzionalità di personalizzazione che definisce le impostazioni personalizzate. Questo fm viene aggiunto al file OEMInput in modo che le impostazioni siano incluse nell'immagine. Il valore predefinito è `%WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml`.
-CustomizationXML	Percorso di un file o di una cartella CustomizationXML che contiene file di personalizzazione. Se si specifica un percorso di cartella, tutti i file XML delle impostazioni di personalizzazione verranno elaborati e restituiranno una singola impostazione FM. Se questa opzione non è specificata, il percorso predefinito è `%WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.xml`.

Verificare che il file OEMCustomizationsFM.xml sia presente nel file OEMInput. Lo troverai nell'elemento <AdditionalFMs> :

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

Generare un'immagine. Quando si genera un'immagine, le impostazioni configurate verranno impostate nell'immagine.

Nota

È possibile aggiungere pacchetti di personalizzazione direttamente alle immagini per un'iterazione più veloce durante il test. Per altre informazioni, vedere Applicare patch a un'immagine del sistema operativo factory per i test .

Schema del file di personalizzazione delle impostazioni

I file di personalizzazione delle impostazioni sono costituiti da diversi elementi che classificano le impostazioni in vari gruppi. Le impostazioni all'interno di ogni gruppo sono correlate. Ogni impostazione ha attributi che mostrano come è possibile configurare ogni impostazione. Per configurare un'impostazione, aggiungere un valore all'elemento <Value> dell'impostazione da personalizzare.

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

Controllare le impostazioni in un'immagine

Quando si genera un'immagine, la cartella di output dell'area di lavoro include un log che contiene informazioni sulle impostazioni. Per altre informazioni, vedere WCOSCustomizationReport.xml .

Condividi tramite

Configurare le impostazioni

Generare un file di personalizzazione delle impostazioni

Personalizzare il file di personalizzazione delle impostazioni

Generare pacchetti di personalizzazione delle impostazioni e aggiungerli al file OEMInput

Schema del file di personalizzazione delle impostazioni

Controllare le impostazioni in un'immagine

Risorse aggiuntive