Azure Virtual Desktop でセッションホストの更新を使用してセッションホストを更新する (プレビュー)

[アーティクル]
10/28/2024

重要

Azure Virtual Desktop のセッションホストの更新プログラムは現在プレビュー段階です。この制限付きプレビューは、欠点を含む現状有姿で提供されるものであり、Microsoft が一般提供の Azure サービスに対して提供するサービスレベルアグリーメント (SLA) や限定的な保証の対象外となります。制限付きプレビューに登録するには、次のフォームに入力してください: https://forms.office.com/r/ZziQRGR1Lz。

ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用される法律条項については、「Microsoft Azure プレビューの追加使用条件」を参照してください。

セッションホストの構成があるホストプール内のセッションホストを更新する場合は、セッションホストの更新プログラムを使用します。セッションホストの更新プログラムを使用すると、基になる仮想マシン (VM) のイメージ、サイズ、ディスクの種類、およびその他の構成プロパティを更新できます。更新中、既存の仮想マシンは削除または割り当て解除され、セッションホストの構成に格納されている更新された構成で新しい仮想マシンが作成されます。また、この更新プログラムでは、セッションホスト管理ポリシーの値を使用して、セッションホストを更新する方法を決定します。

この記事では、ホストプールのセッションホストの構成を更新する方法、そのプール内のセッションホストを更新する方法、および Azure portal と Azure PowerShell を使用して更新の進行状況を監視する方法について説明します。

セッションホストの更新プログラムのしくみの詳細については、「セッションホストの更新プログラム」を参照してください。

前提条件

セッションホストの更新プログラムを使用してセッションホストを更新する前に、次の必要なものと作業を確認してください。

すべてが同じ Azure リージョンおよびリソースグループにあるセッションホストを含むセッションホストの構成がある既存のプールされたホストプール。個人用ホストプールはサポートされていません。
新しいイメージは、Azure Virtual Desktop でサポートされ、仮想マシンの世代と一致している必要があります。トラステッド起動の仮想マシンまたは機密仮想マシンを使用している場合、イメージは第 2 世代 VM 用である必要があります。次の場所から取得できます。
- Azure Marketplace。
- Azure Compute Gallery の既存の共有イメージ。使用するイメージのレプリカが少なくとも 2 つあることをお勧めします。
- 既存のマネージドイメージ。
セッションホストまたはセッションホストが存在するリソースグループのリソースロックをすべて削除します。
Azure Virtual Desktop サービスプリンシパルに、セッションホストの更新プログラムで使用するホストプールとセッションホストを含むリソースグループまたはサブスクリプションに対する Desktop Virtualization 仮想マシン共同作成者のロールベースのアクセス制御 (RBAC) ロールを割り当てます。詳細については、「Azure Virtual Desktop サービスプリンシパルに Azure RBAC ロールまたは Microsoft Entra ロールを割り当てる」を参照してください。

次のリソースの種類を更新するために、次の Azure RBAC ロールでセッションホストの更新プログラムを構成するために使用する Azure アカウント。同じアクセス許可を含む別の組み込みロールを使用することも、カスタムロールを作成することもできます。

リソースの種類	組み込みの Azure RBAC ロール	範囲
ホストプール	Desktop Virtualization Host Pool Contributor Desktop Virtualization Application Group Contributor	リソースグループまたはサブスクリプション
セッションホスト	Virtual Machine Contributor	リソースグループまたはサブスクリプション

セッションホストは、Active Directory ドメインにのみ参加できます。 Microsoft Entra ID へのセッションホストの参加はサポートされていませんが、Microsoft Entra ハイブリッド参加を使用できます。

セッションホストを Microsoft Entra Domain Services ドメインに参加させる場合は、AAD DC 管理者グループのメンバーである必要があります。

セッションホストを Active Directory Domain Services (AD DS) ドメインに参加させる場合は、新しい OS イメージによって既存のコンピューターアカウントが再利用されるため、ドメインへの参加に通常必要とされる以上のアクセス許可を持つアカウントを使用する必要があります。次の表のアクセス許可とプロパティを、セッションホストを含む組織単位 (OU) のアカウントに適用する必要があります。

