使用 WSK 建立基本 VM 映射

發行項
06/19/2023

在本逐步解說中，我們將示範如何使用 Windows 系統套件的不同元件，在 VM 上建置基準 Factory OS 映射。我們將示範如何使用功能資訊清單和映射組態檔來設定映射。

若要執行此實驗室，您需要：

技術人員電腦 搭配：
- 已安裝的 Windows 系統套件
- 已安裝 Hyper-V 管理員
範例驅動程式 (選擇性)
範例 UWP app (選擇性)

掛接您的 Windows 系統套件 ISO。
以系統管理員身分執行 SetImagGenEnv.cmd 來開啟映射建置環境。 SetImagGenEnv.cmd 位於掛接 WSK 的根目錄中。
建立工作區

我們將從建立工作區開始。工作區是您需要建立映射的檔案集合。當您建立工作區時，您必須選擇哪些架構、產品、配置、開機類型和映射類型。根據您的選擇，Windows 系統套件會建立具有 OEMInput 檔案的工作區，做為映射設定的起點。在此實驗室中，我們將建置可部署至 VM 的 Factory OS 映射：
```
PrepWSKWorkspace "C:\Workspace" -Product FactoryOS -VM
```
注意

當您執行 prepwskworkspace 時，會自動設定您在整個實驗室中看到的 %WSKWorkspaceRoot% 變數。如果您關閉並重新開啟 Windows 系統套件環境，您可以流覽至工作區資料夾並執行 SetWSKWorkspaceRoot.cmd 來設定工作區根目錄。
將驅動程式新增至映射 (選擇性)

當您建立工作區時，Windows 系統套件會建立名為的 OEMDriversFM.xml 檔案。此檔案可讓您定義您想要包含在映射中的驅動程式。 OEMDrivers.xmlWindows 系統套件所產生的檔案不包含有關其他驅動程式的任何資訊。如果您有想要新增的範例驅動程式：
1. 將驅動程式 .inf 檔案 (s) 及其所有相關聯的支援檔案 (.cab、.sys ) C:\Workspace\DCHUDrivers 等複製到。
2. 執行腳本以自動更新OEMDriversFM.xml：
```
UpdateWSKDriversFM
```
請參閱驅動程式功能資訊清單，以深入瞭解如何新增驅動程式，包括如何將驅動程式標示為選擇性，以及如何產生新的 Apps FM。
將應用程式新增至您的映像

當您建立工作區時，Windows 系統套件會建立名為的 OEMAppsFM.xml 檔案。此檔案會定義將特定應用程式新增至映射所需的專案。範例檔案已設定為將計算機應用程式新增為影像的選擇性功能。您的映射組態檔已包含計算機應用程式及其相依性。以下說明如何新增其他應用程式：
1. 將 .appx 套件組合、其授權檔案和任何相依性 %WSKWorkspaceRoot%\Apps 複製到資料夾中。
2. 從 [建置環境] 執行：
```
UpdateWSKAppsFM
```
3. 您將會有更新OEMAppsFM.xml檔案，其中包含資料夾中的應用程式 Apps 。當您執行 UpdateWSKAppsFM 時，新增的應用程式不會標示為選擇性。如果您想要讓它們成為選擇性，請編輯 XML 檔案，並針對您想要選擇性的應用程式進行設定 Optional = True 。
4. 未設定為選擇性的應用程式將會包含在您的映射 (只要 FM 檔案包含在映射組態檔) 。如果您已將應用程式設定為選擇性，而且想要將其新增至映射組態檔，則必須將其識別碼新增至區 AppXOptionalPackages 段。以下是新增計算機應用程式的外觀 (，因為當您建置工作區) 時，它已設定為選擇性。
  
  查看中的 OEMAppsFM.xml 專案：
```
<PackageFile Optional="true" ID="Microsoft.WindowsCalculator_8wekyb3d8bbwe" LicenseFile="Microsoft.WindowsCalculator_8wekyb3d8bbwe.xml" Name="Microsoft.WindowsCalculator_8wekyb3d8bbwe.appxbundle" Path="$(mspackageroot)\Appx\Calculator"/>
```
  ID請注意 () Microsoft.WindowsCalculator_8wekyb3d8bbwe ，我們將使用此專案來新增應用程式。
  
  ID複製並貼到映射組態檔中。其看起來將會像下面這樣：
```
<AppXOptionalPackages>

    <AppXID>Microsoft.WindowsCalculator_8wekyb3d8bbwe</AppXID>
</AppXOptionalPackages>
```
5. 儲存映射組態檔。
如果您想要在映射中提供更多應用程式，請參閱應用程式功能資訊清單。
在您的映射組態檔中包含功能資訊清單

當您建立工作區時，Windows 系統套件建立了自動包含 OEMAppsFM.xml 和 OEMDriversFM.xml 的映射組態檔。如果您建立其他功能資訊清單，您必須在映射組態檔的元素底下 AdditionalFMs 新增它們。這會讓功能資訊清單中定義的功能可供新增至您的映射。映射組態檔中的所有功能都會定義于功能資訊清單中。將功能資訊清單新增至映射組態檔，讓該功能資訊清單中定義的所有功能都可供新增至映射。

在 XML 編輯器中開啟您的映射組態檔，並確認 OEMAppsFM.xml 和 OEMDriversFM.xml 已列出。除非指定為 optional ，否則這些 FM 中包含的應用程式和驅動程式會自動包含在您的映射中。您可以在功能資訊清單中深入瞭解如何將功能標示為選擇性。

開啟您的映射組態檔。您應該會看到檔案中所列的下列 FM。如果未列出應用程式和驅動程式的功能資訊清單，請新增它們，使其看起來像這樣：
```
<AdditionalFMs>

<AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\GenericDeviceFM.xml</AdditionalFM>
<AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\FOSNonProductionFM.xml</AdditionalFM>
<AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\HardwareValidationFM.xml</AdditionalFM>

<AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM>
<AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM>
</AdditionalFMs>
```
建立映像

執行下列命令來建置映射。當我們設定工作區時，會將映射設定為 VM。這會在名為 Workspace.Output 的資料夾中建置 VM。
```
BuildWSKImage %WSKWorkspaceRoot%\FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.xml
```
注意

此處參考的 xml 檔案可能會因您在建置工作區時所選擇的選項而有所不同。如果您在執行此命令時收到錯誤，請確定檔案名正確。
重要

如果您嘗試在目的地資料夾中產生已包含的影像。FFU 映射或具有相同名稱的虛擬硬碟，映射建立將會失敗，並出現下列錯誤：
```
imageapp : ERROR : ThreadId18164 OutputFile C:\FactoryOS.Output\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.ffu already exists.
```
在產生影像之前，請確定您的輸出檔案夾尚未包含相同名稱的已產生影像。
建立使用您所建立之虛擬硬碟的虛擬機器。開機後，您可以使用裝置入口網站、 SSH或 TShell連線到裝置。

共用方式為

使用 WSK 建立基本 VM 映射

其他資源