針對 Azure 虛擬桌面 PowerShell 進行疑難解答
本文可協助解決搭配 Azure 虛擬桌面使用 PowerShell 時的錯誤和問題。 如需遠端桌面服務 PowerShell 的詳細資訊，請參閱 Azure 虛擬桌面 PowerShell。
提供意見反應
請造訪 Azure 虛擬桌面 Tech Community，與產品小組和活躍的社群成員一起討論 Azure 虛擬桌面服務。
Azure 虛擬桌面設定期間使用的PowerShell Cmdlet
本節列出在設定 Azure 虛擬桌面時通常會使用的 PowerShell Cmdlet，並提供解決使用 Azure 虛擬桌面時可能發生的問題的方法。
錯誤：New-AzRoleAssignment：提供的資訊不會對應至 AD 物件識別碼
New-AzRoleAssignment -SignInName "admins@contoso.com" -RoleDefinitionName "Desktop Virtualization User" -ResourceName "0301HP-DAG" -ResourceGroupName 0301RG -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'
原因
在系結至 Azure 虛擬桌面環境的 Microsoft Entra 中找不到 參數所 -SignInName 指定的使用者。
解決方法
請確定下列事項：
- 該使用者應同步到 Microsoft Entra ID。
- 使用者不應繫結至企業對消費者 (B2C) 或企業對企業 (B2B) 商務。
- Azure 虛擬桌面環境應該繫結至正確的 Microsoft Entra ID。
錯誤：New-AzRoleAssignment：“具有對象標識符的用戶端沒有在範圍上執行動作的授權（程序代碼：AuthorizationFailed）”
原因 1
使用的帳戶沒有訂用帳戶的擁有者許可權。
解決方法 1
具有擁有者許可權的用戶必須執行角色指派。 或者，使用者必須指派給使用者存取系統管理員角色，才能將使用者指派給應用程式群組。
原因 2
使用的帳戶具有擁有者許可權，但不屬於環境Microsoft Entra標識符的一部分，或沒有許可權來查詢使用者所在的Microsoft Entra 標識符。
解決方法 2
具有 Active Directory 許可權的用戶必須執行角色指派。
錯誤：New-AzWvdHostPool：資源類型無法使用位置
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 虛擬桌面支援選取主機集區、應用程式群組和工作區的位置，以將服務元數據儲存在特定位置。 您的選項僅限於此功能可用的位置。 此錯誤表示該功能無法在您選擇的位置中使用。
解決方法
在錯誤訊息中，將會發佈支援的區域清單。 使用其中一個支援區域。
錯誤：New-AzWvdApplicationGroup 必須與主機集區位於相同的位置
New-AzWvdApplicationGroup_CreateExpanded: ActivityId: e5fe6c1d-5f2c-4db9-817d-e423b8b7d168 Error: ApplicationGroup must be in same location as associated HostPool
原因
位置不符。 所有主機集區、應用程式群組和工作區都有儲存服務中繼資料的位置。 您所建立的任何物件都必須位於相同位置。 例如，如果主機集區位於 eastus 中，則您也需要在 eastus 中建立應用程式群組。 如果您建立工作區來註冊這些應用程式群組，該工作區也必須位於 eastus 其中。
解決方法
擷取建立主機集區的位置，然後將您要建立的應用程式群組指派給該相同位置。
下一步
- 如需 Azure 虛擬桌面疑難排解與升級追蹤的概觀，請參閱疑難排解概觀、意見反應與支援。
- 若要針對設定 Azure 虛擬桌面環境和主機集區時的問題進行疑難排解，請參閱環境與主機集區建立。
- 若要針對在 Azure 虛擬桌面中設定虛擬機器 (VM) 時的問題進行疑難排解，請參閱工作階段主機虛擬機器設定。
- 若要針對 Azure 虛擬桌面用戶端連線的問題進行疑難排解，請參閱 Azure 虛擬桌面服務連線。
- 若要對遠端桌面用戶端的問題進行疑難排解，請參閱對遠端桌面用戶端進行疑難排解
- 如需服務的詳細資訊，請參閱 Azure 虛擬桌面環境。
- 如需稽核動作的詳細資訊，請參閱 使用 Resource Manager 稽核作業。
- 如需動作在部署期間判斷錯誤的詳細資訊，請參閱 檢視部署作業。