win-remote-toolkit/README.md

Windows Remote Toolkit

A comprehensive remote management toolkit for configuring and managing Windows machines from macOS/Linux systems via SSH and WinRM.

🛠️ 腳本功能參考

系統配置類

activate-windows.sh

透過 KMS 啟用 Windows 授權

./scripts/ssh/activate-windows.sh

firewall-allow-ssh.sh

在 Windows 防火牆中建立永久的 SSH 存取規則

./scripts/ssh/firewall-allow-ssh.sh

• 建立跨所有防火牆設定檔的入站規則
• 確保重啟後 SSH 連線仍可用

win11debloat.sh

執行 Win11Debloat 腳本移除膨脹軟體並停用遙測

./scripts/ssh/win11debloat.sh

• 使用 config/win11debloat-config.json 配置
• 支援 MODE=Apply|Revert 環境變數

remove-windows-ai.sh

移除 Windows AI/Copilot 組件

./scripts/ssh/remove-windows-ai.sh
MODE=Apply ./scripts/ssh/remove-windows-ai.sh    # 套用移除
MODE=Revert ./scripts/ssh/remove-windows-ai.sh   # 還原變更

連線管理類

enable-winrm.sh

配置 WinRM 服務用於快速連線

./scripts/ssh/enable-winrm.sh

test-winrm-connection.sh

測試 WinRM 連線狀態

./scripts/ssh/test-winrm-connection.sh

check-winrm.sh

檢查 WinRM 服務配置

./scripts/ssh/check-winrm.sh

應用程式管理類

install-apps.sh

批次安裝常用應用程式

./scripts/ssh/install-apps.sh

remove-apps.sh

批次移除指定應用程式

./scripts/ssh/remove-apps.sh

• 使用 config/remove-apps-config.json 配置

install-thunderbird.sh

安裝 Mozilla Thunderbird

./scripts/ssh/install-thunderbird.sh

setup-thunderbird.sh

配置 Thunderbird 電子郵件帳戶

./scripts/ssh/setup-thunderbird.sh

• 使用 config/thunderbird-config.json 配置
• 支援多種電子郵件提供商

install-telegram.sh

安裝 Telegram Desktop（per-user 安裝）

./scripts/ssh/install-telegram.sh

install-nirsoft.sh

安裝 NirSoft 診斷工具集

./scripts/ssh/install-nirsoft.sh

install-cports.sh

安裝 CurrPorts 網路連線監控工具

./scripts/ssh/install-cports.sh

診斷類

recon.sh

完整系統偵察（15 個資訊區塊）

./scripts/ssh/recon.sh

• 硬體資訊、網路配置、軟體清單等
• 輸出儲存到 logs/ 目錄

nirsoft-dump.sh

使用 NirSoft 工具進行系統診斷並打包結果

./scripts/ssh/nirsoft-dump.sh

• 輸出 ZIP 檔案到 dumps/ 目錄

verify-debloat.sh

驗證 Win11Debloat 變更是否已套用

./scripts/ssh/verify-debloat.sh

verify-ai-removed.sh

驗證 Windows AI 組件是否已移除

./scripts/ssh/verify-ai-removed.sh

使用者管理類

rename-hide-accounts.sh

重新命名或隱藏系統帳戶

./scripts/ssh/rename-hide-accounts.sh

• ⚠️ 風險操作：建議最後執行

apply-ui-to-user.sh

將 UI 設定套用到指定使用者

TARGET_USER=username ./scripts/ssh/apply-ui-to-user.sh

輸入法配置

configure-ime.sh

配置中文輸入法設定

./scripts/ssh/configure-ime.sh

🚀 快速執行包裝器

SSH 方法（預設）

./ssh_run.sh <script.ps1>           # 執行單一 PowerShell 腳本

WinRM 方法（更快）

./winrm_run.sh <script.ps1>         # WinRM 執行
python3 scripts/winrm/smart_executor.py <script.ps1>  # 智慧選擇連線方法

⚙️ 環境變數覆寫

所有腳本支援連線參數覆寫：

HOST=192.168.x.x USER_NAME=admin PASS='secret' ./scripts/ssh/recon.sh
MODE=Apply ./scripts/ssh/remove-windows-ai.sh
TARGET_USER=someone ./scripts/ssh/apply-ui-to-user.sh

📋 配置檔案

檔案	用途
config/win11debloat-config.json	Win11Debloat 操作設定
config/thunderbird-config.json	電子郵件帳戶配置
config/remove-apps-config.json	應用程式移除清單
config/nirsoft-config.json	NirSoft 工具下載設定

📁 輸出目錄

• logs/ - 執行日誌（帶時間戳）
• dumps/ - 診斷資料 ZIP 檔案

🎯 預設連線目標

• 主機：192.168.88.112 (PC-74269)
• 使用者：Admin
• 密碼：P@ssw0rd!

可透過環境變數覆寫連線參數。

---

更多詳細資訊請參考：

• QUICKSTART.md - 安裝與操作指南
• SUMMARY.md - 設計理念與架構說明
• CLAUDE.md - 完整技術文檔