Windows Unattend 自動部署

以 unattend.xml 回應檔自動化 Windows 10/11 安裝流程。涵蓋語系、磁碟分割、帳號建立、產品序號、首次登入腳本執行。

---

檔案

檔案	用途
unattend.xml	主回應檔，放入 USB/ISO 時需改名為 autounattend.xml
QUICKSTART.md	操作步驟：如何產生 USB、掛載 ISO、跑 VM 測試
SUMMARY.md	本專案的來由與設計脈絡

---

Pass 架構

Windows Setup 在不同階段套用不同 <settings pass="...">：

Pass	時機	本檔負責
windowsPE	WinPE 啟動、安裝前	UI 語系、磁碟分割（UEFI+GPT）、產品序號、EULA
specialize	映像套用後、第一次開機前	電腦名稱、時區、擁有者資訊
oobeSystem	首次開機 OOBE 階段	略過 OOBE、建立本機帳號、AutoLogon、FirstLogonCommands

---

元件與設定項

windowsPE

• Microsoft-Windows-International-Core-WinPE — SetupUILanguage / InputLocale / SystemLocale / UILanguage / UserLocale 皆為 zh-TW，InputLocale 為 0404:00000404（繁中鍵盤）。
• Microsoft-Windows-Setup
  • DiskConfiguration — 清空第一顆非-Ventoy 磁碟（$$VT_WINDOWS_DISK_1ST_NONVTOY$$，由 Ventoy Auto Install plugin 於執行期替換成實際 DiskID），建立三個分割：
    • EFI 500 MB（FAT32, Label System）
    • MSR 128 MB
    • Primary 其餘全部（NTFS, Label Windows, 掛 C:）
  • ImageInstall — 安裝到同一顆磁碟的 Partition 3
  • UserData — ProductKey（範本為 XXXXX-XXXXX-XXXXX-XXXXX-XXXXX，KMS 可用通用金鑰）、AcceptEula=true、FullName、Organization

specialize

• Microsoft-Windows-Shell-Setup
  • ComputerName — PC-%RAND:5%（5 位隨機數字）
  • TimeZone — Taipei Standard Time
  • RegisteredOwner / RegisteredOrganization

oobeSystem

• Microsoft-Windows-International-Core — 重複設定語系（OOBE 階段需要）
• Microsoft-Windows-Shell-Setup
  • OOBE — 全部略過：EULA、OEM 註冊、線上帳號、無線設定、機器與使用者 OOBE；NetworkLocation=Work、ProtectYourPC=3
  • UserAccounts.LocalAccounts — 建立 Admin（Administrators 群組，密碼 P@ssw0rd!，明碼）
  • AutoLogon — 以 Admin 自動登入一次（LogonCount=1）
  • FirstLogonCommands — 按 Order 依序執行：
    1. powershell.exe -ExecutionPolicy Bypass -File C:\Scripts\Setup.ps1
    2. cmd.exe /c net accounts /maxpwage:unlimited（密碼永不過期）
    3. Rename-Computer 改主機名成 PC-XXXXX（重開後生效）
    4. 下載 https://telegram.org/dl/desktop/win64 並以 /VERYSILENT /SUPPRESSMSGBOXES /NORESTART 靜默安裝 Telegram Desktop（per-user，裝到 Admin 帳號下）
    5. shutdown /r /t 5（重開機）

---

關鍵參數參考

參數	說明
processorArchitecture	x64 用 amd64、ARM64 用 arm64
publicKeyToken	微軟元件簽章，固定 31bf3856ad364e35
ProductKey	目前填的是 Win11/10 專業版 GVLK（W269N-WFGWX-YVC9B-4J6C9-T83GX，微軟文件），用來選版本＋略過序號畫面。GVLK 只在 KMS 主機環境下才會真正啟用，獨立機器會進 30 天寬限期。其他版本／零售序號直接換這串即可
PlainText	true 用明碼、false 用 Base64（SIM 會自動產生）
ComputerName	只接受字面名稱、*（自動產生如 DESKTOP-ABC123D）或空值。不支援 %RAND:N%——那是 MDT/SCCM task-sequence 變數，直接放進 unattend.xml 會被當字面字串送進 NetBIOS 驗證而失敗。本檔的做法是 <ComputerName>*</ComputerName> 加 FirstLogonCommands 裡的 Rename-Computer 改成 PC-XXXXX，重開後生效
WillShowUI	OnError / Always / Never
FirstLogonCommands	需搭配 AutoLogon 才會觸發；按 Order 同步執行

---

放置位置（擇一）

方式	位置	檔名
Ventoy Auto Install plugin（本 repo 預設）	Ventoy USB 的 /ventoy/script/，並在 /ventoy/ventoy.json 指定	任意（本 repo 用 unattend.xml）
傳統 USB 安裝碟	USB 根目錄	autounattend.xml
ISO sources\ 目錄	ISO 根	autounattend.xml
DISM 離線注入已掛載映像	—	任意名稱，用 /Apply-Unattend: 指定

---

驗證工具

• Windows SIM（Windows System Image Manager，Windows ADK 內含）— 視覺化編輯、驗證、自動產生 Base64 密碼。
• VM 試跑（Hyper-V / VirtualBox / VMware）— 正式部署前先在 VM 全跑一次。

---

安全性

• 本範本密碼為明碼，僅適合內網測試；生產環境請改 Base64 或交由 MDT/SCCM 管理。
• 部署結束後應刪除殘留的 unattend 檔，例如在 Setup.ps1 尾端：

  Remove-Item C:\Windows\Panther\unattend.xml -Force -ErrorAction SilentlyContinue
  Remove-Item C:\Windows\Panther\Unattend\unattend.xml -Force -ErrorAction SilentlyContinue
  

---

客製延伸

可在既有結構上擴充：

• 加入網域（Microsoft-Windows-UnattendedJoin.Identification）
• 安裝特定軟體（FirstLogonCommands 呼叫 winget / choco / MSI）
• 整合 WDS / MDT / SCCM 部署流程
• 多硬碟或 BIOS/MBR 分割配置