Identifiera och diagnostisera problem i Azure Virtual Desktop (klassisk)
Viktigt!
Det här innehållet gäller för Azure Virtual Desktop (klassiskt), som inte stöder Azure Resource Manager Azure Virtual Desktop-objekt. Om du försöker hantera Azure Resource Manager Azure Virtual Desktop-objekt kan du läsa den här artikeln.
Azure Virtual Desktop erbjuder en diagnostikfunktion som gör att administratören kan identifiera problem via ett enda gränssnitt. Azure Virtual Desktop-rollerna loggar en diagnostikaktivitet när en användare interagerar med systemet. Varje logg innehåller relevant information, till exempel de Azure Virtual Desktop-roller som ingår i transaktionen, felmeddelanden, klientinformation och användarinformation. Diagnostikaktiviteter skapas av både slutanvändare och administrativa åtgärder och kan kategoriseras i tre huvud bucketar:
- Feed-prenumerationsaktiviteter: Slutanvändaren utlöser dessa aktiviteter när de försöker ansluta till sitt flöde via Microsoft Fjärrskrivbord program.
- Anslut ionsaktiviteter: Slutanvändaren utlöser dessa aktiviteter när de försöker ansluta till ett skrivbord eller RemoteApp via Microsoft Fjärrskrivbord program.
- Hanteringsaktiviteter: Administratören utlöser dessa aktiviteter när de utför hanteringsåtgärder i systemet, till exempel att skapa värdpooler, tilldela användare till programgrupper och skapa rolltilldelningar.
Anslut som inte når Azure Virtual Desktop visas inte i diagnostikresultat eftersom själva diagnostikrolltjänsten är en del av Azure Virtual Desktop. Anslutningsproblem med Azure Virtual Desktop kan inträffa när slutanvändaren har problem med nätverksanslutningen.
Kom igång genom att ladda ned och importera Azure Virtual Desktop PowerShell-modulen som ska användas i PowerShell-sessionen om du inte redan har gjort det. Därefter kör du följande cmdlet för att logga in på ditt konto:
Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"
Diagnostisera problem med PowerShell
Azure Virtual Desktop Diagnostics använder bara en PowerShell-cmdlet men innehåller många valfria parametrar för att begränsa och isolera problem. I följande avsnitt visas de cmdletar som du kan köra för att diagnostisera problem. De flesta filter kan användas tillsammans. Värden som anges inom hakparenteser, till exempel <tenantName>, bör ersättas med de värden som gäller för din situation.
Viktigt!
Diagnostikfunktionen är avsedd för felsökning av en användare. Alla frågor som använder PowerShell måste innehålla parametrarna -UserName eller -ActivityID . För övervakningsfunktioner använder du Log Analytics. Mer information om hur du skickar diagnostikdata till din arbetsyta finns i Använda Log Analytics för diagnostikfunktionen .
Filtrera diagnostikaktiviteter efter användare
Parametern -UserName returnerar en lista över diagnostikaktiviteter som initierats av den angivna användaren, enligt följande exempel-cmdlet.
Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN>
Parametern -UserName kan också kombineras med andra valfria filtreringsparametrar.
Filtrera diagnostikaktiviteter efter tid
Du kan filtrera den returnerade diagnostikaktivitetslistan med parametrarna -StartTime och -EndTime . Parametern -StartTime returnerar en diagnostikaktivitetslista som börjar från ett visst datum, som du ser i följande exempel.
Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -StartTime "08/01/2018"
Parametern -EndTime kan läggas till i en cmdlet med parametern -StartTime för att ange en viss tidsperiod som du vill ta emot resultat för. Följande exempel-cmdlet returnerar en lista över diagnostikaktiviteter mellan 1 augusti och 10 augusti.
Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -StartTime "08/01/2018" -EndTime "08/10/2018"
Parametrarna -StartTime och -EndTime kan också kombineras med andra valfria filtreringsparametrar.
Filtrera diagnostikaktiviteter efter aktivitetstyp
Du kan också filtrera diagnostikaktiviteter efter aktivitetstyp med parametern -ActivityType . Följande cmdlet returnerar en lista över slutanvändaranslutningar:
Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -ActivityType Connection
Följande cmdlet returnerar en lista över administratörshanteringsuppgifter:
Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityType Management
Cmdleten Get-RdsDiagnosticActivities stöder för närvarande inte att ange feed som ActivityType.
Filtrera diagnostikaktiviteter efter resultat
Du kan filtrera den returnerade diagnostikaktivitetslistan efter utfall med parametern -Outcome . Följande exempel-cmdlet returnerar en lista över lyckade diagnostikaktiviteter.
Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -Outcome Success
Följande exempel-cmdlet returnerar en lista över misslyckade diagnostikaktiviteter.
Get-RdsDiagnosticActivities -TenantName <tenantName> -Outcome Failure
Parametern -Outcome kan också kombineras med andra valfria filtreringsparametrar.
Hämta en specifik diagnostikaktivitet efter aktivitets-ID
Parametern -ActivityId returnerar en specifik diagnostikaktivitet om den finns, enligt följande exempel-cmdlet.
Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityId <ActivityIdGuid>
Visa felmeddelanden för en misslyckad aktivitet efter aktivitets-ID
Om du vill visa felmeddelandena för en misslyckad aktivitet måste du köra cmdleten med parametern -Detailed . Du kan visa listan över fel genom att köra cmdleten Select-Object .
Get-RdsDiagnosticActivities -TenantName <tenantname> -ActivityId <ActivityGuid> -Detailed | Select-Object -ExpandProperty Errors
Hämta detaljerade diagnostikaktiviteter
Parametern -Detailed innehåller ytterligare information för varje diagnostikaktivitet som returneras. Formatet för varje aktivitet varierar beroende på dess aktivitetstyp. Parametern -Detailed kan läggas till i valfri Get-RdsDiagnosticActivities-fråga , som du ser i följande exempel.
Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityId <ActivityGuid> -Detailed
Vanliga felscenarier
Felscenarier kategoriseras internt i tjänsten och utanför Azure Virtual Desktop.
- Internt problem: anger scenarier som inte kan åtgärdas av klientadministratören och som måste lösas som ett supportproblem. När du ger feedback via Azure Virtual Desktop Tech Community ska du inkludera aktivitets-ID och ungefärlig tidsram för när problemet inträffade.
- Externt problem: relaterar till scenarier som kan minimeras av systemadministratören. Dessa är externa för Azure Virtual Desktop.
I följande tabell visas vanliga fel som administratörerna kan stöta på.
Kommentar
Den här listan innehåller de vanligaste felen och uppdateras regelbundet. Se till att du har den senaste informationen genom att kontrollera den här artikeln minst en gång i månaden.
Felkoder för extern hantering
| Numerisk kod | Felkod | Föreslagen lösning |
|---|---|---|
| 1322 | Anslut ionFailedNoMappingOfSIDinAD | Användaren är inte medlem i Microsoft Entra-ID. Följ anvisningarna i Active Directory Administrationscenter för att lägga till dem. |
| 3 | Obehörig åtkomst | Användaren som försökte köra den administrativa PowerShell-cmdleten har antingen inte behörighet att göra det eller felstavade sitt användarnamn. |
| 1000 | TenantNotFound | Det klientnamn som du angav matchar inte befintliga klienter. Granska klientorganisationens namn för stavfel och försök igen. |
| 1006 | TenantCannotBeRemovedHasSessionHostPools | Du kan inte ta bort en klientorganisation så länge den innehåller objekt. Ta först bort sessionsvärdpoolerna och försök sedan igen. |
| 2000 | HostPoolNotFound | Namnet på värdpoolen som du angav matchar inte några befintliga värdpooler. Granska namnet på värdpoolen för stavfel och försök igen. |
| 2005 | HostPoolCannotBeRemovedHasApplicationGroups | Du kan inte ta bort en värdpool så länge den innehåller objekt. Ta först bort alla programgrupper i värdpoolen. |
| 2004 | HostPoolCannotBeRemovedHasSessionHosts | Ta bort alla sessionsvärdar först innan du tar bort sessionsvärdpoolen. |
| 5001 | SessionHostNotFound | Sessionsvärden som du frågade kan vara offline. Kontrollera värdpoolens status. |
| 5008 | SessionHostUserSessionsExist | Du måste logga ut alla användare på sessionsvärden innan du kör den avsedda hanteringsaktiviteten. |
| 6000 | AppGroupNotFound | Namnet på programgruppen som du angav matchar inte några befintliga programgrupper. Granska programgruppens namn för stavfel och försök igen. |
| 6022 | RemoteAppNotFound | Namnet på RemoteApp som du angav matchar inte något program. Granska RemoteApp-namnet för stavfel och försök igen. |
| 6010 | PublishedItemsExist | Namnet på den resurs som du försöker publicera är detsamma som en resurs som redan finns. Ändra resursnamnet och försök igen. |
| 7002 | NameNotValidWhiteSpace | Använd inte tomt utrymme i namnet. |
| 8000 | InvalidAuthorizationRoleScope | Det rollnamn som du angav matchar inte några befintliga rollnamn. Granska rollnamnet för stavfel och försök igen. |
| 8001 | UserNotFound | Användarnamnet som du angav matchar inte några befintliga användarnamn. Granska namnet på stavfel och försök igen. |
| 8005 | UserNotFoundInAAD | Användarnamnet som du angav matchar inte några befintliga användarnamn. Granska namnet på stavfel och försök igen. |
| 8008 | TenantConsentRequired | Följ anvisningarna här för att ge medgivande till din klientorganisation. |
Felkoder för extern anslutning
| Numerisk kod | Felkod | Föreslagen lösning |
|---|---|---|
| -2147467259 | Anslut ionFailedAdErrorNoSuchMember | Användaren är inte medlem i Active Directory. Följ anvisningarna i Active Directory Administrationscenter för att lägga till dem. |
| -2147467259 | Anslut ionFailedAdTrustedRelationshipFailure | Sessionsvärden är inte korrekt ansluten till Active Directory. |
| -2146233088 | Anslut ionFailedUserHasValidSessionButRdshIsUnhealthy | Anslutningarna misslyckades eftersom sessionsvärden inte är tillgänglig. Kontrollera sessionsvärdens hälsa. |
| -2146233088 | Anslut ionFailedClientDisconnect | Om du ser det här felet ofta kontrollerar du att användarens dator är ansluten till nätverket. |
| -2146233088 | Anslut ionFailedNoHealthyRdshAvailable | Sessionen som värdanvändaren försökte ansluta till är inte felfri. Felsök den virtuella datorn. |
| -2146233088 | Anslut ionFailedUserNotAuthorized | Användaren har inte behörighet att komma åt den publicerade appen eller skrivbordet. Felet kan visas när administratören har tagit bort publicerade resurser. Be användaren att uppdatera feeden i fjärrskrivbordsprogrammet. |
| 2 | FileNotFound | Programmet som användaren försökte komma åt är antingen felaktigt installerat eller inställt på en felaktig sökväg. |
| 3 | InvalidCredentials | Användarnamnet eller lösenordet som användaren angav matchar inte några befintliga användarnamn eller lösenord. Granska autentiseringsuppgifterna för stavfel och försök igen. |
| 8 | Anslut ionBroken | Anslutningen mellan klient och gateway eller server har avbrutits. Ingen åtgärd behövs om det inte sker oväntat. |
| 14 | UnexpectedNetworkDisconnect | Anslutningen till nätverket har tagits bort. Be användaren att ansluta igen. |
| 24 | Omvänd Anslut Failed | Den virtuella värddatorn har ingen direkt siktlinje till fjärrskrivbordsgatewayen. Kontrollera att gatewayens IP-adress kan matchas. |
| 1322 | Anslut ionFailedNoMappingOfSIDinAD | Användaren är inte medlem i Active Directory. Följ anvisningarna i Active Directory Administrationscenter för att lägga till dem. |
Nästa steg
Mer information om roller i Azure Virtual Desktop finns i Azure Virtual Desktop-miljön.
En lista över tillgängliga PowerShell-cmdletar för Azure Virtual Desktop finns i PowerShell-referensen.
Feedback
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för