Timmy
b1e5b6912a
把 Order 3 的 net user 命令直接寫成 net user User，省掉「先建小寫 user 再 Rename-LocalUser 改成大寫 User」這個迂迴。Setup.ps1 的 rename-hide-accounts 段同時改名為 hide-admin-account，內容只剩設 SpecialAccounts\\UserList\\Admin=0 這一行——隱藏 Admin 仍然由 Setup.ps1 負責。 文件全部同步：DEPLOY/QUICKSTART/SUMMARY/README/CLAUDE 把「先建小寫再改名」的 bulletproof 解釋與相關段名都拿掉。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
200 lines
10 KiB
Markdown
200 lines
10 KiB
Markdown
# QUICKSTART — 從零到自動安裝 Windows
|
||
|
||
照著做一次就能跑出一個「Ventoy 開機 → 選 ISO → 自動裝完 Windows → 自動登入 → 跑 Setup.ps1 → 重開機」的流程。
|
||
|
||
> 預設情境：x64、UEFI+GPT、繁體中文、**Ventoy USB**（[ventoy.net](https://www.ventoy.net/)）載入多個 ISO。
|
||
|
||
---
|
||
|
||
## 0. 事前準備
|
||
|
||
需要準備：
|
||
|
||
- [ ] Windows 10 或 11 官方 ISO（從 [microsoft.com](https://www.microsoft.com/software-download) 取得）
|
||
- [ ] 已刷好 Ventoy 的 USB 隨身碟（≥ 16 GB 建議，因為會同時放 ISO 與 script）
|
||
- [ ] 一台測試機或 VM（強烈建議先在 VM 驗證）
|
||
- [ ] 本專案的 `unattend.xml`、`Setup.ps1`、`ventoy.json`
|
||
|
||
**編輯 `unattend.xml` 的必改項目：**
|
||
|
||
| 行為 | 原值 | 要改成 |
|
||
|---|---|---|
|
||
| 產品序號 | Win11/10 Pro GVLK（`W269N-WFGWX-...`） | 你的序號，或留 GVLK 用 KMS，或整個 `<ProductKey>` 節點刪掉 |
|
||
| 管理員密碼 | `P@ssw0rd!`（兩處：`LocalAccount` 與 `AutoLogon`） | 你的密碼 |
|
||
| 組織名 | `YourCompany` | 你的組織 |
|
||
| `DiskID` | `$$VT_WINDOWS_DISK_1ST_NONVTOY$$`（Ventoy 變數） | **保留不動**。Ventoy 會在執行期替換成「第一顆非 Ventoy USB 的磁碟」 |
|
||
|
||
**編輯 `Setup.ps1` 的常改項目（在檔案頂部）：**
|
||
|
||
| 變數 | 預設 | 要改成 |
|
||
|---|---|---|
|
||
| `$InternalKmsServers` | `@()` 空陣列 | 你內網 KMS 主機，例：`@('kms.your-corp.com')`；空陣列就 fallback 到公開 KMS |
|
||
| `$UwpRemoveList` | 22 個 Microsoft 預載 app | 想多移/少移就改這個陣列 |
|
||
| `$Win11DebloatConfigJson` | toolkit 的預設（暗色、工作列靠左、停 Bing/Copilot/Recall…） | 不喜歡哪個 tweak 就把該行 `Value` 改成 `false` |
|
||
|
||
**編輯 `ventoy.json` 的必改項目：**
|
||
|
||
| 欄位 | 原值 | 要改成 |
|
||
|---|---|---|
|
||
| `image` | `/Win11.iso` | USB 上實際的 ISO 路徑（相對 USB 根目錄，開頭要有 `/`） |
|
||
|
||
---
|
||
|
||
## 1. 佈置 Ventoy USB
|
||
|
||
假設 Ventoy 已刷好（若還沒，從 [ventoy.net](https://www.ventoy.net/) 下載 `Ventoy2Disk` 跑一次即可）。Ventoy USB 通常有兩個分割區，資料分割區掛上後會是一個大容量 exFAT/NTFS 碟。
|
||
|
||
把檔案放到 Ventoy 資料分割區：
|
||
|
||
```
|
||
<Ventoy USB 根目錄>/
|
||
├── Win11.iso ← 你的 Windows ISO（檔名要對上 ventoy.json 的 image）
|
||
└── ventoy/
|
||
├── ventoy.json ← 本 repo 的 ventoy.json
|
||
└── script/
|
||
├── unattend.xml ← 本 repo 的 unattend.xml（改完的）
|
||
└── Setup.ps1 ← 本 repo 的 Setup.ps1（首次登入會被自動複製到 C:\Scripts\）
|
||
```
|
||
|
||
macOS / Linux 範例：
|
||
|
||
```bash
|
||
# 假設 Ventoy 資料分割區掛在 /Volumes/Ventoy
|
||
cp Windows.iso /Volumes/Ventoy/Win11.iso
|
||
mkdir -p /Volumes/Ventoy/ventoy/script
|
||
cp ventoy.json /Volumes/Ventoy/ventoy/ventoy.json
|
||
cp unattend.xml /Volumes/Ventoy/ventoy/script/unattend.xml
|
||
cp Setup.ps1 /Volumes/Ventoy/ventoy/script/Setup.ps1
|
||
```
|
||
|
||
> **改 `Setup.ps1` 後記得重 `cp`**。`unattend.xml` 的 FirstLogonCommands 從 USB 上的 `/ventoy/script/Setup.ps1` 抓檔案，不是從 repo。沒同步的話部署到的 Windows 會跑舊版。
|
||
|
||
> 不用改名成 `autounattend.xml`，也不用把 XML 塞進 ISO 根目錄。Ventoy 的 Auto Install plugin 會在開機時依 `ventoy.json` 把 XML 注入給 Windows Setup。
|
||
|
||
**多個 ISO / 多套範本**：`ventoy.json` 的 `auto_install` 是陣列，每個 ISO 一條目；`template` 也可以是陣列，開機時 Ventoy 會顯示選單讓你挑。
|
||
|
||
**選單上的提示文字**：`ventoy.json` 可加一個 `menu_tip` 區塊，光標停在某個 ISO 時，畫面下方會顯示該 ISO 對應的一行說明（[Ventoy 文件](https://www.ventoy.net/en/plugin_menutip.html)）。本 repo 的 `ventoy.json` 範例已示範單一 tip；實機部署版本（見 `DEPLOY.md`）會對每個 ISO 寫明「自動安裝流程＋會清碟＋預設帳密」作為開機前最後提醒。`tip` 是單行的，不支援 `\n`。
|
||
|
||
驗證：USB 插上目標機開機 → Ventoy 選單選 ISO → 如果 `ventoy.json` 寫對，畫面會出現「Select Auto Install Template」→ 選 `unattend.xml`。
|
||
|
||
---
|
||
|
||
## 2. 先在 VM 試跑（強烈建議）
|
||
|
||
跳過這步 = 在真機上賭運氣。最關鍵的是驗證 `$$VT_WINDOWS_DISK_1ST_NONVTOY$$` 有沒有挑對磁碟。
|
||
|
||
### 最省事：直接把 Ventoy USB 傳入 VM
|
||
|
||
- **VirtualBox**（裝 Extension Pack）：VM 設定 → USB → 加上你的 Ventoy USB；開機順序把 USB 放最前。
|
||
- **VMware Workstation / Fusion**：VM → Removable Devices → 連接 Ventoy USB；BIOS 改開機順序。
|
||
- **QEMU**：`-drive file=/dev/diskN,format=raw,if=none,id=usb ...`（macOS 先 `diskutil unmountDisk`）。
|
||
|
||
VM 要 UEFI 開機、建議 ≥ 60 GB 虛擬硬碟（才能看到分割成功）、測試時可先關 Secure Boot。
|
||
|
||
### 另一種：用 Ventoy 的 VHD 模式
|
||
|
||
Ventoy 支援寫進 VHD/VDI，可直接掛進 Hyper-V / VirtualBox 當第一顆硬碟，不用實體 USB。細節看 Ventoy 官方文件「Install Ventoy to Local Disk」。
|
||
|
||
### 驗證重點
|
||
|
||
1. Ventoy 選單正確顯示 ISO
|
||
2. 選了 ISO 後有跳「Auto Install Template」選單
|
||
3. 安裝過程中**沒有跳語系或分割畫面**
|
||
4. 裝完後看 `C:\` 的磁碟編號 — 不是 Ventoy USB 的那顆
|
||
|
||
---
|
||
|
||
## 3. 跑起來會看到什麼
|
||
|
||
| 階段 | 畫面 | 時間 |
|
||
|---|---|---|
|
||
| WinPE 啟動 | Windows 標誌、載入條 | 30–60 秒 |
|
||
| 磁碟分割 + 映像展開 | 「正在安裝 Windows」百分比 | 5–15 分鐘 |
|
||
| 第一次重開 | 黑屏 → 「請稍候」 | 1–2 分鐘 |
|
||
| OOBE 略過 | **不該出現任何選單**；直接跳過 | 秒殺 |
|
||
| AutoLogon | 以 `Admin` 自動登入到桌面（顯示名稱是「Administrator」） | — |
|
||
| FirstLogonCommands | 閃過一連串 PowerShell / cmd 黑視窗（密碼永不過期、改主機名、建 `User` 帳號、從 USB 拷 Setup.ps1、跑 Setup.ps1 的 13 段 post-install） | 5–15 分鐘（含 FoD 下載、Win11Debloat 解壓、winget Chrome、AI 元件移除） |
|
||
| 重開機 | 5 秒倒數後重啟 | — |
|
||
| 第二次開機 | 看到登入畫面，有 `User` 一個選項（`Admin` 已被 SpecialAccounts 隱藏；輸入帳號名仍可登入） | — |
|
||
|
||
**正常就是全程不需要碰鍵盤滑鼠。** 如果中途卡在 OOBE 畫面要你選語系/建帳號 → 去看第 5 節除錯。
|
||
|
||
---
|
||
|
||
## 4. 部署後善後
|
||
|
||
第一次自動登入完成後，建議做這幾件事：
|
||
|
||
1. **刪除殘留的回應檔**（含明碼密碼）：
|
||
```powershell
|
||
Remove-Item C:\Windows\Panther\unattend.xml -Force -ErrorAction SilentlyContinue
|
||
Remove-Item C:\Windows\Panther\Unattend\unattend.xml -Force -ErrorAction SilentlyContinue
|
||
```
|
||
建議加到 `Setup.ps1` 結尾。
|
||
|
||
2. **關掉 AutoLogon**（本範本靠 `LogonCount=1` 會自動失效，驗證一下）：
|
||
```powershell
|
||
reg query "HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon" /v AutoAdminLogon
|
||
```
|
||
|
||
3. **改密碼**：範本的 `Admin/P@ssw0rd!` 和 `User/1234` 都是給自動化用的，上線前換掉。`User` 登入時會被強制改密，`Admin` 要自己 `net user Admin *` 改。
|
||
|
||
4. **看一下 FirstLogon / Setup log**：
|
||
```powershell
|
||
notepad C:\Windows\Temp\firstlogon-copysetup.log # Order 4：Setup.ps1 是否從 Ventoy USB 複製成功
|
||
notepad C:\Windows\Temp\firstlogon-runsetup.log # Order 5：Setup.ps1 找不到才會有此檔
|
||
notepad C:\Windows\Temp\setup.log # Setup.ps1 主 log，13 段每段都寫 START/DONE/ERR
|
||
```
|
||
找 `=== <name> ERR: ... ===` 行就是失敗段；`Setup.ps1` 每段都冪等，可以登入 `Admin` 後 `powershell -ExecutionPolicy Bypass -File C:\Scripts\Setup.ps1` 整支重跑，或挑特定段貼進視窗。
|
||
|
||
5. **驗證遠端管理可用**（從別台機器試）：
|
||
```bash
|
||
ping <機器 IP> # ICMP 應該回應
|
||
ssh Admin@<機器 IP> # OpenSSH 22/TCP，密碼 P@ssw0rd!（金鑰要先放 administrators_authorized_keys）
|
||
# RDP：用任何 RDP client 連 <機器 IP>:3389
|
||
# WinRM：5985（HTTP，AllowUnencrypted=true，TrustedHosts=*）
|
||
```
|
||
|
||
---
|
||
|
||
## 5. 除錯：沒跑完或卡住時
|
||
|
||
### 看日誌
|
||
|
||
Windows Setup 把所有 unattend 執行記錄放在：
|
||
|
||
| 階段 | 路徑 |
|
||
|---|---|
|
||
| WinPE | `X:\Windows\Panther\setupact.log`（WinPE 執行期間） |
|
||
| 安裝中 | `C:\Windows\Panther\setupact.log` |
|
||
| OOBE/Specialize | `C:\Windows\Panther\UnattendGC\setupact.log` |
|
||
| FirstLogonCommands 錯誤 | 開 Event Viewer → Windows Logs → Application |
|
||
|
||
Shift + F10 在任何安裝畫面會開出命令提示字元，可以 `notepad` 看 log。
|
||
|
||
### 常見錯誤
|
||
|
||
| 現象 | 原因 | 解法 |
|
||
|---|---|---|
|
||
| Ventoy 沒跳「Auto Install Template」選單 | `ventoy.json` 的 `image` 路徑對不上 ISO 實際路徑 | 路徑以 `/` 開頭、相對 USB 根目錄；或改用 fuzzy / `parent` 比對 |
|
||
| 跳了選單但跳過後仍停在選語系畫面 | `unattend.xml` 路徑錯誤或 XML schema 有誤 | 用 Windows SIM 驗證 XML；確認 `template` 指到的檔案真的存在 |
|
||
| 磁碟分割失敗或裝到 Ventoy USB 上 | `DiskID` 挑到 Ventoy USB | 確認用的是 `$$VT_WINDOWS_DISK_1ST_NONVTOY$$`，不是硬寫 `0`；多硬碟環境可改用 `$$VT_WINDOWS_DISK_MAX_SIZE$$` |
|
||
| 磁碟分割失敗（所有硬碟都試過） | 目標機是 BIOS/MBR | 改 `<DiskConfiguration>`：拿掉 EFI/MSR，用 MBR + System Reserved |
|
||
| `ProductKey` 錯誤 | 序號無效 | 改正確序號、用 KMS 通用金鑰、或刪掉整個 `<ProductKey>` 節點 |
|
||
| OOBE 沒略過 | Windows 版本不支援該欄位 | 比對當前版本 SIM 可用欄位 |
|
||
| FirstLogonCommands 沒跑 | `AutoLogon` 沒設或 `Order` 重複 | 確認 `AutoLogon.Enabled=true` 且 `Order` 不重複 |
|
||
| `Setup.ps1` 找不到（`firstlogon-copysetup.log` 寫 `NOT FOUND`） | Ventoy USB 太早被拔掉，或 `Setup.ps1` 沒 cp 到 `/ventoy/script/` | 等到第二次重開機進登入畫面後才拔；或重新 `cp Setup.ps1 /Volumes/Ventoy/ventoy/script/` |
|
||
| `Setup.ps1` 跑了但某段 ERR | 看 `C:\Windows\Temp\setup.log` 的 `=== <name> ERR: ... ===` | 修一修對應段，登入 `Admin` 後 `powershell -ExecutionPolicy Bypass -File C:\Scripts\Setup.ps1` 整支重跑 |
|
||
|
||
### 驗證 XML 語法
|
||
|
||
用 Windows SIM 開啟（會 schema-validate），或任何支援 XSD 的編輯器。
|
||
|
||
---
|
||
|
||
## 6. 下一步
|
||
|
||
- 讀 `README.md` 了解每個欄位在做什麼
|
||
- 看 `SUMMARY.md` 了解整體設計脈絡
|
||
- 改完記得 Commit 一份給自己留底
|