名前	Type	適用対象
パスワードのリセット	Allow	子孫コンピューターアカウント
DNS ホスト名への検証済みの書き込み	Allow	子孫コンピューターアカウント
サービスプリンシパル名への検証済みの書き込み	Allow	子孫コンピューターアカウント
アカウントの読み取り制限	Allow	子孫コンピューターアカウント
アカウントの書き込み制限	Allow	子孫コンピューターアカウント

KB5020276 以降、Active Directory ドメイン内のコンピューターアカウントを再利用するための保護がさらに導入されました。セッションホストの既存のコンピューターアカウントを正常に再利用するには、次のいずれかを満たす必要があります。

セッションホストをドメインに参加させるユーザーアカウントは、既存のコンピューターアカウントの作成者です。
コンピューターアカウントは、ドメイン管理者セキュリティグループのメンバーによって作成されました。
グループポリシー設定 Domain controller: Allow computer account re-use during domain join をコンピューターアカウントの所有者に適用します。この設定のスコープの詳細については、KB5020276 を参照してください。

仮想マシンのローカル管理者アカウントの資格情報に使用するシークレットを含むキーコンテナー。また、セッションホストを Active Directory ドメインに参加させる場合は、ドメイン参加アカウントの資格情報。ユーザー名とパスワードごとに 1 つのシークレットが必要です。仮想マシンのローカル管理者パスワードは、VM の作成時にパスワードの要件を満たしている必要があります。
- シークレットを読み取る機能を Azure Virtual Desktop サービスプリンシパルに提供する必要があります。キーコンテナーは、次のいずれかを使用するように構成できます。
  - キーコンテナーシークレットユーザーのロールが Azure Virtual Desktop サービスプリンシパルに割り当てられている Azure RBAC アクセス許可モデル。
  - Get シークレットアクセス許可が Azure Virtual Desktop サービスプリンシパルに割り当てられているアクセスポリシー。
- キーコンテナーでは、テンプレートのデプロイに Azure Resource Manager を許可する必要があります。
正しいサービスプリンシパルを使用していることを確認するには、「Azure Virtual Desktop サービスプリンシパルに Azure RBAC ロールまたは Microsoft Entra ロールを割り当てる」を参照してください。
セッションホストの構成で指定したカスタム構成の PowerShell スクリプトが更新後に実行されるようにするには、スクリプトの URL をパブリックインターネットから解決できる必要があります。
Azure PowerShell をローカルで使用したい場合は、「Azure Virtual Desktop で Azure CLI と Azure PowerShell を使用する」を参照して、Az.DesktopVirtualization PowerShell モジュールがインストールされていることを確認してください。別の方法として、Azure Cloud Shell を使用します。
セッションホストの更新をサポートする Azure Virtual Desktop 用の Azure PowerShell コマンドレットはプレビュー段階です。バージョン 5.3.0 で追加されたこれらのコマンドレットを使用するには、Az.DesktopVirtualization モジュールのプレビューバージョンをダウンロードしてインストールする必要があります。

更新プログラムをスケジュールし、セッションホストの構成を編集する

更新プログラムをスケジュールすると、ホストプールのセッションホストの構成が使用されます。更新プログラムをスケジュールするときにセッションホストの構成を変更する必要があります。そうしないと、セッションホストは同じセッションホストの構成値で再デプロイされます。更新プログラムのスケジュール時に行った変更は、セッションホストの構成に保存されます。

セッションホストの更新プログラムをスケジュールするには、シナリオに関連するタブを選択し、手順に従います。

重要

更新中に、ユーザーセッションで使用可能なセッションホストの数が減り、ログオンしているユーザーはログオフするように求められます。エンドユーザーの中断を最小限に抑えるために、負荷の少ない時間帯に更新プログラムをスケジュールすることをお勧めします。
更新するセッションホストにカスタムネットワークセキュリティグループ (NSG) を使用する場合、Azure portal を使用して更新プログラムを開始できないという既知の問題があります。この問題を回避するには、Azure PowerShell を使用して更新プログラムを開始します。

Azure Portal
Azure PowerShell

Azure portal を使用してセッションホストの新しい更新プログラムをスケジュールする方法を次に示します。

ヒント

Azure portal を使用して更新プログラムをスケジュールすると、セッションホストの構成から値が設定されます。これが初めての更新であり、セッションホストの構成がまだ作成されていない場合、ポータルには、セッションホストの構成が作成されるまで、既定のセッションホストの構成が表示されます。更新中にセッションホストの構成に加えた変更はすべて保存されます。

