如果您管理 Azure Virtual Desktop,您就與 FSLogix 問題搏鬥過。無法附加的設定檔容器。登入時崩潰的開始功能表。讓使用者盯著空白而服務台佇列填滿的黑畫面。鎖定 VHD 並級聯至下一位使用者工作階段的登出懸停。

每位 AVD 管理員都經歷過。問題不是缺乏文件——Microsoft 的 FSLogix 文件很詳盡。問題在於當 P1 在上午 8:47 降臨且 200 位使用者無法工作時,您需要的是結構化流程,而非文件中樞。

這就是我們建立並開源 FSLogix 疑難排解 Runbook 範本 的原因。

為何需要 Runbook 範本?

大多數組織以相同方式疑難排解 FSLogix:某個具備部落知識的人修好它,而沒人寫下他做了什麼。當那個人度假時,下一次事件花三倍時間。

runbook 改變了這一點。它給每個支援層級——L1 到 L3——一個可重複、證據優先的工作流程。它標準化日誌收集、診斷與補救,讓修正不依賴誰在值班。

我們在數月的真實 AVD 交付中建構了我們的,然後決定開源,讓其他團隊可將其作為自身流程的起點。

Runbook 內容

此範本是一份單一的綜合 markdown 檔案(約 2,300 行),具內嵌 Mermaid 圖表可直接在 GitHub 上呈現。它設計為被 fork、客製化至您的環境,並作為活的營運文件使用。

事件分類與決策矩陣

快速參考查詢表將症狀對應至動作。對每個症狀(開始功能表崩潰、黑畫面、explorer 迴圈、大量中斷),它按優先順序給出三個動作與明確的升級觸發條件。L1/L2 技術員無需閱讀完整文件即可開始解決。

診斷工作流程

視覺流程圖(Mermaid)帶您走過決策樹:

  1. 範圍——單一使用者或全池?
  2. FSLogix 附加狀態——容器是否掛載?
  3. 分支——若附加失敗,診斷基礎結構(儲存、權限、AV、驗證)。若附加成功,診斷設定檔/AppX/shell 層。
  4. 補救 → 驗證 → 記錄

補救劇本

每個劇本針對特定根本原因並含精確命令:

  • 鎖定的 VHD——尋找並關閉 SMB 控制代碼(在地端 Get-SmbOpenFile 與 Azure Files Close-AzStorageFileHandle),啟用 CleanupInvalidSessions,調整重試設定。
  • 權限——Microsoft 建議的 icacls ACL、Azure RBAC 指派、AccessNetworkAsComputerObject 警告。
  • Azure AD Kerberos 失敗——klist 驗證、儲存帳戶驗證設定、條件式存取干擾診斷、Debug-AzStorageAccountAuth 使用。
  • 容器已滿——SizeInMBs 擴充、空間消費者分析、壓實驗證。
  • AV/EDR 干擾——完整排除清單(程序、驅動程式、路徑、副檔名)、Defender PowerShell 命令、Intune 部署指導。
  • 開始功能表/AppX 失敗——崩潰事件關聯、套件重新註冊、InstallAppxPackages 驗證、AppLocker 檢查。
  • 登出懸停——控制代碼識別、程序特定補救(SearchHost、OneDrive、Defender)、CleanupInvalidSessions。
  • Cloud Cache 失敗——服務診斷、本機磁碟 sizing、提供者同步驗證、split-brain 恢復。
  • 設定檔損壞——決策樹(修復 vs. 重建 vs. 還原)、chkdsk、登錄 hive 修復、備份模式。
  • MSIX App Attach 衝突、Citrix 共存、Windows Update 回歸、儲存後端間的設定檔遷移。

自動化指令稿

  • 案例包收集器——一個 PowerShell 指令稿,將 FSLogix 日誌、事件日誌、登錄匯出、網路診斷、Kerberos 狀態與設定檔狀態收集到 zip 檔案中以供升級。
  • 健康檢查指令稿——透過 Intune Proactive Remediations 或排程工作部署,以持續驗證 FSLogix 服務狀態、AV 排除、儲存連線與錯誤率。
  • 針對性分類查詢——快速 PowerShell 單行命令以找出 shell 崩潰、設定檔服務錯誤與孤兒設定檔。

針對 Azure Monitor 的 KQL 查詢

Log Analytics 的預建查詢:

  • 依主機的 FSLogix 附加失敗計數
  • 設定檔載入時間趨勢(平均、最大、依小時 P95)
  • 暫時設定檔建立事件
  • 開始功能表/shell 崩潰關聯

加上建議的警示設定表(儲存容量、延遲、IOPS 節流、FSLogix 錯誤、暫時設定檔)。

營運框架

除了疑難排解,runbook 包含:

  • 嚴重度分類矩陣含 SLA 目標
  • 已知良好基準——載入時間、容器大小、儲存延遲與錯誤率的參考值
  • 容量規劃——IOPS 估算表、Cloud Cache 磁碟 sizing 公式、儲存成長預測
  • Redirections.xml 指導——附註的安全排除與您絕不可排除的路徑「危險排除」表
  • 部署檢查清單——16 點上線前驗證
  • DR 程序——Azure Files 軟刪除、快照恢復、ANF 故障轉移、恢復決策矩陣
  • 升級路徑——何時升級、向誰、帶什麼成品
  • 使用者溝通範本——中斷通知與自助指導
  • 劇本演練日誌——追蹤哪些劇本已測試及何時

誰應使用此 Runbook

  • AVD 管理員想要結構化疑難排解流程而非臨時修正
  • **支援團隊(L1–L3)**需要跨所有技能級別一致、可重複的工作流程
  • AVD 架構師設計新部署想要預建營運框架
  • MSP 與顧問為多個客戶管理 AVD 並需要可重複使用的範本

此 runbook 刻意以範本撰寫。Fork 它,以您的環境特定值(儲存路徑、群組名稱、SLA 目標)取代佔位值,並為您的工具客製化劇本。

我們如何建構它

此 runbook 透過真實 AVD 交付與 AI 輔助工程工作流程的結合開發。我們使用 AI 編碼代理加速研究、交叉參考 Microsoft 文件、產生 PowerShell 指令稿,並建構 KQL 查詢——然後針對生產環境驗證一切。

結果是一份手動編譯要花數週的文件,在數天內交付。這是小團隊需要的力量倍增,讓他們在企業 IT 中以小搏大。

取得 Runbook

完整 runbook 免費且開源於 GitHub:

→ Big-Hat-Group-Inc/FSLogixRunbookTemplate

Fork 它。客製化它。將它作為您 AVD 支援流程的基礎。如果您發現問題或想貢獻改善,歡迎 pull request。

如果您的團隊需要協助建構 AVD 營運流程、優化 FSLogix 效能,或設計具韌性的設定檔儲存——與我們聯繫。這就是我們做的事。

Big Hat Group 協助企業設計、部署與營運 Microsoft 雲端基礎結構——包括 Azure Virtual Desktop、Windows 365,以及讓 IT 團隊更有效的 AI 驅動工具。了解更多關於我們的服務。