Initial commit: Windows unattend.xml 自動部署範本與文件
This commit is contained in:
151
QUICKSTART.md
Normal file
151
QUICKSTART.md
Normal file
@@ -0,0 +1,151 @@
|
||||
# QUICKSTART — 從零到自動安裝 Windows
|
||||
|
||||
照著做一次就能跑出一個「插上 USB → 自動裝完 Windows → 自動登入 → 跑 Setup.ps1 → 重開機」的流程。
|
||||
|
||||
> 預設情境：x64、UEFI+GPT、繁體中文、單一 Disk 0。
|
||||
|
||||
---
|
||||
|
||||
## 0. 事前準備
|
||||
|
||||
需要準備：
|
||||
|
||||
- [ ] Windows 10 或 11 官方 ISO（從 [microsoft.com](https://www.microsoft.com/software-download) 取得）
|
||||
- [ ] 一支 ≥ 8 GB 的 USB 隨身碟（會被格式化）
|
||||
- [ ] 一台測試機或 VM（強烈建議先在 VM 驗證）
|
||||
- [ ] 本專案的 `unattend.xml`
|
||||
|
||||
**編輯 `unattend.xml` 的必改項目：**
|
||||
|
||||
| 行為 | 原值 | 要改成 |
|
||||
|---|---|---|
|
||||
| 產品序號 | `XXXXX-XXXXX-XXXXX-XXXXX-XXXXX` | 你的序號，或 KMS 通用金鑰，或整個 `<ProductKey>` 節點刪掉 |
|
||||
| 管理員密碼 | `P@ssw0rd!`（兩處：`LocalAccount` 與 `AutoLogon`） | 你的密碼 |
|
||||
| 組織名 | `YourCompany` | 你的組織 |
|
||||
| 腳本路徑 | `C:\Scripts\Setup.ps1` | 留著或改路徑；不要執行就刪 `<SynchronousCommand Order=1>` |
|
||||
|
||||
---
|
||||
|
||||
## 1. 做一支自動安裝 USB
|
||||
|
||||
### 選項 A：Rufus（最快，Windows 原生）
|
||||
|
||||
1. 下載 [Rufus](https://rufus.ie/) 並開啟
|
||||
2. 選 ISO、選 USB、分割配置選 **GPT**、目標選 **UEFI**
|
||||
3. 按「開始」寫入
|
||||
4. 寫入完成後，把 `unattend.xml` **改名為 `autounattend.xml`** 放到 USB 根目錄
|
||||
|
||||
### 選項 B：macOS / Linux 手動方式
|
||||
|
||||
```bash
|
||||
# macOS：找到 USB
|
||||
diskutil list
|
||||
# 假設是 /dev/disk4
|
||||
diskutil eraseDisk MS-DOS "WINUSB" GPT /dev/disk4
|
||||
|
||||
# 掛載 ISO 並複製
|
||||
hdiutil mount Windows.iso
|
||||
cp -R /Volumes/CCCOMA_X64FRE_ZH-TW_DV9/* /Volumes/WINUSB/
|
||||
|
||||
# 放入 autounattend.xml
|
||||
cp unattend.xml /Volumes/WINUSB/autounattend.xml
|
||||
```
|
||||
|
||||
> Linux 用 `wimlib-imagex split` 處理超過 FAT32 4GB 限制的 `install.wim`。
|
||||
|
||||
---
|
||||
|
||||
## 2. 先在 VM 試跑（強烈建議）
|
||||
|
||||
跳過這步 = 在真機上賭運氣。
|
||||
|
||||
### Hyper-V
|
||||
|
||||
```powershell
|
||||
New-VM -Name "WinTest" -Generation 2 -MemoryStartupBytes 4GB -NewVHDPath "C:\VM\WinTest.vhdx" -NewVHDSizeBytes 60GB
|
||||
Set-VMDvdDrive -VMName "WinTest" -Path "C:\ISO\Windows.iso"
|
||||
Set-VMFirmware -VMName "WinTest" -EnableSecureBoot Off # 測試期間關掉比較省事
|
||||
Start-VM "WinTest"
|
||||
```
|
||||
|
||||
把 `autounattend.xml` 注入 ISO：用 [AnyBurn](https://www.anyburn.com/) / `oscdimg` 在 ISO 根目錄加入該檔，或在 VM 掛第二顆 CD。
|
||||
|
||||
### VirtualBox / VMware
|
||||
|
||||
建一台 UEFI 開機的 VM，掛改好的 ISO 開機即可。
|
||||
|
||||
---
|
||||
|
||||
## 3. 跑起來會看到什麼
|
||||
|
||||
| 階段 | 畫面 | 時間 |
|
||||
|---|---|---|
|
||||
| WinPE 啟動 | Windows 標誌、載入條 | 30–60 秒 |
|
||||
| 磁碟分割 + 映像展開 | 「正在安裝 Windows」百分比 | 5–15 分鐘 |
|
||||
| 第一次重開 | 黑屏 → 「請稍候」 | 1–2 分鐘 |
|
||||
| OOBE 略過 | **不該出現任何選單**；直接跳過 | 秒殺 |
|
||||
| AutoLogon | 以 `Admin` 自動登入到桌面 | — |
|
||||
| FirstLogonCommands | 閃出 PowerShell 視窗跑 `Setup.ps1` | 看腳本內容 |
|
||||
| 重開機 | 5 秒倒數後重啟 | — |
|
||||
|
||||
**正常就是全程不需要碰鍵盤滑鼠。** 如果中途卡在 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. **改密碼**：範本密碼 `P@ssw0rd!` 是給自動化用的，上線前換掉。
|
||||
|
||||
---
|
||||
|
||||
## 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。
|
||||
|
||||
### 常見錯誤
|
||||
|
||||
| 現象 | 原因 | 解法 |
|
||||
|---|---|---|
|
||||
| 停在選語系畫面 | `autounattend.xml` 沒讀到 | 檔名拼錯/不在根目錄；確認 USB 格式 FAT32 |
|
||||
| 磁碟分割失敗 | 目標機是 BIOS/MBR | 改 `<DiskConfiguration>`：拿掉 EFI/MSR，用 MBR + System Reserved |
|
||||
| `ProductKey` 錯誤 | 序號無效 | 改正確序號、用 KMS 通用金鑰、或刪掉整個 `<ProductKey>` 節點 |
|
||||
| OOBE 沒略過 | Windows 版本不支援該欄位 | 比對當前版本 SIM 可用欄位 |
|
||||
| FirstLogonCommands 沒跑 | `AutoLogon` 沒設或 `Order` 重複 | 確認 `AutoLogon.Enabled=true` 且 `Order` 不重複 |
|
||||
| `Setup.ps1` 找不到 | 路徑不存在 | 先用其他方式把腳本放到 `C:\Scripts\`，或改用 `FirstLogonCommands` 從 USB 複製 |
|
||||
|
||||
### 驗證 XML 語法
|
||||
|
||||
用 Windows SIM 開啟（會 schema-validate），或任何支援 XSD 的編輯器。
|
||||
|
||||
---
|
||||
|
||||
## 6. 下一步
|
||||
|
||||
- 讀 `README.md` 了解每個欄位在做什麼
|
||||
- 看 `SUMMARY.md` 了解整體設計脈絡
|
||||
- 改完記得 Commit 一份給自己留底
|
||||
Reference in New Issue
Block a user