Azure portal を使用してセッションホストの構成を編集する場合は、更新プログラムをスケジュールする必要があります。

この記事の冒頭にあるリンクを使用して制限付きプレビューに登録したことを確認し、登録後に提供された特定のリンクを使用して Azure portal にサインインします。 Azure Virtual Desktop の概要で、[ホストプール] を選択し、更新するセッションホストの構成があるホストプールを選択します。
[セッションホスト] を選択します。
更新プログラムをスケジュールする前にセッションホストの構成を確認する場合は、[セッションホストの構成の管理] を選択し、[表示] を選択します。セッションホストの構成を確認したら、[取り消す] を選択します。
新しい更新プログラムをスケジュールするには、[セッションホストの更新の管理] を選択し、[新しい更新プログラム] を選択します。または、[セッションホストの構成の管理] を選択し、[編集] を選択します。

[基本] タブで次の情報を入力します。

パラメーター	値/説明
更新後に元の仮想マシンの保存を有効にする	ロールバックシナリオでは便利ですが、元の VM のコンポーネントの格納には通常のコストが適用されます。
現在のホストプールのサイズ (読み取り専用)	ホストプール内のセッションホストの数。
更新中にホストプールから削除することが承認された VM バッチサイズ	一度に更新されるセッションホストの最大数。更新が開始されると、最初のセッションホストと呼ばれる 1 つのセッションホストのみが最初に更新され、残りのセッションホストがバッチで更新される前に更新プロセスが検証されます。最初の更新が成功しなかった場合、更新は停止します。
更新中に使用可能なセッションホスト (読み取り専用)	更新中にユーザーセッションで使用できるセッションホストの最小数。

このタブを完了したら、[次へ: セッションホスト] を選択します。

[セッションホスト] タブでは、必要に応じて、セッションホストの構成で次のパラメーターを更新できます。

パラメーター	値/説明
セキュリティの種類	[標準]、[トラステッド起動仮想マシン]、または [機密の仮想マシン] から選択します。 - [トラステッド起動の仮想マシン] を選択すると、[セキュアブート] と [vTPM] のオプションが自動的に選択されます。 - [機密の仮想マシン] を選択すると、[セキュアブート]、[vTPM]、[integrity monitoring] (整合性の監視) のオプションが自動的に選択されます。機密 VM を使用している場合、vTPM をオプトアウトすることはできません。
Image	一覧から使用する OS イメージを選択するか、[すべてのイメージを表示] を選択して詳細を表示します。これには、Azure Compute Gallery の共有イメージまたはマネージドイメージとして作成および保存したカスタムイメージが含まれます。
[仮想マシンのサイズ]	一覧から推奨 SKU を選択します。別の SKU を使用する場合は、[すべてのサイズを表示] を選択し、一覧から選択します。
OS ディスクの種類	セッションホストに使用するディスクの種類を選択します。運用環境のワークロードには Premium SSD を使用することをお勧めします。ディスクの種類は、選択した VM ファミリとサイズでサポートされている必要があります。 Azure コンピューティングでサポートされている組み合わせを選択していることを確認します。更新されたセッションホストの OS ディスクの名前には、`SessionHostName-DateTime_Hash` という形式で新しい名前が付けられます。
参加するドメイン
参加するディレクトリを選択する	[Active Directory] を選択し、ドメイン参加アカウントのユーザー名とパスワードのシークレットを含むキーコンテナーを選択します。必要に応じて、ドメイン名と組織単位のパスを指定できます。
仮想マシンの管理者アカウント	更新されたセッションホスト VM のローカル管理者アカウントのユーザー名とパスワードのキーコンテナーとシークレットを選択して、関連するパラメーターを完了します。ユーザー名とパスワードは、Azure の Windows VM の要件を満たしている必要があります。
カスタム構成
カスタム構成スクリプトの URL	デプロイ時に PowerShell スクリプトを実行する場合は、ここに URL を入力できます。

セッションホストの構成の変更を確認または完了したら、[次へ: スケジュール] を選択します。

[スケジュール] タブで、[今すぐ更新プログラムをスケジュールする] チェックボックスをオンにするか、更新を開始する日付、時刻、タイムゾーンを選択します (現在の時刻から最大 2 週間)。

スケジュールを設定したら、[次へ: 通知] を選択します。

[通知] タブで、次の情報を入力します。

