Session Hosts - Get

Hizmet:

Desktop Virtualization

API Sürümü:

2025-10-10

Bir oturum ana bilgisayarı edinin.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHosts/{sessionHostName}?api-version=2025-10-10

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	Belirtilen kaynak grubu içindeki konak havuzunun adı
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.
sessionHostName	path	True	string minLength: 3 maxLength: 48 pattern: ^[A-Za-z0-9@.\-_ ]*$	Belirtilen konak havuzu içindeki oturum konağının adı
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	SessionHost	Oturum hostu başarıyla alındı.
Other Status Codes	CloudError	İşlemin neden başarısız olduğunu açıklayan otomasyon hatası yanıtı.

Örnekler

SessionHost_Get

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostPool1/sessionHosts/sessionHost1.microsoft.com?api-version=2025-10-10

Örnek yanıt

Durum kodu:

200

{
  "name": "sessionHost1.microsoft.com",
  "id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostPool1/sessionHosts/sessionHost1.microsoft.com",
  "type": "Microsoft.DesktopVirtualization/hostPools/sessionHosts",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "objectId": "7877fb31-4bde-49fd-9df3-c046e0ec5325",
    "lastHeartBeat": "2008-09-22T14:01:54.9571247Z",
    "sessions": 1,
    "agentVersion": "1.0.0.1391",
    "allowNewSession": true,
    "assignedUser": "user1@microsoft.com",
    "status": "Available",
    "statusTimestamp": "2008-09-22T14:01:54.9571247Z",
    "osVersion": "10.0.17763",
    "sxSStackVersion": "rdp-sxs190816002",
    "updateState": "Succeeded",
    "lastUpdateTime": "2008-09-22T14:01:54.9571247Z",
    "updateErrorMessage": "",
    "virtualMachineId": "29491b54-c033-4dec-b09a-18bf0ebafaef",
    "friendlyName": "friendly",
    "resourceId": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.Compute/virtualMachines/sessionHost1",
    "sessionHostHealthCheckResults": [
      {
        "healthCheckName": "DomainJoinedCheck",
        "healthCheckResult": "HealthCheckSucceeded",
        "additionalFailureDetails": {
          "message": "SessionHost healthy: is joined to domain ≤wvdarmtest1.net≥",
          "errorCode": 0,
          "lastHealthCheckDateTime": "2021-01-14T02:09:37.6236843Z"
        }
      }
    ]
  }
}

Tanımlar

Name	Description
CloudError	Bulut hata nesnesi.
CloudErrorProperties	Bulut hatası nesne özellikleri.
createdByType	Kaynağı oluşturan kimliğin türü.
HealthCheckName	Gerçekleştirilen sistem durumu denetimi işleminin adını temsil eder.
HealthCheckResult	Gerçekleştirdiğimiz sistem durumu denetiminin Sağlık durumunu temsil eder.
SessionHost	Bir SessionHost tanımını temsil eder.
SessionHostHealthCheckFailureDetails	Hatayla ilgili ayrıntıları içerir.
SessionHostHealthCheckReport	Oturum ana bilgisayar bilgileri için rapor.
Status	SessionHost için durum.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
UpdateState	Bir SessionHost'un durumunu güncelleştirin.

CloudError

Nesne

Bulut hata nesnesi.

Name	Tür	Description
error	CloudErrorProperties	Bulut hatası nesne özellikleri.

CloudErrorProperties

Nesne

Bulut hatası nesne özellikleri.

Name	Tür	Description
code	string	Hata kodu
message	string	İşlemin neden başarısız olduğunu gösteren hata iletisi.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

HealthCheckName

Numaralandırma

Gerçekleştirilen sistem durumu denetimi işleminin adını temsil eder.

