Azure Virtual Desktopを管理しているなら、FSLogixの問題と戦ったことがあるだろう。アタッチされないプロファイルコンテナ。ログイン時にクラッシュするスタートメニュー。ヘルプデスクのキューが埋まる間、ユーザーが何もない画面を見つめる黒い画面。VHDをロックし、次のユーザーのセッションに連鎖するサインアウトハング。

すべてのAVD管理者がそこにいた。問題はドキュメントの欠如ではない — MicrosoftのFSLogIXドキュメントは徹底している。問題は、P1が午前8:47にヒットし200人のユーザーが作業できないとき、ドキュメントハブではなく構造化されたプロセスが必要だということだ。

だからこそFSLogix Troubleshooting Runbook Templateを構築しオープンソース化した。

なぜランブックテンプレートなのか?

ほとんどの組織は同じようにFSLogixをトラブルシュートする: 暗黙知を持つ誰かが直し、その人が何をしたかを誰も書き留めない。その人が休暇のとき、次のインシデントは3倍の時間がかかる。

ランブックはそれを変える。サポートのすべてのティア — L1からL3まで — に再現可能で証拠ファーストのワークフローを与える。ログ収集、診断、修復を標準化し、修正が誰がオンコールかによらないようにする。

当社は何ヶ月にもわたる実世界のAVDエンゲージメントを通じてこれを構築し、他のチームが自身のプロセスの出発点として使えるようオープンソース化した。

ランブックの中身

テンプレートはインラインMermaidダイアグラムを含む単一の包括的なmarkdownファイル（約2,300行）で、GitHubで直接レンダリングされる。フォークし、環境に合わせてカスタマイズし、生きた運用ドキュメントとして使用するよう設計されている。

インシデントトリアージ & 決定マトリクス

クイックリファレンスのルックアップテーブルが症状をアクションにマッピングする。各症状（スタートメニューのクラッシュ、黒い画面、explorerのループ、大規模障害）について、優先順位で3つのアクションと明確なエスカレーショントリガーを与える。L1/L2技術者は全文を読まずに解決を開始できる。

診断ワークフロー

ビジュアルフローチャート（Mermaid）が決定ツリーを歩む:

  1. スコープ — 単一ユーザーかプール全体か?
  2. FSLogixアタッチ状態 — コンテナはマウントされたか?
  3. 分岐 — アタッチが失敗した場合、インフラを診断（ストレージ、権限、AV、認証）。アタッチが成功した場合、プロファイル/AppX/シェルレイヤーを診断。
  4. 修復 → 検証 → 文書化

修復プレイブック

各プレイブックは正確なコマンドで特定の根本原因を狙う:

  • ロックされたVHD — SMBハンドルを見つけて閉じる（オンプレミスGet-SmbOpenFileとAzure FilesClose-AzStorageFileHandle）、CleanupInvalidSessionsの有効化、再試行設定のチューニング。
  • 権限 — Microsoft推奨のicaclsACL、Azure RBAC割り当て、AccessNetworkAsComputerObjectの警告。
  • Azure AD Kerberos失敗 — klist検証、ストレージアカウント認証構成、Conditional Access干渉診断、Debug-AzStorageAccountAuthの使用。
  • コンテナ満杯 — SizeInMBs拡張、スペース消費者分析、コンパクション検証。
  • AV/EDR干渉 — 完全な除外リスト（プロセス、ドライバ、パス、拡張子）、Defender PowerShellコマンド、Intuneデプロイガイダンス。
  • スタートメニュー / AppX失敗 — クラッシュイベント相関、パッケージ再登録、InstallAppxPackages検証、AppLockerチェック。
  • サインアウトハング — ハンドル識別、プロセス固有の修復（SearchHost、OneDrive、Defender）、CleanupInvalidSessions。
  • Cloud Cache失敗 — サービス診断、ローカルディスクサイジング、プロバイダ同期検証、スプリットブレイン復旧。
  • プロファイル破損 — 決定ツリー（修復 vs 再作成 vs 復元）、chkdsk、レジストリハイブ修復、バックアップパターン。
  • MSIX App Attachの競合、Citrix共存、Windows Updateのリグレッション、ストレージバックエンド間のプロファイル移行。