パラメーター	値/説明
ユーザーがサインアウトするまでの数分	更新の開始時間からユーザーにサインアウトを通知するまでの待機時間。この値は、0 から 60 分の間で構成できます。この経過時間が経過すると、ユーザーは自動的にログオフされます。
サインアウトメッセージ	使用しているセッションホストが更新を開始しようとしていることをユーザーに通知するために指定できるメッセージ。

このタブに入力し終わったら、[次へ: 確認] を選択します。

[確認] タブで、検証に合格したことを確認し、更新中に使用される情報を確認します。
[更新] を選択して更新プログラムをスケジュールします。セッションホストの一覧を表示すると、[現在のバージョン] 列に、セッションホストが使用しているセッションホストの構成のバージョンのタイムスタンプが表示されます。 [現在のバージョン] 列に警告アイコンがある場合は、[ターゲットバージョン] 列のバージョンのタイムスタンプがそれより後になっているため、セッションホストを更新する必要があることを意味します。

Note

更新プログラムを初めてスケジュールすると、指定した設定によってセッションホスト管理ポリシーの既定の設定が上書きされます。以降の更新では、これらのパラメーターが事前に設定され、すべての変更が保存されます。

Az.DesktopVirtualization PowerShell モジュールを使用して、セッションホストの新しい更新プログラムをスケジュールする方法を次に示します。更新プログラムをスケジュールすると、ホストプールのセッションホストの構成が使用されます。更新プログラムをスケジュールする前に、セッションホストの構成を変更する必要があります。

更新プログラムをスケジュールする前に、セッションホスト管理ポリシーを更新できます。この場合、変更は今後使用するために保持されます。または、更新プログラムをスケジュールするときにセッションホスト管理ポリシーの値をオーバーライドすることもできますが、その値はその更新にのみ適用されます。

重要

次の例では、<placeholder> を独自の値に変更する必要があります。

ターミナルの種類として PowerShell を指定して、Azure portal で Azure Cloud Shell を開くか、ローカルデバイスで PowerShell を実行します。
- Cloud Shell を使用している場合は、Azure コンテキストが、使用したいサブスクリプションに設定されていることを確認します。
- PowerShell をローカルで使用している場合は、まず Azure PowerShell でサインインした後、Azure コンテキストが使用したいサブスクリプションに設定されていることを確認します。

コマンドレットを Update-AzWvdSessionHostConfiguration 使用してセッションホストの構成を更新します。ここで必要なのは、変更するパラメーターを指定することだけです。以下にコマンド例を示します。
- セッションホストで使用する別のカスタムイメージを指定するには、次のコマンドを実行します。 Marketplace イメージの値を検索する方法については、「Azure PowerShell で Azure Marketplace VM イメージを検索して使用する」を参照してください。
```
$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
     ImageInfoType = 'Custom'
     CustomInfoResourceID  = '/subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroupName>/providers/Microsoft.Compute/galleries/<GalleryName>/images/<ImageName>/versions/<ImageVersion>'
}

Update-AzWvdSessionHostConfiguration @parameters
```
- ローカル管理者アカウントのパスワードを格納するキーコンテナーとシークレットを変更するには、次のコマンドを実行します。
```
$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
     VMAdminCredentialsUsernameKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
     VMAdminCredentialsPasswordKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
}

Update-AzWvdSessionHostConfiguration @parameters
```
- 仮想マシンのサイズを D8s_v5 に変更し、OS ディスクの種類を Premium SSD に変更するには、次のコマンドを実行します。更新されたセッションホストの OS ディスクの名前には、SessionHostName-DateTime_Hash という形式で新しい名前が付けられます。
```
$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
     VMSizeId = 'Standard_D8s_v5'
     DiskInfoType = 'Premium_LRS'
}

Update-AzWvdSessionHostConfiguration @parameters
```
次のコマンドを実行して、セッションホストの構成を表示して変更を確認します。
```
$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
}

Get-AzWvdSessionHostConfiguration @parameters | FL *
```
省略可能: 更新プログラムをスケジュールする前にセッションホスト管理ポリシーを更新する場合は、コマンドレット Update-AzWvdSessionHostManagement を使用して次のコマンドを実行します。または、更新プログラムをスケジュールするときに特定の値をオーバーライドすることもできます。この値は、その更新にのみ使用されます。有効なタイムゾーン値については、Get-TimeZone PowerShell リファレンスを参照し、StandardName プロパティの値を使用します。
```
$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    ScheduledDateTimeZone = '<TimeZoneID>'
    UpdateDeleteOriginalVM = <$true or $false>
    UpdateMaxVmsRemoved = '<Quantity>'
    UpdateLogOffDelayMinute = '<Minutes>'
    UpdateLogOffMessage = '<Message>'
}

Update-AzWvdSessionHostManagement @parameters
```
次のコマンドを実行すると、更新されたセッションホスト管理ポリシーのプロパティを表示できます。
```
$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
}

Get-AzWvdSessionHostManagement @parameters
```
更新プログラムをスケジュールするには、次の例に示す Invoke-AzWvdInitiateSessionHostUpdate コマンドレットを使用します。更新プログラムをすぐに開始するようにスケジュールすることも、更新を開始する時間を最大 2 週間先まで指定することもできます。以下にコマンド例を示します。
- 更新プログラムをすぐに開始するようにスケジュールし、セッションホスト管理ポリシーの値を使用するには、次のコマンドを実行します。
```
$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
}

$update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
```
- 指定した日時 (YYYY-MM-DD HH:mm 形式) で更新プログラムをスケジュールし、セッションホスト管理ポリシーの値を使用するには、次のコマンドを実行します。
```
$dateTime = Get-Date -Date "2024-03-15 01:30"

$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
     ScheduledDateTime = $dateTime
}

$update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
```
- スケジュールされた更新プログラムを開始するには、次のコマンドを実行します。
```
$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
     Action = Start
}

$update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
```

