Azure Virtual Desktop (klassiek) PowerShell
Belangrijk
Deze inhoud is van toepassing op Azure Virtual Desktop (klassiek), die geen ondersteuning biedt voor Azure Resource Manager Azure Virtual Desktop-objecten. Als u Azure Resource Manager Azure Virtual Desktop-objecten wilt beheren, raadpleegt u dit artikel.
Gebruik dit artikel om fouten en problemen op te lossen bij het gebruik van PowerShell met Azure Virtual Desktop. Zie Azure Virtual Desktop PowerShell voor meer informatie over Remote Desktop Services PowerShell.
Feedback geven
Ga naar de Azure Virtual Desktop Tech Community om de Azure Virtual Desktop-service te bespreken met het productteam en actieve communityleden.
PowerShell-opdrachten die worden gebruikt tijdens de installatie van Azure Virtual Desktop
Deze sectie bevat PowerShell-opdrachten die doorgaans worden gebruikt tijdens het instellen van Azure Virtual Desktop en manieren om problemen op te lossen die kunnen optreden tijdens het gebruik ervan.
Fout: opdracht Add-RdsAppGroupUser - De opgegeven UserPrincipalName is al toegewezen aan een RemoteApp-app-groep in de opgegeven hostgroep
Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName 'Desktop Application Group' -UserPrincipalName <UserName>
Oorzaak: De gebruikte gebruikersnaam is al toegewezen aan een toepassingsgroep van een ander type. Gebruikers kunnen niet worden toegewezen aan zowel een extern bureaublad als een RemoteApp-toepassingsgroep onder dezelfde sessiehostgroep.
Oplossing: Als de gebruiker zowel een RemoteApp als een bureaublad nodig heeft, maakt u verschillende hostgroepen of verleent u alleen gebruikerstoegang tot het externe bureaublad, waardoor het gebruik van een toepassing op de sessiehost-VM mogelijk wordt.
Fout: de opdracht Add-RdsAppGroupUser : de opgegeven UserPrincipalName bestaat niet in de Microsoft Entra-id die is gekoppeld aan de Extern bureaublad-tenant
Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName "Desktop Application Group" -UserPrincipalName <UserPrincipalName>
Oorzaak: De gebruiker die is opgegeven door -UserPrincipalName, kan niet worden gevonden in de Microsoft Entra die is gekoppeld aan de Azure Virtual Desktop-tenant.
Oplossing: Bevestig de items in de volgende lijst.
- De gebruiker wordt gesynchroniseerd met de Microsoft Entra-id.
- De gebruiker is niet gekoppeld aan zakelijke klanten (B2C) of B2B-handel (business-to-business).
- De Azure Virtual Desktop-tenant is gekoppeld aan de juiste Microsoft Entra-id.
Fout: Get-RdsDiagnosticActivities - Gebruiker is niet gemachtigd om een query uit te voeren op de beheerservice
Get-RdsDiagnosticActivities -ActivityId <ActivityId>
Oorzaak: -TenantName-parameter
Oplossing: Probleem met Get-RdsDiagnosticActivities met -TenantName <TenantName>.
Fout: Get-RdsDiagnosticActivities - de gebruiker is niet gemachtigd om een query uit te voeren op de beheerservice
Get-RdsDiagnosticActivities -Deployment -username <username>
Oorzaak: -Implementatieswitch gebruiken.
Oplossing: - Implementatieswitch kan alleen worden gebruikt door implementatiebeheerders. Deze beheerders zijn meestal lid van het team Extern bureaublad-services/Azure Virtual Desktop. Vervang de switch -Deployment door -TenantName <TenantName>.
Fout: New-RdsRoleAssignment - de gebruiker is niet gemachtigd om een query uit te voeren op de beheerservice
Oorzaak 1: Het account dat wordt gebruikt, heeft geen machtigingen voor de eigenaar van Extern bureaublad-services voor de tenant.
Oplossing 1: Een gebruiker met machtigingen van de eigenaar van Extern bureaublad-services moet de roltoewijzing uitvoeren.
Oorzaak 2: Het account dat wordt gebruikt, heeft machtigingen voor de eigenaar van Extern bureaublad-services, maar maakt geen deel uit van de Microsoft Entra-id van de tenant of heeft geen machtigingen om een query uit te voeren op de Microsoft Entra-id waar de gebruiker zich bevindt.
Oplossing 2: Een gebruiker met Active Directory-machtigingen moet de roltoewijzing uitvoeren.
Notitie
New-RdsRoleAssignment kan geen machtigingen verlenen aan een gebruiker die niet bestaat in de Microsoft Entra-id.
Fout: SessionHostPool kan niet worden verwijderd
Deze fout treedt meestal op wanneer u de volgende opdracht uitvoert om een sessiehost te verwijderen.
Remove-RdsHostPool -TenantName <TenantName> -Name <HostPoolName>
Oorzaak: Als u de opdracht uitvoert voordat u de bladobjecten van de hostgroep verwijdert, werkt deze niet.
Oplossing: Voer de volgende opdracht uit om de sessiehost te verwijderen.
Get-RdsSessionHost-TenantName <TenantName> -Hostpook <HostPoolName> | Remove-RdsSessionHost -Force
Met behulp van de opdracht Force kunt u de sessiehost verwijderen, zelfs als deze gebruikers heeft toegewezen.
Volgende stappen
- Zie Het overzicht, feedback en ondersteuning voor het oplossen van problemen met Azure Virtual Desktop en de escalatiesporen voor een overzicht van het oplossen van problemen.
- Als u problemen wilt oplossen tijdens het maken van een tenant en hostgroep in een Azure Virtual Desktop-omgeving, raadpleegt u het maken van tenants en hostgroepen.
- Zie de configuratie van de virtuele machine van de sessiehost om problemen op te lossen tijdens het configureren van een virtuele machine (VM) in Azure Virtual Desktop.
- Zie Azure Virtual Desktop-serviceverbindingen om problemen met Azure Virtual Desktop-clientverbindingen op te lossen.
- Als u problemen met Extern bureaublad-clients wilt oplossen, raadpleegt u De extern bureaublad-client oplossen
- Zie de Azure Virtual Desktop-omgeving voor meer informatie over de service.
- Zie Zelfstudie: Problemen met Resource Manager-sjabloonimplementaties oplossen om een zelfstudie voor probleemoplossing te doorlopen.
- Zie Controlebewerkingen met Resource Manager voor meer informatie over controleacties.
- Zie Implementatiebewerkingen weergeven voor meer informatie over acties om de fouten tijdens de implementatie te bepalen.