Delen via


Problemen identificeren en diagnosticeren in Azure Virtual Desktop (klassiek)

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.

Azure Virtual Desktop biedt een diagnostische functie waarmee de beheerder problemen kan identificeren via één interface. De Azure Virtual Desktop-rollen registreren een diagnostische activiteit wanneer een gebruiker communiceert met het systeem. Elk logboek bevat relevante informatie, zoals de Azure Virtual Desktop-rollen die betrokken zijn bij de transactie, foutberichten, tenantgegevens en gebruikersgegevens. Diagnostische activiteiten worden zowel door acties van eindgebruikers als van beheerders gecreëerd en kunnen worden gecategoriseerd in drie hoofdgroepen.

  • Feedabonnementsactiviteiten: de eindgebruiker activeert deze activiteiten wanneer ze verbinding proberen te maken met hun feed via Microsoft Extern bureaublad-toepassingen.
  • Verbindingsactiviteiten: de eindgebruiker activeert deze activiteiten wanneer ze verbinding proberen te maken met een bureaublad of RemoteApp via Microsoft Remote Desktop-toepassingen.
  • Beheeractiviteiten: de beheerder activeert deze activiteiten wanneer ze beheerbewerkingen uitvoeren op het systeem, zoals het maken van hostgroepen, het toewijzen van gebruikers aan toepassingsgroepen en het maken van roltoewijzingen.

Verbindingen die azure Virtual Desktop niet bereiken, worden niet weergegeven in diagnostische resultaten, omdat de functieservice voor diagnostische gegevens zelf deel uitmaakt van Azure Virtual Desktop. Verbindingsproblemen met Azure Virtual Desktop kunnen optreden wanneer de eindgebruiker netwerkverbindingsproblemen ondervindt.

Als u wilt beginnen, u de Azure Virtual Desktop PowerShell-module downloaden en importeren voor gebruik in uw PowerShell-sessie als u dat nog niet hebt gedaan. Voer daarna de volgende cmdlet uit om u aan te melden bij uw account:

Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"

Problemen met PowerShell vaststellen

Azure Virtual Desktop Diagnostics maakt gebruik van slechts één PowerShell-cmdlet, maar bevat veel optionele parameters om problemen te beperken en te isoleren. De volgende secties bevatten de cmdlets die u kunt uitvoeren om problemen vast te stellen. De meeste filters kunnen samen worden toegepast. Waarden tussen haakjes, zoals <tenantName>, moeten worden vervangen door de waarden die van toepassing zijn op uw situatie.

Belangrijk

De diagnostische functie is bedoeld voor probleemoplossing voor één gebruiker. Alle query's die PowerShell gebruiken, moeten de parameters -UserName of -ActivityID bevatten. Gebruik Log Analytics voor bewakingsmogelijkheden. Zie Log Analytics gebruiken voor de diagnostische functie voor meer informatie over hoe u diagnostische gegevens naar uw werkruimte kunt verzenden.

Diagnostische activiteiten filteren op gebruiker

De parameter -UserName retourneert een lijst met diagnostische activiteiten die door de opgegeven gebruiker zijn geïnitieerd, zoals wordt weergegeven in de volgende voorbeeld-cmdlet.

Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN>

De parameter -UserName kan ook worden gecombineerd met andere optionele filterparameters.

Diagnostische activiteiten filteren op tijd

U kunt de lijst met geretourneerde diagnostische activiteiten filteren met de parameters -StartTime en -EndTime. De parameter -StartTime retourneert een lijst met diagnostische activiteiten vanaf een specifieke datum, zoals wordt weergegeven in het volgende voorbeeld.

Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -StartTime "08/01/2018"

De parameter -EndTime kan worden toegevoegd aan een cmdlet met de parameter -StartTime om een specifieke periode op te geven waarvoor u resultaten wilt ontvangen. De volgende voorbeeld-cmdlet retourneert een lijst met diagnostische activiteiten tussen 1 augustus en 10 augustus.

Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -StartTime "08/01/2018" -EndTime "08/10/2018"

De parameters -StartTime en -EndTime kunnen ook worden gecombineerd met andere optionele filterparameters.

Diagnostische activiteiten filteren op activiteitstype

U kunt diagnostische activiteiten ook filteren op activiteitstype met de parameter -ActivityType. De volgende cmdlet retourneert een lijst met verbindingen van eindgebruikers:

Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -ActivityType Connection

Met de volgende cmdlet wordt een lijst met beheerdersbeheertaken geretourneerd:

Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityType Management

