Timmy
fd795f3d66
- unattend.xml: DiskID 由硬寫 0 改成 $$VT_WINDOWS_DISK_1ST_NONVTOY$$， 防止在 Ventoy 下把 USB 本身當成安裝目標 - ventoy.json: 新增 Auto Install plugin 設定範本 - QUICKSTART.md: 用 Ventoy 流程重寫 USB 佈置與 VM 測試章節 - README.md: 放置位置表新增 Ventoy 路徑為預設 - CLAUDE.md: 新增專案導覽文件，標註 Ventoy-only 前提與 DiskID 變數 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
114 lines
4.5 KiB
Markdown
114 lines
4.5 KiB
Markdown
# 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. `shutdown /r /t 5`（重開機）
|
||
|
||
---
|
||
|
||
## 關鍵參數參考
|
||
|
||
| 參數 | 說明 |
|
||
|---|---|
|
||
| `processorArchitecture` | x64 用 `amd64`、ARM64 用 `arm64` |
|
||
| `publicKeyToken` | 微軟元件簽章，固定 `31bf3856ad364e35` |
|
||
| `ProductKey` | 零售/OEM 填正式序號；KMS/大量授權可用 Generic Volume License Key，或留空 |
|
||
| `PlainText` | `true` 用明碼、`false` 用 Base64（SIM 會自動產生） |
|
||
| `%RAND:5%` | 內建變數，產生 5 位隨機數字避免主機名衝突 |
|
||
| `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` 尾端：
|
||
```powershell
|
||
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 分割配置
|