自動化スクリプト

  • ケースバンドルコレクタ — FSLogixログ、イベントログ、レジストリエクスポート、ネットワーク診断、Kerberos状態、プロファイル状態をエスカレーション用のzipファイルに収集する単一のPowerShellスクリプト。
  • ヘルスチェックスクリプト — Intune Proactive Remediationsまたはスケジュールタスク経由でデプロイし、FSLogixサービス状態、AV除外、ストレージ接続性、エラー率を継続的に検証。
  • 的を絞ったトリアージクエリ — シェルクラッシュ、プロファイルサービスエラー、孤児化プロファイルを見つけるクイックPowerShellワンライナー。

Azure Monitor向けKQLクエリ

Log Analytics用の事前構築クエリ:

  • ホスト別FSLogixアタッチ失敗数
  • プロファイルロード時間の傾向（平均、最大、時間別P95）
  • 一時プロファイル作成イベント
  • スタートメニュー / シェルクラッシュの相関

さらに推奨されるアラート構成テーブル（ストレージ容量、レイテンシ、IOPSスロットリング、FSLogixエラー、一時プロファイル）。

運用フレームワーク

トラブルシューティングを超えて、ランブックは以下を含む:

  • SLA目標付きの重要度分類マトリクス
  • 既知の良好なベースライン — ロード時間、コンテナサイズ、ストレージレイテンシ、エラー率の参照値
  • 容量計画 — IOPS推定テーブル、Cloud Cacheディスクサイジング式、ストレージ成長予測
  • Redirections.xmlガイダンス — 注釈付きの安全な除外と、決して除外してはならないパスの「危険な除外」テーブル
  • デプロイチェックリスト — 16項目の本番移行前検証
  • DR手順 — Azure Filesの論理削除、スナップショットリカバリ、ANFフェイルオーバー、リカバリ決定マトリクス
  • エスカレーションパス — いつ、誰に、どのアーティファクトとともにエスカレートするか
  • ユーザーコミュニケーションテンプレート — 障害通知とセルフサービスガイダンス
  • プレイブック演習ログ — どのプレイブックがいつテストされたかを追跡

これを使うべき人

  • アドホックな修正ではなく構造化されたトラブルシューティングプロセスを望むAVD管理者
  • すべてのスキルレベルで一貫した再現可能なワークフローが必要なサポートチーム（L1〜L3）
  • 事前構築された運用フレームワークを望む新しいデプロイを設計するAVDアーキテクト
  • 複数のクライアント向けにAVDを管理し再利用可能なテンプレートが必要なMSPやコンサルタント

ランブックは意図的にテンプレートとして書かれている。フォークし、プレースホルダー値を環境の詳細（ストレージパス、グループ名、SLA目標）で置き換え、ツールに合わせてプレイブックをカスタマイズする。

どう構築したか

このランブックは実世界のAVDエンゲージメントとAI支援エンジニアリングワークフローの組み合わせで開発した。AIコーディングエージェントを使って研究を加速し、Microsoftのドキュメントを相互参照し、PowerShellスクリプトを生成し、KQLクエリを構築した — その後すべてを本番環境に対して検証した。

結果は手動で何週間もかかるはずのドキュメントが数日で届けられた。これはエンタープライズITで実力以上の力を発揮するために小規模チームが必要とする戦力倍増だ。

ランブックを入手

完全なランブックはGitHubで無料・オープンソース:

→ Big-Hat-Group-Inc/FSLogixRunbookTemplate

フォークし、カスタマイズし、AVDサポートプロセスの基盤として使用してほしい。問題を見つけたり改善の寄稿を望む場合は、プルリクエストを歓迎する。

チームがAVD運用プロセスの構築、FSLogixパフォーマンスの最適化、または回復力のあるプロファイルストレージの設計に支援が必要な場合は、お問い合わせください。これが当社の専門分野だ。

Big Hat GroupはエンタープライズがMicrosoftクラウドインフラを設計、デプロイ、運用するのを支援する — Azure Virtual Desktop、Windows 365、そしてITチームをより効果的にするAI搭載ツーリングを含む。当社のサービスについて詳しく。