Değer	Description
DomainJoinedCheck	SessionHost'un bir etki alanına katıldığını doğrular. Bu denetim başarısız olursa, SessionHost etki alanına katılmazsa hiçbir bağlantı başarılı olamayacağından önemli olarak sınıflandırılır. (Şu anda etkin)
DomainTrustCheck	SessionHost'un, oturum oluşturulduğunda bağlantı zamanında SessionHost'ta kimlik doğrulamasını engelleyecek etki alanı güven sorunlarıyla karşılaşmadığını doğrular. Bu kontrol başarısız olursa, SessionHost'ta kimlik doğrulaması için etki alanına ulaşamazsak hiçbir bağlantı başarılı olamayacağından önemli olarak sınıflandırılır. (Şu anda etkin)
FSLogixHealthCheck	Kullanıcı profillerinin oturuma yüklendiğinden emin olmak için FSLogix hizmetinin çalışır durumda olduğunu doğrular. Bu denetim başarısız olursa, bağlantı başarılı olsa bile, kullanıcı profili yüklenemediğinden ve kullanıcı oturumda geçici bir profil alacağından kullanıcı deneyimi kötü olduğu için önemli olarak sınıflandırılır. (Şu anda Devre Dışı)
SxSStackListenerCheck	Bağlantıların başarılı olabilmesi için SxS yığınının çalışır durumda olduğunu doğrular. Bu denetim başarısız olursa, SxS yığını hazır değilse hiçbir bağlantı başarılı olamayacağından önemli olarak sınıflandırılır. (Şu anda etkin)
UrlsAccessibleCheck	Gerekli WVD hizmetine ve Cenevre URL'lerine SessionHost'tan erişilebildiğini doğrular. Bu URL'ler şunlardır: RdTokenUri, RdBrokerURI, RdDiagnosticsUri ve aracı izleme (cenevre) için depolama blob URL'leri. Bu kontrol başarısız olursa, önemli değildir ve makine hala bağlantılara hizmet verebilir, ana sorun, izleme aracısının sıcak yol verilerini (günlükler, işlemler...) depolayamaması olabilir. (Şu anda Devre Dışı)
MonitoringAgentCheck	Gerekli Cenevre ajanının çalıştığını doğrular. Bu denetim başarısız olursa, önemli değildir ve makine hala bağlantılara hizmet verebilir, asıl sorun izleme aracısının eksik olması veya (muhtemelen) eski sürümü çalıştırması olabilir. (Şu anda etkin)
DomainReachable	SessionHost'un katıldığı etki alanının hala erişilebilir olduğunu doğrular. Bu denetim başarısız olursa, SessionHost'un katıldığı etki alanına bağlantı sırasında ulaşılamıyorsa, hiçbir bağlantı başarılı olamayacağından önemli olarak sınıflandırılır. (Şu anda Devre Dışı)
WebRTCRedirectorCheck	WebRTCRedirector bileşeninin iyi durumda olup olmadığını doğrular. WebRTCRedirector bileşeni, Microsoft Teams'de video ve ses performansını optimize etmek için kullanılır. Bu, bileşenin hala çalışıp çalışmadığını ve daha yüksek bir sürümün mevcut olup olmadığını kontrol eder. Bu kontrol başarısız olursa, önemli değildir ve makine hala bağlantılara hizmet verebilir, ana sorun WebRTCRedirector bileşeninin yeniden başlatılması veya güncellenmesi gerekebilir. (Şu anda Devre Dışı)
SupportedEncryptionCheck	SecurityLayer kayıt anahtarının değerini doğrular. Değer 0 (SecurityLayer.RDP) ise, bu denetim Hata kodu = NativeMethodErrorCode.E_FAIL ile başarısız olur ve önemli olur. Değer 1 (SecurityLayer.Negotiate) ise, bu denetim Hata kodu = NativeMethodErrorCode.ERROR_SUCCESS ile başarısız olur ve önemli değildir. (Şu anda Devre Dışı)
MetaDataServiceCheck	Meta veri hizmetinin erişilebilir olduğunu doğrular ve işlem özelliklerini döndürür. (Şu anda etkin)
AppAttachHealthCheck	AppAttachService'in iyi durumda olduğunu doğrular (paket hazırlama sırasında herhangi bir sorun yaşanmamıştır). AppAttachService, kiracı yöneticisi tarafından kurulan MSIX uygulamalarının aşamalanması/kaydedilmesi (ve nihayetinde kayıttan çıkarılması) için kullanılır. Bu, bileşenin paket aşamalama sırasında herhangi bir arıza olup olmadığını kontrol eder. Hazırlamadaki hatalar, bazı MSIX uygulamalarının son kullanıcı için düzgün çalışmasını engeller. Bu kontrol başarısız olursa, önemli değildir ve makine hala bağlantılara hizmet verebilir, asıl sorun bazı uygulamaların son kullanıcılar için çalışmaması olabilir. (Şu anda etkin)

HealthCheckResult

Numaralandırma

Gerçekleştirdiğimiz sistem durumu denetiminin Sağlık durumunu temsil eder.

Değer	Description
Unknown	Sağlık denetimi sonucu şu anda bilinmiyor.
HealthCheckSucceeded	Sağlık kontrolünden geçildi.
HealthCheckFailed	Sistem durumu denetimi başarısız oldu.
SessionHostShutdown	Bir Kapatma bildirimi aldık.

SessionHost

Nesne

Bir SessionHost tanımını temsil eder.