スケジュールされた更新プログラムのプロパティを表示するには、次のコマンドを実行します。

$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    IsLatest = $true
}

Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *

重要

更新プログラムをスケジュールした後は、スケジュールや設定を編集することはできません。変更を加える必要がある場合は、更新を取り消し、新しい更新プログラムをスケジュールする必要があります。
更新プログラムの進行中は、ホストプールから VM を削除しないでください。削除すると、進行中の更新プログラムに問題が発生する可能性があります。
更新プログラムの進行中は、ホストプール内の VM のドレインモードを変更しないでください。 VM のドレインモードは、更新プログラムの段階に基づいて自動的に変更されます。更新後にセッションホストを回復できない場合は、ドレインモードの設定が有効になります。更新が完了すると、ドレインモードがリセットされます。
セッションホストが更新されるまでに約 20 分かかります。バッチサイズで指定したセッションホストの数は、次のバッチに進む前に同時に更新されます。全体的な完了時間をスケジュールされた時刻に考慮する必要があります。

更新プログラムの進行状況を監視する

更新が開始されたら、その進行状況を確認できます。シナリオの関連タブを選択し、手順に従います。

Azure Portal
Azure PowerShell

Azure portal を使用して更新プログラムの進行状況を監視する方法を次に示します。

Azure Virtual Desktop の概要で、[ホストプール] を選択し、更新プログラムをスケジュールしたホストプールを選択します。
[セッションホスト] を選択します。
青いバナーが更新の状態を示します。特定の時点のみが表示されるため、最新の進行状況を確認するには [最新の情報に更新] を選択する必要があります。

更新をすぐに開始するように選択した場合、更新の開始時に更新プログラムがスケジュールされていることを示すメッセージが表示されますが、このメッセージは最新の情報に更新すると更新されます。更新中、更新時にホストプールから削除されたセッションホストのバッチサイズ数が表示されます。

Az.DesktopVirtualization PowerShell モジュールを使用して、更新プログラムの進行状況を監視する方法を次に示します。

既存の PowerShell セッションから、次の例に示す Get-AzWvdSessionHostManagementsUpdateStatus コマンドレットを使用して、現在の更新の詳細を取得します。

更新プログラムの最新の進行状況を確認するには、次のコマンドを実行します。

$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
     IsLatest = $true
}

$updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters |
     FL PercentComplete,
     ProgressExecutionStartTime,
     ProgressSessionHostsCompleted,
     ProgressSessionHostsInProgress,
     ProgressSessionHostsRollbackFailed,
     ProgressTotalSessionHost,
     EndTime

$updateProgress

最新の更新プログラムのすべてのパラメーターを表示するには、次のコマンドを実行します。

$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
     IsLatest = $true
}
$updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *

$updateProgress

ヒント

