Azure Sanal Masaüstü'nde sorunları tanımlama ve tanılama (klasik)
Önemli
Bu içerik, Azure Resource Manager Azure Sanal Masaüstü nesnelerini desteklemeyen Azure Sanal Masaüstü (klasik) için geçerlidir. Azure Resource Manager Azure Sanal Masaüstü nesnelerini yönetmeye çalışıyorsanız bu makaleye bakın.
Azure Sanal Masaüstü, yöneticinin sorunları tek bir arabirim üzerinden tanımlamasını sağlayan bir tanılama özelliği sunar. Azure Sanal Masaüstü rolleri, bir kullanıcı sistemle her etkileşimde olduğunda tanılama etkinliğini günlüğe kaydeder. Her günlük, işlemde yer alan Azure Sanal Masaüstü rolleri, hata iletileri, kiracı bilgileri ve kullanıcı bilgileri gibi ilgili bilgileri içerir. Tanılama etkinlikleri hem son kullanıcı hem de yönetim eylemleri tarafından oluşturulur ve üç ana demet halinde kategorilere ayırılabilir:
- Akış aboneliği etkinlikleri: Son kullanıcı, Microsoft Uzak Masaüstü uygulamalar aracılığıyla akışına bağlanmaya çalıştığında bu etkinlikleri tetikler.
- Bağlan etkinlikleri: Son kullanıcı, Microsoft Uzak Masaüstü uygulamalar aracılığıyla bir masaüstüne veya RemoteApp'e bağlanmaya çalıştığında bu etkinlikleri tetikler.
- Yönetim etkinlikleri: Yönetici, konak havuzları oluşturma, uygulama gruplarına kullanıcı atama ve rol atamaları oluşturma gibi sistem üzerinde yönetim işlemleri gerçekleştirdiklerinde bu etkinlikleri tetikler.
Tanılama rolü hizmeti Azure Sanal Masaüstü'ne ait olduğundan Azure Sanal Masaüstü'ne ulaşmayan Bağlan yonları tanılama sonuçlarında gösterilmez. Azure Sanal Masaüstü bağlantı sorunları, son kullanıcı ağ bağlantısı sorunları yaşadığında oluşabilir.
Başlamak için henüz yapmadıysanız PowerShell oturumunuzda kullanmak üzere Azure Sanal Masaüstü PowerShell modülünü indirin ve içeri aktarın. Bundan sonra, hesabınızda oturum açmak için aşağıdaki cmdlet'i çalıştırın:
Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"
PowerShell ile ilgili sorunları tanılama
Azure Sanal Masaüstü Tanılama yalnızca bir PowerShell cmdlet'i kullanır, ancak sorunları daraltmaya ve yalıtmaya yardımcı olmak için birçok isteğe bağlı parametre içerir. Aşağıdaki bölümlerde, sorunları tanılamak için çalıştırabileceğiniz cmdlet'ler listelanmıştır. Filtrelerin çoğu birlikte uygulanabilir. gibi köşeli ayraç içinde listelenen değerler, <tenantName>durumunuz için geçerli olan değerlerle değiştirilmelidir.
Önemli
Tanılama özelliği tek kullanıcılı sorun gidermeye yöneliktir. PowerShell kullanan tüm sorgular -UserName veya -ActivityID parametrelerini içermelidir. İzleme özellikleri için Log Analytics'i kullanın. Çalışma alanınıza tanılama verileri gönderme hakkında daha fazla bilgi için bkz . Tanılama özelliği için Log Analytics'i kullanma.
Tanılama etkinliklerini kullanıcıya göre filtreleme
-UserName parametresi, aşağıdaki örnek cmdlet'te gösterildiği gibi belirtilen kullanıcı tarafından başlatılan tanılama etkinliklerinin listesini döndürür.
Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN>
-UserName parametresi diğer isteğe bağlı filtreleme parametreleriyle de birleştirilebilir.
Tanılama etkinliklerini zamana göre filtreleme
Döndürülen tanılama etkinliği listesini -StartTime ve -EndTime parametreleriyle filtreleyebilirsiniz. -StartTime parametresi, aşağıdaki örnekte gösterildiği gibi belirli bir tarihten başlayarak bir tanılama etkinliği listesi döndürür.
Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -StartTime "08/01/2018"
Sonuçları almak istediğiniz belirli bir süreyi belirtmek için -EndTime parametresi -StartTime parametresiyle bir cmdlet'e eklenebilir. Aşağıdaki örnek cmdlet, 1 Ağustos ile 10 Ağustos arasındaki tanılama etkinliklerinin listesini döndürür.
Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -StartTime "08/01/2018" -EndTime "08/10/2018"
-StartTime ve -EndTime parametreleri diğer isteğe bağlı filtreleme parametreleriyle de birleştirilebilir.
Tanılama etkinliklerini etkinlik türüne göre filtreleme
Tanılama etkinliklerini -ActivityType parametresiyle etkinlik türüne göre de filtreleyebilirsiniz. Aşağıdaki cmdlet, son kullanıcı bağlantılarının listesini döndürür:
Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -ActivityType Connection
Aşağıdaki cmdlet yönetici yönetim görevlerinin listesini döndürür:
Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityType Management
Get-RdsDiagnosticActivities cmdlet'i şu anda ActivityType olarak Akış belirtmeyi desteklememektedir.
Tanılama etkinliklerini sonuca göre filtreleme
Döndürülen tanılama etkinliği listesini -Outcome parametresiyle sonuca göre filtreleyebilirsiniz. Aşağıdaki örnek cmdlet başarılı tanılama etkinliklerinin listesini döndürür.
Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -Outcome Success
Aşağıdaki örnek cmdlet başarısız tanılama etkinliklerinin listesini döndürür.
Get-RdsDiagnosticActivities -TenantName <tenantName> -Outcome Failure
-Outcome parametresi diğer isteğe bağlı filtreleme parametreleriyle de birleştirilebilir.
Etkinlik kimliğine göre belirli bir tanılama etkinliğini alma
-ActivityId parametresi, aşağıdaki örnek cmdlet'inde gösterildiği gibi, varsa belirli bir tanılama etkinliğini döndürür.
Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityId <ActivityIdGuid>
Etkinlik kimliğine göre başarısız bir etkinliğin hata iletilerini görüntüleme
Başarısız bir etkinliğin hata iletilerini görüntülemek için cmdlet'ini -Detailed parametresiyle çalıştırmanız gerekir. Select-Object cmdlet'ini çalıştırarak hata listesini görüntüleyebilirsiniz.
Get-RdsDiagnosticActivities -TenantName <tenantname> -ActivityId <ActivityGuid> -Detailed | Select-Object -ExpandProperty Errors
Ayrıntılı tanılama etkinliklerini alma
-Detailed parametresi, döndürülen her tanılama etkinliği için ek ayrıntılar sağlar. Her etkinliğin biçimi, etkinlik türüne bağlı olarak değişir. - Detailed parametresi, aşağıdaki örnekte gösterildiği gibi herhangi bir Get-RdsDiagnosticActivities sorgusuna eklenebilir.
Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityId <ActivityGuid> -Detailed
Yaygın hata senaryoları
Hata senaryoları hizmette ve azure sanal masaüstü dışında kategorize edilir.
- İç Sorun: Kiracı yöneticisi tarafından azaltılmayan ve destek sorunu olarak çözülmesi gereken senaryoları belirtir. Azure Sanal Masaüstü Teknoloji Topluluğu aracılığıyla geri bildirim sağlarken, etkinlik kimliğini ve sorunun oluştuğu yaklaşık zaman dilimini ekleyin.
- Dış Sorun: Sistem yöneticisi tarafından azaltılabilir senaryolarla ilgilidir. Bunlar Azure Sanal Masaüstü'ne haricidir.
Aşağıdaki tabloda yöneticilerinizin karşılaşabileceği yaygın hatalar listelenir.
Dekont
Bu liste en yaygın hataları içerir ve düzenli bir tempoda güncelleştirilir. En güncel bilgilere sahip olduğunuzdan emin olmak için bu makaleyi ayda en az bir kez tekrar gözden geçirmeyi unutmayın.
Dış yönetim hata kodları
| Sayısal kod | Hata kodu | Önerilen çözüm |
|---|---|---|
| 1322 | Bağlan ionFailedNoMappingOfSIDinAD | Kullanıcı, Microsoft Entra Id üyesi değildir. Eklemek için Active Directory Yönetici istrative Center'daki yönergeleri izleyin. |
| 3 | UnauthorizedAccess | Yönetici PowerShell cmdlet'ini çalıştırmayı deneyen kullanıcının bunu yapma izni yok veya kullanıcı adını yanlış yazdı. |
| 1000 | TenantNotFound | Girdiğiniz kiracı adı mevcut kiracılarla eşleşmiyor. Yazım hataları için kiracı adını gözden geçirin ve yeniden deneyin. |
| 1006 | TenantCannotBeRemovedHasSessionHostPools | Nesneleri içerdiği sürece kiracıyı silemezsiniz. Önce oturum konak havuzlarını silin, sonra yeniden deneyin. |
| 2000 | HostPoolNotFound | Girdiğiniz konak havuzu adı, mevcut konak havuzları ile eşleşmiyor. Yazım hataları için konak havuzu adını gözden geçirin ve yeniden deneyin. |
| 2005 | HostPoolCannotBeRemovedHasApplicationGroups | Nesneler içerdiği sürece konak havuzunu silemezsiniz. Önce konak havuzundaki tüm uygulama gruplarını kaldırın. |
| 2004 | HostPoolCannotBeRemovedHasSessionHosts | Oturum konak havuzunu silmeden önce tüm oturum konaklarını kaldırın. |
| 5001 | SessionHostNotFound | Sorguladığınız oturum konağı çevrimdışı olabilir. Konak havuzunun durumunu denetleyin. |
| 5008 | SessionHostUserSessionsExist | Hedeflenen yönetim etkinliğinizi yürütmeden önce oturum ana bilgisayarındaki tüm kullanıcıların oturumunu kapatmanız gerekir. |
| 6000 | AppGroupNotFound | Girdiğiniz uygulama grubu adı, mevcut uygulama gruplarıyla eşleşmiyor. Yazım hataları için uygulama grubu adını gözden geçirin ve yeniden deneyin. |
| 6022 | RemoteAppNotFound | Girdiğiniz RemoteApp adı hiçbir uygulamayla eşleşmiyor. Yazım hataları için RemoteApp adını gözden geçirin ve yeniden deneyin. |
| 6010 | PublishedItemsExist | Yayımlamaya çalıştığınız kaynağın adı, zaten var olan bir kaynakla aynıdır. Kaynak adını değiştirin ve yeniden deneyin. |
| 7002 | NameNotValidWhiteSpace | Adında boşluk kullanmayın. |
| 8000 | InvalidAuthorizationRoleScope | Girdiğiniz rol adı, mevcut rol adları ile eşleşmiyor. Yazım hataları için rol adını gözden geçirin ve yeniden deneyin. |
| 8001 | UserNotFound | Girdiğiniz kullanıcı adı, var olan hiçbir kullanıcı adıyla eşleşmiyor. Yazım hataları için adı gözden geçirin ve yeniden deneyin. |
| 8005 | UserNotFoundInAAD | Girdiğiniz kullanıcı adı, var olan hiçbir kullanıcı adıyla eşleşmiyor. Yazım hataları için adı gözden geçirin ve yeniden deneyin. |
| 8008 | TenantConsentRequired | Kiracınız için onay sağlamak için buradaki yönergeleri izleyin. |
Dış bağlantı hata kodları
Sonraki adımlar
Azure Sanal Masaüstü'nde roller hakkında daha fazla bilgi edinmek için bkz . Azure Sanal Masaüstü ortamı.
Azure Sanal Masaüstü için kullanılabilir PowerShell cmdlet'lerinin listesini görmek için bkz . PowerShell başvurusu.