セッション ホストのパッチ適用とメンテナンスにドレイン モードを使う方法
パートナー · 中立的なパートナー: Nerdio
By Mirko Peters ·
Azure Virtual Desktop のセッション ホストを 1 台停止するためのランブック(運用手順書)です。自動スケールから除外し、ドレイン モードを有効にして、残りのセッションにメッセージを送ってから終了させます。作業を行った後、ドレイン モードを無効にします。
Automatically translated with AI from the original post. Read the English original
ユーザーを切断せずに 1 台のセッション ホストにパッチを適用するには、自動スケールの対象から外れるように VM にタグを付けます。次にドレイン モードを有効にし、残りのユーザーにメッセージと期限を伝えます。残っているセッションを終了させてから、パッチを適用して再起動し、最後にドレイン モードを無効にします。
重要なポイント
- ドレイン モードは、ホスト上で新しいセッションが開始されないようにします。既存のセッションは、ユーザーがサインアウトするか、管理者が終了させるまで残ります。
- プール内にアクティブまたは切断状態のセッションを持つユーザーは、ドレイン モードでも同じホストに振り分けられます。そのため、パッチを適用する前に、セッションを一覧表示して終了させてください。
- プール化されたホスト プールでは、自動スケールは対象となるすべての VM でドレイン モードより優先されます。そのため、先にスケーリング プランの除外タグを設定してください。個人用プールでは、自動スケールはドレイン モードを設定しません。
- ドレイン モードには Desktop Virtualization Session Host Operator ロールが必要です。メッセージの送信とユーザーのサインアウトには User Session Operator ロールが必要です。ランブック用アカウントの有効なアクセス許可を確認してください。
- イメージ ベースでセッション ホスト構成を使用しているホストを更新する場合、セッション ホストの更新機能がドレイン モードを自動的に処理します。Microsoft Learn では、更新中にドレイン モードを手動で変更しないよう案内されています。
この記事は、1 台のホストを対象としたランブックです。ドレイン モードの概要は「Drain mode in Azure Virtual Desktop explained」で扱っています。ホスト プール全体でウェーブのサイズや容量を計画する方法は「Patching AVD without downtime: rolling updates with drain mode」がテーマです。除外タグの仕組みと適用方法は「How to use the exclusion tag for maintenance windows and special session hosts」にまとめられています。
始める前に必要なもの
- ロール。 Microsoft Learn によると、ドレイン モードを有効または無効にするには Desktop Virtualization Session Host Operator ロールが必要です。RBAC のページでは、このロールがセッション ホストの表示と削除、およびドレイン モードの変更を行えると説明されています。メッセージの送信、セッションの切断、ユーザーのサインアウトは Desktop Virtualization User Session Operator ロールの対象です。RBAC のページでは、このロールではドレイン モードを変更できないとされています。Session Host Operator ロールの組み込み定義には
Microsoft.DesktopVirtualization/hostpools/sessionhosts/が含まれ、User Session Operator の定義では.../sessionhosts/usersessions/が明示的に含まれています。そのため、1 つのアカウントで両方の操作ができるかどうかは、実際に割り当てられているロールによって決まります。ランブックを実行するアカウントでテストしてください。 - Azure PowerShell(Az.DesktopVirtualization モジュールを使用)、またはスクリプト化したい場合は Azure Cloud Shell。
- 容量。 Microsoft Learn によると、新しい接続は次に使用可能なセッション ホストに振り分けられます。そのため、残りのホストで負荷を処理できるか確認してください。深さ優先のプールの場合は、最大セッション数の上限も確認してください。Learn によると、すべてのホストが上限に達すると、上限を引き上げるかホストを追加する必要があります。
手順
- プールされたホストプールでは、オートスケールからホストを除外します。 Learn のシナリオのページには、プールされたホストプールの場合、オートスケールがドレインモードを上書きすると書かれています。また、オートスケールの FAQ では、誰がドレインモードにしたかに関係なく、スケーリング対象のすべての VM でドレインモードを上書きするため、ドレインされた VM のオン・オフをオートスケールが引き続き切り替えると説明されています。除外タグは、スケーリング プランの [基本] タブ(既存のプランの場合は [プロパティ] タブ)で入力するタグ名です。Learn の例では
excludeFromScalingが使われています。このフィールドは、電源管理プランと動的プランで使用できます。動的プランは、セッション ホストの構成があるプールされたホストプールにのみ適用されます。セッション ホストにこのタグがあると、オートスケールはそのホストの起動、停止、ドレインモードの変更を行いません。VM に同じ名前のタグを追加してください。タグのアクセス許可や詳細は、上記の除外タグの記事を参照してください。個人用ホストプールについては、後のセクションを参照してください。 - ドレインモードをオンにします。 Azure portal で Azure Virtual Desktop、ホスト プール の順に開き、ホスト プールを選択して、セッション ホスト を選択します。ホストにチェックを入れ、ドレイン モードをオンにする を選択します。Azure PowerShell では、Learn のドレインモードのページに従い、
Update-AzWvdSessionHostのAllowNewSessionパラメーターでドレインモードを設定します。セッション ホストごとに 1 回ずつ実行します。このページでは$paramsのハッシュ テーブルにAllowNewSession = $Falseを設定し、それをコマンドレットにスプラットしています。コマンドレット リファレンスの例と同じ形式で 1 つのブロックにまとめると、次のようになります。
Update-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> `
-Name <SessionHostName> `
-AllowNewSession:$falseLearn では、更新直後にポータルの状態が実際と一致しないことがあると注意しています。まず 60 秒以上待ってください。
- ホストに残っているセッションを一覧表示します。
Get-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName>Learn の出力例では、各セッションは HostPoolName/SessionHostName/2 の形式で表示されます。また、Remove-AzWvdUserSession のリファレンスでは、セッション番号を -Id(エイリアス UserSessionId)で指定します。そのため、名前の最後の部分をセッション ID として使用してください。
- ユーザーに警告します。 Learn のリファレンスには、メッセージのタイトルと本文を自由形式のテキストで指定する次の形式が示されています。
Send-AzWvdUserSessionMessage -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName> `
-UserSessionId <id> -MessageTitle 'Maintenance' `
-MessageBody 'Please save your work and sign out. This host is patched at 18:30.'守ることができる期限を設定してください。
- 残りのセッションを終了します。 期限を過ぎたら、残っているセッションを削除します。
Remove-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName> -Id <id>リファレンス ページには -Force パラメーター(「userSession の削除を強制するには指定します」)もありますが、これを使った例は示されていません。セッションを削除するとそのセッションは終了するため、ユーザーが保存していない内容は失われます。そのため、手順 4 を先に行う必要があります。
- メンテナンスを実施します。 Learn によると、セッションが残っていなければ必要なメンテナンスを実施でき、管理者は Azure Virtual Desktop サービスを経由せずに、引き続きサーバーに直接接続できます。Windows Update、Intune、WSUS などの別のツールによるパッチ適用自体は、この記事の対象外です。ただし、お使いのオペレーティング システムに対して Learn がインプレース パッチ適用をどう評価しているかを、事前に確認してください(最後のセクションを参照)。その後ホストが利用可能に戻らない場合は、関連記事「Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist」のチェックリストを使用してください。
- ドレインモードをオフにします。 ポータルでホストにチェックを入れ、ドレイン モードをオフにする を選択します。PowerShell では、同じコマンドレットに
-AllowNewSession:$trueを付けて実行します。Learn のドレインモードのページには両方向が示されており、ドレインモードをオンにするには$False、オフにするには$Trueを指定します。ポータルで状態を確認する前に、60 秒以上待ってください。その後、除外タグを削除すると、オートスケールがそのホストを再び管理します。
意外に感じられる動作
- 切断されたセッションは元に戻ります。 Learn のロード バランシングのページによると、アクティブまたは切断状態のセッションを持つユーザーが再度サインインすると、ドレインモードであっても、そのセッションがあるホストに接続されます。セッションを持たないユーザーが、ドレイン中のホストに振り分けられることはありません。このため手順 3 が重要です。一見空に見えるホストでも、切断されたセッションが残っている場合があります。
- タグのないプールされたホストは、引き続きスケーリングの対象です。 プールされたホストプールのホストを手動でドレインし、タグを付けなかった場合、FAQ によると、オートスケールはそのホストの起動、停止、ドレインモードの変更を引き続き行うことがあります。ホストをスケーリングから外すのはドレインモードではなく、タグです。
- 保存されていない作業は失われます。
Remove-AzWvdUserSessionはセッションを終了します。Learn のリファレンスには、セッションを復旧する方法は記載されていません。そのため、手順 4 のメッセージ送信を先に行ってください。 - タグが残っていると、ホストはスケーリングの対象から外れたままになります。 Learn によると、タグが付いたホストは最小ホスト割合の計算には含まれたままですが、autoscale は起動しません。手順 7 でタグを削除してください。タグが残っている間は、プールに容量が必要な場合でも autoscale はそのホストを起動しません。Learn のシナリオ 4 では、プール内のすべてのホストにタグが付き電源がオフになっていると、ユーザーに「No resources available」と表示されることが説明されています。
1 台のホストの作業タイムラインの例
以下の時刻は説明のための仮の値であり、Microsoft の推奨ではありません。対象は、平日の夕方にパッチを適用するプール化されたホスト avd-host-03 1 台です。
| 時間 | アクション |
|---|---|
| 17:30 | VM にタグを付け、ドレイン モードを有効にし、セッションを一覧表示します(手順 1 から 3)。 |
| 17:35 | 残っている各セッションにメッセージを送信します。作業を保存してサインアウトしてください、ホストは 18:30 にパッチ適用されます(手順 4)。 |
| 18:30 | 切断されたセッションを含め、残っているセッションを削除します(手順 5)。 |
| 18:35 | 更新プログラムをインストールして再起動します(手順 6)。 |
| 19:15 | ホストが利用可能と報告されていることを確認し、ドレイン モードを無効にして、タグを削除します(手順 7)。 |
開始する前に、他のホストで夕方の負荷を処理できることを確認してください。ローリング更新に関する関連記事では、一度に停止するホストの台数について説明しています。
個人用ホスト プール
Learn の FAQ によると、autoscale は個人用デスクトップを割り当て解除する前にドレイン モードに設定することはありません。割り当て解除中に接続したユーザーには「No resources available」と表示されます。また FAQ には、autoscale、Start VM on Connect、または管理者によってセッション ホストが起動され、誰もサインインしない場合、autoscale は非アクティブ期間の経過後にそのホストを割り当て解除することも記載されています。ただし、その期間はページで定義されていません。これはスケーリング プランがあるプールで影響します。ユーザーがサインインしていない状態でパッチ適用のために起動した個人ホストが、作業中に割り当て解除される可能性があります。Learn では、電源管理プランの除外タグ フィールドについて、プール化されたホスト プールに限定されない形で説明されていますが、個人用ホスト プールでの効果は明記されていません。そのため、VM を起動する前に個人ホストにタグを付けることは、本記事が提案する予防策であり、文書化された保証ではありません。テスト用ホストで確認してください。個人用セッション ホストは 1 人のユーザーに割り当てられているため、そのユーザーにも必ず連絡してください。
ドレイン モードが適さない場合
Learn のセッション ホストの更新方法に関するページでは、OS ごとにその場でのパッチ適用が評価されています。Windows クライアントのマルチセッション ホストでは、Windows Update は月次更新と機能更新について「Not recommended」、WSUS は機能更新について「Not recommended」と示されており、セッション ホストの更新と Azure Compute Gallery は「Recommended」と示されています。Windows Server では、Windows Update が「Supported」、Azure Update Manager と自動ゲスト パッチ適用が「Recommended」と示されています。Windows クライアント Enterprise(シングルセッション)では、Windows Update が「Recommended」とされていますが、このタイプのプール化されたホスト プールは「Not recommended」とされています。同じページのパッチ適用の段落では、一般的な技術として Windows Update が挙げられているため、その一文だけでなく、システムごとの表を確認してください。私たちの解釈では、この Runbook は Windows Server ホスト、個人用ホスト、および構成変更、再起動、トラブルシューティング、ホストの廃止など、パッチ適用以外のメンテナンスに適しています。プール化された Windows クライアント マルチセッションのプールについては、Learn はイメージベースのサービシングを推奨しています。
イメージを置き換える方法で更新する場合(パッチをその場で適用するのではなく)、セッション構成を使用しているホストであれば、Learn のセッション ホストの更新機能が作業を行います。Learn によると、この機能は選択したホストを自動的にドレイン モードに切り替えます。更新中にドレイン モードを手動で変更してはいけません。また、更新前にホスト プールの自動スケールを無効にするよう記載されています。有効なスケーリング プランがあると、実行時エラーで更新が失敗する可能性があるためです。さらに、ファイル、レジストリ キー、証明書などの手動によるカスタマイズは、更新後には残らないとされています。Microsoft は、セッション ホストの構成と更新を含む拡張ホスト プール管理の一般提供を 2026 年 7 月に発表しました(Tech Community)。Learn の一部のページにはまだプレビューの記述が残っています。たとえば構成のページでは、このようなホスト プールに対する Azure PowerShell コマンドレットがプレビューとして示されており、Az.DesktopVirtualization モジュールのプレビュー版を使用するよう求められています。制限事項に依拠する前に、必ず最新のページを確認してください。このアプローチを、「Patching AVD without downtime: rolling updates with drain mode」で紹介されているローリング ドレインと比較してみてください。
データソース
2026 年 11 月 17 日にアクセス。
- Microsoft Learn: メンテナンスのためのセッション ホストのドレイン(Azure Virtual Desktop)
- Microsoft Learn: Azure Virtual Desktop 向け Azure RBAC ロール(rbac ページ)
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Get-AzWvdUserSession
- Microsoft Learn: Send-AzWvdUserSessionMessage
- Microsoft Learn: Remove-AzWvdUserSession
- Microsoft Learn: ホスト プールの負荷分散の構成
- Microsoft Learn: Azure Virtual Desktop の自動スケーリング FAQ
- Microsoft Learn: スケーリング プランの作成と割り当て
- Microsoft Learn: 自動スケーリング プランとシナリオの例
- Microsoft Learn: セッション ホストの Windows 更新管理の方法論
- Microsoft Learn: セッション ホストの更新
- Microsoft Learn: セッション構成を使用したセッション ホストの更新
- Microsoft Tech Community:Azure Virtual Desktop 向け拡張ホスト プール管理が一般提供開始
FAQ
ドレイン モードを有効にすると、接続中のユーザーはどうなりますか?
何も起こりません。Microsoft Learn によると、既存の接続はユーザーがサインアウトするか、管理者がセッションを終了するまで有効なままです。ドレイン モードが制限するのは新しいセッションだけです。ユーザーにメッセージを送り、セッションを自分で終了させる必要があります。たとえば Send-AzWvdUserSessionMessage と Remove-AzWvdUserSession を使用します。
ドレイン モードにしたホストに、なぜユーザーがまだ接続されるのですか?
Learn の負荷分散のページによると、ホスト プール内にアクティブまたは切断状態のセッションを持つユーザーは、ドレイン モードが有効でも、そのセッションがあるホストにリダイレクトされます。セッションを持たないユーザーがドレイン中のホストに振り分けられることはありません。切断されたセッションは Get-AzWvdUserSession で確認できます。
メンテナンス中に、自動スケールがホストを再び有効にすることはありませんか?
プール化されたホスト プールでは、その可能性があります。自動スケールの FAQ によると、スケーリングの対象となるすべての VM で、自動スケールはドレイン モードより優先されます。VM をスケーリング操作から除外するには、スケーリング プランで設定する除外タグを使用します。Learn によると、タグを付けたホストは、自動スケールによって起動、停止、またはドレイン モードを変更されなくなります。個人用ホスト プールについては、FAQ で自動スケールはセッション ホストをドレイン モードにしないと説明されています。ただし、誰もサインインしていないホストは割り当て解除される可能性があります。