共用方式為


配置設定

本主題描述如何為您的 Factory OS 映像設定傳統設定自定義。 這些設定會包含在映像中,並會套用至映像閃爍的所有裝置。

產生設定自定義檔案

CreateWSKCustomizationsXML使用 WSK 中的腳本來產生 [設定] 自訂檔案:

  1. 掛接 WSK ISO,並以系統管理員身分開啟 Windows 系統套件環境:

    D:\SetWSKImagGenEnv.cmd
    
  2. 將您的工作區設定為工作區根目錄:

    cd c:\workspace
    SetWSKWorkspaceRoot.cmd
    
  3. 產生自訂 XML 檔案:

    CreateWSKCustomizationsXML
    
    • 您可以藉由新增 -categorize 選項,選擇性地建立一組自定義 XML 檔案。 這會產生一組自定義 XML 檔案,除以類別:

      CreateWSKCustomizationsXML -Categorize
      
    • 您也可以進一步個別自定義 XML,前提是您所建立的自定義 XML 檔案在多個自定義 XML 中沒有相同的 <FeatureArea> 重複。

    CreateWSKCustomizationsXML利用工作區組態檔來減少所需的參數數目。 下列選擇性參數可供使用:

    參數 選項。
    -分類 將 CustomizationXML 分割成多個檔案,每個自定義一個檔案。 如果未使用此選項,將會建立一個大型自定義檔案
    -OutputFolder 指定建立自訂 XML 的資料夾

    注意

    此文稿將會覆寫輸出目錄中任何現有的自定義 XML 檔案。 如果您有現有的自定義 XML 檔案,請在執行此腳本之前先備份它,或使用 -OutputFolder 選項來指定不同的輸出資料夾。

  4. 腳本執行之後,您的工作區中將會有一或多個設定組態檔,在 中 %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML

自訂您的設定自定義檔案

  1. 在文字編輯器中開啟您設定自定義檔案。

  2. 在 元素設定 <Identity> 屬性:

    <Identity OwnerName="OEMName" ReleaseType="Test" />
    
    屬性 描述
    OwnerName 建立映像的實體名稱
    ReleaseType 這應該符合影像的 ReleaseType OEMinput 元素。 有效值為: Test。 請參閱下方以瞭解如何選擇正確的值。
  3. 設定設定。 每個設定都位於名為 <Customization>的 XML 元素中。 以下是 <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>
    

    此範例顯示設定的各種屬性,這些屬性涵蓋設定和可能值的相關信息。 它也有名為 <Value>的空白元素,您將用來設定設定。

  4. 修改您要自定義之設定的元素, <Value> 以自訂設定。 完成時,請儲存 XML 檔案。

    • 若要查看處理站OS的所有可用設定,請參閱 Factory OS 可用設定。

    下列代碼段顯示 SplitLayoutFile 填入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>
    

產生設定自定義套件,並將其新增至 OEMInput 檔案

注意

若要加快自定義測試的速度,一旦您產生自定義套件,即可 將它們直接新增至測試映像

  1. 以系統管理員身分開啟 Windows System Kit 環境

  2. 設定工作區根目錄:

    cd c:\workspace
    SetWSKWorkspaceRoot.cmd
    
  3. CreateWSKCustomizationsFM WSK 中的文稿會產生設定套件,以及包含設定套件的設定自定義功能指令清單。 然後,腳本會將自定義功能指令清單新增至您的 OEMInput 檔案。 根據預設, CreateWSKCustomizationsFM 將會處理工作區 %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML 資料夾的所有自定義 XML 檔案。

    CreateWSKCustomizationsFM
    

    注意

    此命令不再接受 -OEMInput-OEMName-Architecture 參數。

    • 如果您已建立一組分類的自定義檔案,請使用 -customizationXML 選項來指向儲存自定義 XML 檔案的資料夾。 例如:

      CreateWSKCustomizationsFM -customizationXML %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML
      

    CreateWSKCustomizationsFM利用工作區組態檔來減少所需的參數數目。 您可以使用下列選擇性參數搭配 CreateWSKCustomizationsFM

    參數 選項。
    -OEMPackagesFolder 指定儲存自定義套件的資料夾路徑。 此資料夾中的所有自定義套件都會包含在功能指令清單中。 預設路徑為 %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML
    -版本 允許新增附加至套件名稱的版本號碼。 格式為 xxxx.y.z.z。 預設值為 1000.0.0.0
    -FMFile 可讓您指定定義自訂設定的自訂功能指令清單檔路徑。 此 FM 會新增至 OEMInput 檔案,讓設定包含在映射中。 預設值為 %WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml
    -CustomizationXML 包含自定義檔案之 CustomizationXML 檔案或資料夾的路徑。 如果您指定資料夾路徑,則會處理所有自訂設定 xml 檔案,並輸出單一設定 FM。 如果未指定這個選項,預設路徑為 %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.xml
  4. 確認您的OEMCustomizationsFM.xml檔案位於 OEMInput 檔案中。 您會在 <AdditionalFMs> 元素中找到它:

    <AdditionalFMs>
    ...
      <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM>
      <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM>
      <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml</AdditionalFM>
    </AdditionalFMs>
    
  5. 產生影像。 當您產生映像時,您設定的設定將會在映像中設定。

    注意

    在測試時,可以將自定義套件直接新增至映像,以加快反覆專案的速度。 如需詳細資訊,請參閱 修補處理站OS映像以進行測試

設定自定義檔案架構

設定自定義檔案是由數個元素所組成,這些元素會將設定分類為各種群組。 每個群組內的設定都相關。 每個設定都有屬性,顯示如何設定每個設定。 若要設定設定,您會將值新增至 <Value> 您想要自定義之設定的 元素。

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

稽核映像中的設定

當您產生映像時,工作區輸出資料夾會包含包含設定相關信息的記錄檔。 如需詳細資訊,請參閱 WCOSCustomizationReport.xml