Azure 虛擬桌面 PowerShell
重要
本內容適用於具有 Azure Resource Manager Azure 虛擬桌面物件的 Azure 虛擬桌面。 如果您使用不含 Azure Resource Manager 物件的 Azure 虛擬桌面 (傳統版),請參閱此文章。
使用本文來解決搭配 Azure 虛擬桌面使用 PowerShell 時的錯誤和問題。 如需遠端桌面服務 PowerShell 的詳細資訊,請參閱 Azure 虛擬桌面 PowerShell。
提供意見反應
請造訪 Azure 虛擬桌面 Tech Community,與產品小組和活躍的社群成員一起討論 Azure 虛擬桌面服務。
Azure 虛擬桌面設定期間使用的 PowerShell 命令
本節列出在設定 Azure 虛擬桌面時通常會使用的 PowerShell 命令,並提供在使用時可能發生的問題解決方法。
錯誤: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 ID,或沒有權限可查詢使用者所在的 Microsoft Entra ID。
修正 2:具有擁有者權限的使用者必須執行角色指派。
錯誤: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 來稽核作業。
- 若要了解部署期間可採取哪些動作來判斷錯誤,請參閱 檢視部署作業。