De cmdlet Get-RdsDiagnosticActivities biedt momenteel geen ondersteuning voor het opgeven van feed als activitytype.

Diagnostische activiteiten filteren op resultaat

U kunt de lijst met geretourneerde diagnostische activiteiten filteren op resultaat met de parameter -Outcome. De volgende voorbeeld-cmdlet retourneert een lijst met geslaagde diagnostische activiteiten.

Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -Outcome Success

Met de volgende voorbeeld-cmdlet wordt een lijst met mislukte diagnostische activiteiten geretourneerd.

Get-RdsDiagnosticActivities -TenantName <tenantName> -Outcome Failure

De parameter -Outcome kan ook worden gecombineerd met andere optionele filterparameters.

Een specifieke diagnostische activiteit ophalen op basis van activiteits-id

De parameter -ActivityId retourneert een specifieke diagnostische activiteit als deze bestaat, zoals wordt weergegeven in de volgende voorbeeld-cmdlet.

Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityId <ActivityIdGuid>

Foutberichten weergeven voor een mislukte activiteit op activiteits-id

Als u de foutberichten voor een mislukte activiteit wilt weergeven, moet u de cmdlet uitvoeren met de parameter -Gedetailleerde. U kunt de lijst met fouten weergeven door de cmdlet Select-Object uit te voeren.

Get-RdsDiagnosticActivities -TenantName <tenantname> -ActivityId <ActivityGuid> -Detailed | Select-Object -ExpandProperty Errors

Gedetailleerde diagnostische activiteiten ophalen

De parameter -Gedetailleerde biedt aanvullende informatie voor elke geretourneerde diagnostische activiteit. De indeling voor elke activiteit is afhankelijk van het type activiteit. De parameter -Detailed kan worden toegevoegd aan elke Get-RdsDiagnosticActivities-query, zoals wordt weergegeven in het volgende voorbeeld.

Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityId <ActivityGuid> -Detailed

Veelvoorkomende foutscenario's

Foutscenario's worden onderverdeeld in intern voor de service en extern aan Azure Virtual Desktop.

  • Intern probleem: hiermee geeft u scenario's op die niet kunnen worden verholpen door de tenantbeheerder en moet worden opgelost als ondersteuningsprobleem. Wanneer u feedback geeft via de Azure Virtual Desktop Tech Community, neemt u de activiteits-id en geschatte periode op van wanneer het probleem zich voordeed.
  • Extern probleem: betrekking hebben op scenario's die kunnen worden beperkt door de systeembeheerder. Deze zijn extern voor Azure Virtual Desktop.

De volgende tabel bevat veelvoorkomende fouten die uw beheerders kunnen tegenkomen.

Notitie

Deze lijst bevat de meest voorkomende fouten en wordt regelmatig bijgewerkt. Om ervoor te zorgen dat u over de meest up-to-datumgegevens beschikt, moet u dit artikel minstens één keer per maand raadplegen.

Foutcodes voor extern beheer