Azure Monitor アクティビティログを使用して、更新プログラムのアクティビティを確認することもできます。

更新プログラムを一時停止、再開、取り消し、または再試行する

進行中の更新プログラムを一時停止、再開、または取り消すことができます。更新プログラムを一時停止または取り消した場合、現在のアクティビティが完了してから、更新プログラムの残りの部分が一時停止されます。たとえば、セッションホストのバッチが更新されている場合、これらのセッションホストの更新が最初に完了します。更新の状態を示す青いバナーは、更新プログラムが一時停止した際に、更新がどこまで進んだかを表示するように変わります。更新プログラムが一時停止された後は、再開することしかできません。再開は一時停止された時点から継続されます。

2 週間以内に更新プログラムを再開しない場合、更新プログラムは取り消されます。更新プログラムが取り消されると、再開することはできません。

注意事項

途中で更新プログラムを取り消すと、ホストプール内のセッションホスト間で、オペレーティングシステムのバージョンが異なる、別の Active Directory ドメインに参加しているなどの違いが生じます。これにより、ユーザーに一貫性のないエクスペリエンスが提供される可能性があるため、すべてのセッションホストにパリティがあることを確認するには、できるだけ早く別の更新プログラムをスケジュールする必要があります。

Azure Portal
Azure PowerShell

Azure portal を使用して更新プログラムを一時停止、再開、取り消し、または再試行する方法を次に示します。

Azure Virtual Desktop の概要で、[ホストプール] を選択し、更新プログラムをスケジュールしたホストプールを選択します。
[セッションホスト] を選択し、[セッションホストの更新の管理] を選択します。
更新プログラムの現在の状態に応じて、[一時停止]、[再開]、[取り消す]、または[再試行] を選択します。
[最新の情報に更新] を選択し、青いバナーのステータスメッセージを更新します。正しい状態が表示されるまでに約 20 秒かかる場合があります。

Az.DesktopVirtualization PowerShell モジュールを使用して、更新プログラムを一時停止、再開、取り消し、または再試行する方法を次に示します。

既存の PowerShell セッションから、次の例に示す Invoke-AzWvdControlSessionHostUpdate コマンドレットを使用して、現在の更新プログラムを一時停止または再開します。

まず、次のコマンドを実行して、更新の状態を確認します。

$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    IsLatest = $true
}

Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Status

実行するアクションに応じて、次のいずれかの例を使用します。

更新プログラムを一時停止するには、次のコマンドを実行します。

$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
     Action = 'Pause'
}

Invoke-AzWvdControlSessionHostUpdate @parameters

更新プログラムを再開するには、次のコマンドを実行します。

$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
     Action = 'Resume'
}

Invoke-AzWvdControlSessionHostUpdate @parameters

更新プログラムを取り消してメッセージを含めるには、次のコマンドを実行します。

$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
     Action = 'Cancel'
     CancelMessage = '<Message>'
}

Invoke-AzWvdControlSessionHostUpdate @parameters

更新プログラムを再試行するには、次のコマンドを実行します。

$parameters = @{
     HostPoolName = '<HostPoolName>'
     ResourceGroupName = '<ResourceGroupName>'
     Action = 'Retry'
}

Invoke-AzWvdControlSessionHostUpdate @parameters

次のコマンドを実行して、アクションの実行後に更新アクションと状態を確認します。

$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    IsLatest = $true
}

Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Action, Status

次のステップ

セッションホストの更新診断を使用する方法を確認します。
セッションホストの更新のトラブルシューティングに関するガイダンスを参照してください。

次の方法で共有

Azure Virtual Desktop でセッションホストの更新を使用してセッションホストを更新する (プレビュー)

前提条件

更新プログラムをスケジュールし、セッションホストの構成を編集する

更新プログラムの進行状況を監視する

更新プログラムを一時停止、再開、取り消し、または再試行する

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure Virtual Desktop でセッション ホストの更新を使用してセッション ホストを更新する (プレビュー)

前提条件

更新プログラムをスケジュールし、セッション ホストの構成を編集する

更新プログラムの進行状況を監視する

更新プログラムを一時停止、再開、取り消し、または再試行する

次のステップ

フィードバック

その他のリソース

Azure Virtual Desktop でセッションホストの更新を使用してセッションホストを更新する (プレビュー)

更新プログラムをスケジュールし、セッションホストの構成を編集する