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 サービスに関して製品チームや活発なコミュニティのメンバーと話をしたいときは、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 のアクセス許可が与えられているユーザーは、ロールの割り当てを実行する必要があります。

Note

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

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

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

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

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

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

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

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

次のステップ