次の方法で共有

Azure Virtual Desktop (クラシック) PowerShell

  • [アーティクル]

大事な

このコンテンツは、Azure Resource Manager Azure Virtual Desktop オブジェクトをサポートしていない Azure Virtual Desktop (クラシック) に適用されます。 Azure Resource Manager Azure Virtual Desktop オブジェクトを管理しようとしている場合は、この記事参照してください。

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

フィードバックを提供する

Azure Virtual Desktop Tech Community にアクセスして、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 ID に関連付けられています。

エラー: Get-RdsDiagnosticActivities -- ユーザーが管理サービスに対してクエリを実行する権限がありません

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

原因: -TenantName パラメーター

修正: Get-RdsDiagnosticActivities の -TenantName <TenantName>の問題。

エラー: Get-RdsDiagnosticActivities -- ユーザーは管理サービスに対してクエリを実行する権限がありません

Get-RdsDiagnosticActivities -Deployment -username <username>

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

修正: -Deployment スイッチは、展開管理者のみが使用できます。 通常、これらの管理者はリモート デスクトップ サービス/Azure Virtual Desktop チームのメンバーです。 -Deployment スイッチを -TenantName <TenantName>に置き換えます。

エラー: New-RdsRoleAssignment -- ユーザーは管理サービスに対してクエリを実行する権限がありません

原因 1: 使用されているアカウントには、テナントに対するリモート デスクトップ サービス所有者のアクセス許可がありません。

修正 1: リモート デスクトップ サービス所有者のアクセス許可を持つユーザーは、ロールの割り当てを実行する必要があります。

原因 2: 使用中のアカウントにはリモート デスクトップ サービスの所有者アクセス許可がありますが、テナントの Microsoft Entra ID の一部ではないか、ユーザーが配置されている Microsoft Entra ID を照会するアクセス許可がありません。

修正 2: Active Directory アクセス許可を持つユーザーは、ロールの割り当てを実行する必要があります。

手記

New-RdsRoleAssignment は、Microsoft Entra ID に存在しないユーザーにアクセス許可を付与することはできません。

エラー: 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 環境に関するページを参照してください。
  • トラブルシューティングのチュートリアルについては、「チュートリアル: リソースマネージャーテンプレート展開のトラブルシューティング」を参照してください。
  • 監査アクションの詳細については、「Resource Managerを使用した監査操作の 」を参照してください。
  • デプロイ中にエラーを特定するアクションについては、「展開操作を表示する」を参照してください。