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 gemaakt door zowel eindgebruikers- als beheeracties en kunnen worden gecategoriseerd in drie hoofdbuckets:
- Feedabonnementsactiviteiten: de eindgebruiker activeert deze activiteiten wanneer ze verbinding proberen te maken met hun feed via Microsoft Extern bureaublad toepassingen.
- Verbinding maken ion-activiteiten: de eindgebruiker activeert deze activiteiten wanneer ze via Microsoft Extern bureaublad toepassingen verbinding proberen te maken met een bureaublad of RemoteApp.
- 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.
Verbinding maken ies 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, downloadt en importeert u de Azure Virtual Desktop PowerShell-module voor gebruik in uw PowerShell-sessie als u dat nog niet hebt gedaan. Voer hierna 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 die tussen haakjes worden vermeld, 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 het verzenden van diagnostische gegevens naar uw werkruimte.
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 -Gedetailleerd 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 intern gecategoriseerd in de service en extern naar 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 op en het tijdsbestek 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 recente informatie beschikt, moet u dit artikel minstens één keer per maand raadplegen.
Foutcodes voor extern beheer
| Numerieke code | Foutcode | Voorgestelde oplossing |
|---|---|---|
| 1322 | Verbinding maken ionFailedNoMappingOfSIDinAD | De gebruiker is geen lid van Microsoft Entra-id. Volg de instructies in Active Directory Beheer istrative Center om ze toe te voegen. |
| 3 | UnauthorizedAccess | 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 | TenantNotFound | 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 | TenantCannotBeRemovedHasSessionHostPools | U kunt een tenant niet verwijderen zolang deze objecten bevat. Verwijder eerst de sessiehostgroepen en probeer het opnieuw. |
| 2000 | HostPoolNotFound | 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 | HostPoolCannotBeRemovedHasApplicationGroups | U kunt een hostgroep niet verwijderen zolang deze objecten bevat. Verwijder eerst alle toepassingsgroepen in de hostgroep. |
| 2004 | HostPoolCannotBeRemovedHasSessionHosts | Verwijder eerst alle sessieshosts voordat u de sessiehostgroep verwijdert. |
| 5001 | SessionHostNotFound | De sessiehost waarop u een query hebt uitgevoerd, is mogelijk offline. Controleer de status van de hostgroep. |
| 5008 | SessionHostUserSessionsExist | U moet alle gebruikers op de sessiehost afmelden voordat u de beoogde beheeractiviteit uitvoert. |
| 6000 | AppGroupNotFound | 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 | RemoteAppNotFound | 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 | PublishedItemsExist | 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 | NameNotValidWhiteSpace | Gebruik geen witruimte in de naam. |
| 8000 | InvalidAuthorizationRoleScope | De ingevoerde rolnaam komt niet overeen met bestaande rolnamen. Controleer de naam van de rol op typfouten en probeer het opnieuw. |
| 8001 | UserNotFound | De ingevoerde gebruikersnaam komt niet overeen met bestaande gebruikersnamen. Controleer de naam op typfouten en probeer het opnieuw. |
| 8005 | UserNotFoundInAAD | De ingevoerde gebruikersnaam komt niet overeen met bestaande gebruikersnamen. Controleer de naam op typfouten en probeer het opnieuw. |
| 8008 | TenantConsentRequired | Volg de instructies hier om toestemming te geven voor uw tenant. |
Foutcodes voor externe verbinding
| Numerieke code | Foutcode | Voorgestelde oplossing |
|---|---|---|
| -2147467259 | Verbinding maken ionFailedAdErrorNoSuchMember | De gebruiker is geen lid van Active Directory. Volg de instructies in Active Directory Beheer istrative Center om ze toe te voegen. |
| -2147467259 | Verbinding maken ionFailedAdTrustedRelationshipFailure | De sessiehost is niet correct gekoppeld aan Active Directory. |
| -2146233088 | Verbinding maken ionFailedUserHasValidSessionButRdshIsUnhealthy | De verbindingen zijn mislukt omdat de sessiehost niet beschikbaar is. Controleer de status van de sessiehost. |
| -2146233088 | Verbinding maken ionFailedClientDisconnect | Als u deze fout regelmatig ziet, controleert u of de computer van de gebruiker is verbonden met het netwerk. |
| -2146233088 | Verbinding maken ionFailedNoHealthyRdshAvailable | De sessie waarmee de hostgebruiker verbinding probeert te maken, is niet in orde. Fouten opsporen in de virtuele machine. |
| -2146233088 | Verbinding maken ionFailedUserNotAuthorized | De gebruiker heeft geen toegang tot de gepubliceerde app of het bureaublad. De fout kan worden weergegeven nadat de beheerder gepubliceerde resources heeft verwijderd. Vraag de gebruiker om de feed te vernieuwen in de toepassing Extern bureaublad. |
| 2 | FileNotFound | De toepassing die de gebruiker probeert te openen, is onjuist geïnstalleerd of ingesteld op een onjuist pad. |
| 3 | InvalidCredentials | 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 maken ionBroken | De verbinding tussen client en gateway of server is verbroken. Er is geen actie nodig, tenzij dit onverwacht gebeurt. |
| 14 | UnexpectedNetworkDisconnect | De verbinding met het netwerk is verbroken. Vraag de gebruiker opnieuw verbinding te maken. |
| 24 | Omgekeerd Verbinding maken Gefaileerd | De virtuele hostmachine heeft geen directe zichtlijn naar RD Gateway. Zorg ervoor dat het IP-adres van de gateway kan worden omgezet. |
| 1322 | Verbinding maken ionFailedNoMappingOfSIDinAD | De gebruiker is geen lid van Active Directory. Volg de instructies in Active Directory Beheer istrative Center om ze toe te voegen. |
Volgende stappen
Zie de Azure Virtual Desktop-omgeving voor meer informatie over rollen in Azure Virtual Desktop.
Zie de PowerShell-referentie voor een lijst met beschikbare PowerShell-cmdlets voor Azure Virtual Desktop.