Azure Virtual Desktop (クラシック) PowerShell

Azure Virtual Desktop で PowerShell を使用するときに発生するエラーと問題を解決する際、この記事を参考にしてください。 リモート デスクトップ サービスの PowerShell については、「Azure Virtual Desktop PowerShell」を参照してください。

フィードバックの提供

Azure Virtual Desktop サービスに関して製品チームや活発なコミュニティのメンバーと話をしたいときは、Azure Virtual Desktop の技術コミュニティにアクセスしてください。

Azure Virtual Desktop 設定時に使用される PowerShell コマンド

このセクションでは、Azure Virtual Desktop の設定時に一般的に使用される PowerShell コマンドと、その使用時に発生することがある問題の解決方法を紹介しています。

エラー:Add-RdsAppGroupUser コマンド -- 指定された UserPrincipalName が、指定されたホスト プールの RemoteApp アプリ グループに既に割り当てられています。

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName 'Desktop Application Group' -UserPrincipalName <UserName>

原因: 使用されたユーザー名は、別の種類のアプリケーション グループに既に割り当てられています。 同じセッション ホスト プールの下で、リモート デスクトップと RemoteApp アプリケーション グループの両方にユーザーを割り当てることはできません。

修正: RemoteApp とデスクトップの両方が必要な場合、別のホスト プールを作成するか、セッション ホスト VM であらゆるアプリケーションの使用を許可するリモート デスクトップへのアクセス権限をユーザーに付与します。

エラー: Add-RdsAppGroupUser コマンド -- 指定された UserPrincipalName は、リモート デスクトップ テナントに関連付けられている Microsoft Entra ID に存在しません

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName "Desktop Application Group" -UserPrincipalName <UserPrincipalName>

原因: -UserPrincipalName によって指定されるユーザーが、Azure Virtual Desktop テナントに関連付けられている Microsoft Entra で見つかりません。

解決策: 次のリストにある項目を確認します。

• ユーザーは Microsoft Entra ID に同期されています。
• ユーザーが B2C (企業-消費者間) 商取引にも B2B (企業-企業) 商取引にも関連付けられていません。
• Azure Virtual Desktop テナントが適切な Microsoft Entra に関連付けられています。

エラー:Get-RdsDiagnosticActivities -- 管理サービスに問い合わせる許可がユーザーに与えられていません

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

原因: -TenantName パラメーター

解決策: -TenantName <TenantName> を指定して Get-RdsDiagnosticActivities を実行します。

エラー:Get-RdsDiagnosticActivities -- 管理サービスに問い合わせる許可がユーザーに与えられていません

Get-RdsDiagnosticActivities -Deployment -username <username>

原因: -Deployment スイッチの使用。

解決策: -Deployment スイッチは、展開管理者だけが使用できます。 これらの管理者は通常、リモート デスクトップ サービス/Azure Virtual Desktop チームに属しています。 -Deployment スイッチを -TenantName <TenantName> に変更します。

エラー:New-RdsRoleAssignment -- 管理サービスに問い合わせる許可がユーザーに与えられていません

原因 1: 使用中のアカウントにテナントの Remote Desktop Services の所有者アクセス許可が与えられていません。

解決策 1: Remote Desktop Services の所有者アクセス許可が与えられているユーザーは、ロールの割り当てを実行する必要があります。

原因 2: 使用中のアカウントに Remote Desktop Services の所有者アクセス許可が与えられているが、テナントの Microsoft Entra ID に属していないか、ユーザーが置かれている Microsoft Entra ID に問い合わせるアクセス許可が与えられていません。

解決策 2: Active Directory のアクセス許可が与えられているユーザーは、ロールの割り当てを実行する必要があります。

エラー: SessionHostPool を削除できませんでした

このエラーは、通常、次のコマンドを実行してセッション ホストを削除しようとしたときに発生します。

Remove-RdsHostPool -TenantName <TenantName> -Name <HostPoolName>

原因: ホスト プールのリーフ オブジェクトを削除する前にコマンドを実行すると、機能しません。

修正: 次のコマンドを実行して、セッション ホストを削除します。

Get-RdsSessionHost-TenantName <TenantName> -Hostpook <HostPoolName> | Remove-RdsSessionHost -Force

force コマンドを使用すると、割り当てられたユーザーがいる場合でもセッション ホストを削除できます。

次のステップ

• Azure Virtual Desktop トラブルシューティングの概要とエスカレーション トラックについては、「トラブルシューティングの概要、フィードバック、サポート」を参照してください。
• Azure Virtual Desktop 環境でテナントとホスト プールを作成しているときに発生した問題のトラブルシューティングを行う場合は、「テナントとホスト プールの作成」を参照してください。
• Azure Virtual Desktop で仮想マシン (VM) の構成中に発生した問題のトラブルシューティングを行う場合は、「セッション ホスト仮想マシンの構成」を参照してください。
• Azure Virtual Desktop クライアント接続の問題をトラブルシューティングするには、Azure Virtual Desktop サービスの接続に関するページを参照してください。
• リモート デスクトップ クライアントの問題をトラブルシューティングするには、リモート デスクトップ クライアントのトラブルシューティング に関するページを参照してください
• サービスの詳細については、Azure Virtual Desktop 環境に関するページを参照してください。
• トラブルシューティング チュートリアルについては、「Tutorial:Resource Manager テンプレート デプロイのトラブルシューティング」を参照してください。
• 監査アクションについては、「 リソース マネージャーの監査操作」をご覧ください。
• デプロイ時にエラーが発生した場合の対応については、 デプロイ操作の確認に関するページを参照してください。