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 コマンドと、その使用時に発生することがある問題の解決方法を紹介しています。

エラー:New-AzRoleAssignment:"The provided information does not map to an AD object ID" (指定された情報は、AD オブジェクト ID にマップされていません)

New-AzRoleAssignment -SignInName "admins@contoso.com" -RoleDefinitionName "Desktop Virtualization User" -ResourceName "0301HP-DAG" -ResourceGroupName 0301RG -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'

原因: -SignInName パラメーターで指定されたユーザーが、Azure Virtual Desktop 環境に関連付けられている Microsoft Entra で見つかりません。

解決策: 次の点を確認してください。

• ユーザーは Microsoft Entra ID に同期されている必要があります。
• ユーザーは B2C (企業-消費者間) 商取引にも B2B (企業-企業) 商取引にも関連付けません。
• Azure Virtual Desktop 環境は適切な Microsoft Entra ID に関連付ける必要があります。

エラー:New-AzRoleAssignment:"The client with object id does not have authorization to perform action over scope (code:AuthorizationFailed)" (オブジェクト ID のあるクライアントでスコープに対するアクションの実行が承認されていない (コード:AuthorizationFailed))

原因 1: 使用中のアカウントにサブスクリプションの所有者アクセス許可が与えられていません。

解決策 1: 所有者アクセス許可が与えられているユーザーは、ロールの割り当てを実行する必要があります。 あるいは、ユーザーをアプリケーション グループに割り当てられるよう、ユーザー アクセス管理者ロールにユーザーを割り当てる必要があります。

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

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

エラー:New-AzWvdHostPool -- the location is not available for resource type (場所がリソースの種類に利用できません)

New-AzWvdHostPool_CreateExpanded: The provided location 'southeastasia' is not available for resource type 'Microsoft.DesktopVirtualization/hostpools'. List of available regions for the resource type is 'eastus,eastus2,westus,westus2,northcentralus,southcentralus,westcentralus,centralus'.

原因: Azure Virtual Desktop では、ホスト プール、アプリケーション グループ、ワークスペースの場所を選択し、特定の場所にサービス メタデータを格納できます。 選択肢はこの機能が利用できる場所に限定されます。 このエラーは、選択した場所で機能が利用できないことを意味します。

解決策:エラー メッセージには、サポートされているリージョンの一覧があります。 サポートされているリージョンを代わりに使用してください。

エラー:New-AzWvdApplicationGroup must be in same location as host pool (ホスト プールと同じ場所にする必要があります)

New-AzWvdApplicationGroup_CreateExpanded: ActivityId: e5fe6c1d-5f2c-4db9-817d-e423b8b7d168 Error: ApplicationGroup must be in same location as associated HostPool

原因: 場所が一致していません。 ホスト プール、アプリケーション グループ、ワークスペースにはすべて、サービス メタデータを格納する場所を与える必要があります。 作成したオブジェクトが互いに関連付けられている場合、同じ場所に置く必要があります。 たとえば、ホスト プールが eastus に置かれている場合、アプリケーション グループも eastus で作成する必要があります。 これらのアプリケーション グループを登録するワークスペースを作成する場合、そのワークスペースも eastus に置く必要があります。

解決策: ホスト プールが作成された場所を取得し、作成中のアプリケーション グループをその同じ場所に割り当てます。

次のステップ

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