Name	Tür	Description
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Kaynağın adı
properties.agentVersion	string	SessionHost'taki aracının sürümü.
properties.allowNewSession	boolean	Yeni bir oturuma izin verin.
properties.assignedUser	string	Kullanıcı SessionHost'a atandı.
properties.friendlyName	string	SessionHost'un kolay adı
properties.lastHeartBeat	string (date-time)	SessionHost'tan son kalp atışı.
properties.lastUpdateTime	string (date-time)	Son güncellemenin zaman damgası.
properties.objectId	string	SessionHost'un ObjectId'si. (dahili kullanım)
properties.osVersion	string	Oturum ana bilgisayarındaki işletim sistemi sürümü.
properties.resourceId	string	SessionHost'un temel alınan sanal makinesinin Kaynak Kimliği.
properties.sessionHostHealthCheckResults	SessionHostHealthCheckReport[]	SessionHostHealthCheckReports Listesi
properties.sessions	integer (int32)	SessionHost'taki oturum sayısı.
properties.status	Status	SessionHost için durum.
properties.statusTimestamp	string (date-time)	Durumun zaman damgası.
properties.sxSStackVersion	string	Oturum ana bilgisayarındaki yan yana yığının sürümü.
properties.updateErrorMessage	string	Hata iletisi.
properties.updateState	UpdateState	Bir SessionHost'un durumunu güncelleştirin.
properties.virtualMachineId	string	SessionHost'un temel alınan sanal makinesinin Sanal Makine Kimliği.
systemData	systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

SessionHostHealthCheckFailureDetails

Nesne

Hatayla ilgili ayrıntıları içerir.

Name	Tür	Description
errorCode	integer (int32)	Arızaya karşılık gelen hata kodu.
lastHealthCheckDateTime	string (date-time)	Son güncellemenin zaman damgası.
message	string	Hata mesajı: neyin yanlış olduğuna ve nasıl kurtarılacağına dair ipuçları.

SessionHostHealthCheckReport

Nesne

Oturum ana bilgisayar bilgileri için rapor.

Name	Tür	Description
additionalFailureDetails	SessionHostHealthCheckFailureDetails	Arıza hakkında ek ayrıntılı bilgi.
healthCheckName	HealthCheckName	Gerçekleştirilen sistem durumu denetimi işleminin adını temsil eder.
healthCheckResult	HealthCheckResult	Gerçekleştirdiğimiz sistem durumu denetiminin Sağlık durumunu temsil eder.

Status

Numaralandırma

SessionHost için durum.

Değer	Description
Available	Oturum Ana Bilgisayarı tüm sistem durumu denetimlerini geçmiştir ve bağlantıları işlemek için kullanılabilir.
Unavailable	Oturum Ana Bilgisayarı kapalı veya kritik sistem durumu denetimlerinde başarısız oldu, bu da hizmetin bağlantıları bu oturum ana bilgisayarına yönlendirememesine neden oluyor. Bunun önceki 'NoHeartBeat' durumunun yerini aldığını unutmayın.
Shutdown	Oturum Ana Bilgisayarı kapatılıyor - RD Aracısı oturum ana bilgisayarının durdurulduğunu veya serbest bırakıldığını bildirdi.
Disconnected	Oturum Ana Bilgisayarı şu anda bağlantısı kesildiği için kullanılamıyor.
Upgrading	Şu anda RDAgent/yan yana yığın yükseltmesi devam ettiğinden Oturum Ana Bilgisayarı kullanılamıyor. Not: Bu durum, yükseltme tamamlandığında ve ana bilgisayar bağlantıları kabul edebildiğinde kaldırılacaktır.
UpgradeFailed	Kritik bileşen yükseltmesi (aracı, yan yana yığın vb.) başarısız olduğu için Oturum Ana Bilgisayarı kullanılamıyor.
NoHeartbeat	Oturum Sahibinin kalbi atmıyor.
NotJoinedToDomain	SessionHost etki alanına katılmamış.
DomainTrustRelationshipLost	SessionHost'un etki alanı güven ilişkisi kayboldu
SxSStackListenerNotReady	SessionHost'ta yüklü olan SxS yığını bağlantıları almaya hazır değil.
FSLogixNotHealthy	FSLogix, oturum ana bilgisayarında iyi durumda olmayan bir durumda.
NeedsAssistance	Yöneticilere uç noktalarındaki sistem durumunun düzeltilmesi gerektiğini bildirmek için yeni durum. Bu sorunlar önemli olmadığından bağlantılar başarısız olmayabilir.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

UpdateState

Numaralandırma

Bir SessionHost'un durumunu güncelleştirin.

Değer	Description
Initial
Pending
Started
Succeeded
Failed