Numerieke code Foutcode Voorgestelde oplossing
1322 VerbindingMisluktGeenMappingVanSIDinAD De gebruiker is geen lid van Microsoft Entra-id. Volg de instructies in Active Directory-beheercentrum om ze toe te voegen.
3 OngeautoriseerdeToegang De gebruiker die de PowerShell-cmdlet met beheerdersrechten probeert uit te voeren, heeft geen machtigingen om dit te doen of de gebruikersnaam verkeerd getypt.
1000 HuurderNietGevonden De tenantnaam die u hebt ingevoerd, komt niet overeen met bestaande tenants. Controleer de naam van de tenant op typfouten en probeer het opnieuw.
1006 HuurderKanNietVerwijderdWordenHeeftSessieHostPools U kunt een tenant niet verwijderen zolang deze objecten bevat. Verwijder eerst de sessiehostgroepen en probeer het opnieuw.
2000 HostpoolNietGevonden De naam van de hostgroep die u hebt ingevoerd, komt niet overeen met bestaande hostgroepen. Controleer de naam van de hostgroep op typefouten en probeer het opnieuw.
2005 HostpoolKanNietWordenVerwijderdHeeftApplicatieGroepen U kunt een hostgroep niet verwijderen zolang deze objecten bevat. Verwijder eerst alle toepassingsgroepen in de hostgroep.
2004 HostPoolKanNietVerwijderdWordenHeeftSessieHosts Verwijder eerst alle sessieshosts voordat u de sessiehostgroep verwijdert.
5001 SessiebeheerderNietGevonden De sessiehost waarop u een query hebt uitgevoerd, is mogelijk offline. Controleer de status van de hostgroep.
5008 BestaandeGebruikerssessiesOpSessiehost U moet alle gebruikers op de sessiehost afmelden voordat u de beoogde beheeractiviteit uitvoert.
6000 AppGroepNietGevonden De naam van de toepassingsgroep die u hebt ingevoerd, komt niet overeen met bestaande toepassingsgroepen. Controleer de naam van de toepassingsgroep op typfouten en probeer het opnieuw.
6022 RemoteAppNietGevonden De remoteApp-naam die u hebt ingevoerd, komt niet overeen met een toepassing. Controleer de naam van RemoteApp op typfouten en probeer het opnieuw.
6010 GepubliceerdeItemsBestaan De naam van de resource die u wilt publiceren, is hetzelfde als een resource die al bestaat. Wijzig de resourcenaam en probeer het opnieuw.
7002 NaamNietGeldigWitruimte Gebruik geen witruimte in de naam.
8000 OngeldigAutorisatieRolBereik De ingevoerde rolnaam komt niet overeen met bestaande rolnamen. Controleer de naam van de rol op typfouten en probeer het opnieuw.
8001 GebruikerNietGevonden De ingevoerde gebruikersnaam komt niet overeen met bestaande gebruikersnamen. Controleer de naam op typfouten en probeer het opnieuw.
8005 GebruikerNietGevondenInAAD De ingevoerde gebruikersnaam komt niet overeen met bestaande gebruikersnamen. Controleer de naam op typfouten en probeer het opnieuw.
8008 HuurderToestemmingVereist Volg de instructies hier om toestemming te geven voor uw tenant.

Foutcodes voor externe verbinding

Numerieke code Foutcode Voorgestelde oplossing
-2147467259 Advertentie verbindingsfout: Geen lid gevonden De gebruiker is geen lid van Active Directory. Volg de instructies in Active Directory-beheercentrum om ze toe te voegen.
-2147467259 VerbindingMisluktVertrouwdeRelatieFout De sessiehost is niet correct gekoppeld aan Active Directory.
-2146233088 VerbindingMisluktGebruikerHeeftGeldigeSessieMaarRdshIsOngezond De verbindingen zijn mislukt omdat de sessiehost niet beschikbaar is. Controleer de status van de sessiehost.
-2146233088 VerbindingMisluktClientVerbindingVerbroken Als u deze fout regelmatig ziet, controleert u of de computer van de gebruiker is verbonden met het netwerk.
-2146233088 VerbindingMisluktGeenGezondeRdshBeschikbaar De sessie waarmee de hostgebruiker verbinding probeert te maken, is niet in orde. Fouten opsporen in de virtuele machine.
-2146233088 VerbindingMisluktGebruikerNietGeautoriseerd De gebruiker heeft geen toestemming om de gepubliceerde app of het bureaublad te openen. De fout kan optreden nadat de beheerder gepubliceerde bronnen heeft verwijderd. Vraag de gebruiker om de feed te vernieuwen in de toepassing Extern bureaublad.
2 BestandNietGevonden De toepassing die de gebruiker probeert te openen, is onjuist geïnstalleerd of ingesteld op een onjuist pad.
3 OngeldigeInloggegevens De gebruikersnaam of het wachtwoord die de gebruiker heeft ingevoerd, komt niet overeen met bestaande gebruikersnamen of wachtwoorden. Controleer de referenties voor typfouten en probeer het opnieuw.
8 Verbinding verbroken De verbinding tussen client en gateway of server is verbroken. Er is geen actie nodig, tenzij dit onverwacht gebeurt.
14 OnverwachteNetwerkVerbindingVerbroken De verbinding met het netwerk is verbroken. Vraag de gebruiker opnieuw verbinding te maken.
24 ReverseConnectFailed De virtuele hostmachine heeft geen directe zichtlijn naar RD Gateway. Zorg ervoor dat het Gateway IP-adres kan worden opgelost.
1322 ConnectionFailedNoMappingOfSIDinAD De gebruiker is geen lid van Active Directory. Volg de instructies in Active Directory-beheercentrum om ze toe te voegen.

Volgende stappen

Zie Azure Virtual Desktop-omgevingvoor meer informatie over rollen in Azure Virtual Desktop.

Zie de PowerShell-verwijzingvoor een lijst met beschikbare PowerShell-cmdlets voor Azure Virtual Desktop.