Session Hosts - Get

Oturum ana bilgisayarı al.

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

URI Parametreleri

Name In Required Type Description
hostPoolName
path True
  • string

Belirtilen kaynak grubu içindeki konak havuzunun adı

resourceGroupName
path True
  • string

Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir.

sessionHostName
path True
  • string

Belirtilen konak havuzu içindeki oturum ana bilgisayarının adı

subscriptionId
path True
  • string

Hedef aboneliğin kimliği.

api-version
query True
  • string

Bu işlem için kullanmak üzere API sürümü.

Yanıtlar

Name Type Description
200 OK

Oturum ana bilgisayarı başarıyla alındı.

Other Status Codes

İşlem neden başarısız olduğunu açıklayan Otomasyon hatası yanıtı.

Örnekler

SessionHost_Get

Sample Request

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

Sample Response

{
  "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",
  "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",
    "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

CloudError
CloudErrorProperties
HealthCheckName

Gerçekleştirilen durum denetimi işlemi adını temsil eder.

HealthCheckResult

Gerçekleştirimiz durum denetiminin Durum durumunu temsil eder.

SessionHost

SessionHost tanımını temsil eder.

SessionHostHealthCheckFailureDetails

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

SessionHostHealthCheckReport

Oturum ana bilgisayar bilgileri için rapor.

Status

SessionHost durumu.

UpdateState

SessionHost'u güncelleştirme durumu.

CloudError

Name Type Description
error

CloudErrorProperties

Name Type Description
code
  • string

Hata kodu

message
  • string

İşlem neden başarısız olduğunu belirten hata iletisi.

HealthCheckName

Gerçekleştirilen durum denetimi işlemi adını temsil eder.

Name Type Description
AppAttachHealthCheck
  • string

AppAttachService'in iyi olduğunu doğrular (paket hazırlama sırasında hiçbir sorun yoktu). AppAttachService, kiracı yöneticisi tarafından ayarlanmış MSIX uygulamalarının hazırlama/kayıt (ve son kayıt dışı/eskitme) işlemlerini etkinleştirmek için kullanılır. Bu, bileşenin paket hazırlama sırasında herhangi bir hata olup olmadığını denetler. Hazırlama hatalarında bazı MSIX uygulamalarının son kullanıcı için düzgün çalışması önlenebilir. Bu denetim başarısız olursa, önemli değildir ve makine hala bağlantılara hizmet sunuyor olabilir. Ana sorun, son kullanıcılar için bazı uygulamaların çalışmayacak olması olabilir.

DomainJoinedCheck
  • string

SessionHost'u bir etki alanına katıldığını doğrular. Bu denetim başarısız olursa, SessionHost etki alanına katılmamışsa hiçbir bağlantı başarılı olamayacak şekilde önemli olarak sınıflandırılır.

DomainReachable
  • string

SessionHost'ların katıldığı etki alanının hala erişilemez olduğunu doğrular. Bu denetim başarısız olursa önemli olarak sınıflandırılır çünkü SessionHost'a katılan etki alanı bağlantı sırasında ulaşılamazsa hiçbir bağlantı başarılı olamaz.

DomainTrustCheck
  • string

SessionHost'ta oturum oluşturulduğunda bağlantı sırasında SessionHost'ta kimlik doğrulamasını önleyen etki alanı güven sorunları yaşamaması doğrular. Bu denetim başarısız olursa, SessionHost'ta kimlik doğrulaması için etki alanına erişemezsek hiçbir bağlantı başarılı olamayacak şekilde önemli olarak sınıflandırılır.

FSLogixHealthCheck
  • string

Oturumda kullanıcıların profillerini yüklendiğinden emin olmak için FSLogix hizmetinin çalışıyor olduğunu doğrular. Bu denetim başarısız olursa, bağlantı başarılı olsa bile önemli olarak sınıflandırılır, kullanıcı profili yüklenemiyor ve kullanıcı oturumda geçici bir profil alamayacak için kullanıcı deneyimi kötüdür.

MetaDataServiceCheck
  • string

Meta veri hizmetinin erişilebilir olduğunu doğrular ve işlem özelliklerini geri döner.

MonitoringAgentCheck
  • string

Gerekli Geneva aracısını çalıştırarak doğrular. Bu denetim başarısız olursa, önemli değildir ve makine hala bağlantılara hizmet ediyor olabilir, ana sorun izleme aracılarının eksik olması veya eski bir sürümün (büyük olasılıkla) çalışıyor olması olabilir.

SupportedEncryptionCheck
  • string

SecurityLayer kayıt anahtarının değerini doğrular. Değer 0 (SecurityLayer.RDP) ise bu denetim Hata kodu = hata NativeMethodErrorCode.E_FAIL ve önemli hatasıyla başarısız olur. Değer 1 (SecurityLayer.Negotiate) ise bu denetim Hata kodu = NativeMethodErrorCode.ERROR_SUCCESS ve önemli değil hatasıyla başarısız olur.

SxSStackListenerCheck
  • string

Bağlantıların başarılı olması için SxS yığınının açık ve çalışıyor olduğunu doğrular. Bu denetim başarısız olursa, SxS yığını hazır olmazsa hiçbir bağlantı başarılı olamayacak şekilde önemli olarak sınıflandırılır.

UrlsAccessibleCheck
  • string

Gerekli WVD hizmetinin ve Geneva URL'lerine SessionHost'tan erişilebilir olduğunu doğrular. Bu URL'ler: Aracı izleme için RdTokenUri, RdBrokerURI, RdDiagnosticsUri ve depolama blob URL'leri (Geneva). Bu denetim başarısız olursa, önemli değildir ve makine hala bağlantılara hizmet verir, ana sorun izleme aracılarının sıcak yol verilerini (günlükler, işlemler ...) depolayamadığı olabilir.

WebRTCRedirectorCheck
  • string

WebRTCRedirector bileşeninin iyi olup olmadığını doğrular. WebRTCRedirector bileşeni, Microsoft Teams'de video ve ses performansını iyileştirmek için kullanılır. Bu, bileşenin hala çalışıyor olup olmadığını ve daha yüksek bir sürüm olup olmadığını denetler. Bu denetim başarısız olursa, önemli değildir ve makine bağlantılara hizmet veremezse ana sorun WebRTCRedirector bileşeninin yeniden başlatılması veya güncelleştirilmiş olması olabilir.

HealthCheckResult

Gerçekleştirimiz durum denetiminin Durum durumunu temsil eder.

Name Type Description
HealthCheckFailed
  • string

Durum denetimi başarısız oldu.

HealthCheckSucceeded
  • string

Durum denetimi geçirildi.

SessionHostShutdown
  • string

Kapatma bildirimi aldık.

Unknown
  • string

Durum denetimi sonucu şu anda bilinmiyor.

SessionHost

SessionHost tanımını temsil eder.

Name Type Description
id
  • string

Kaynak için tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Kaynağın adı

properties.agentVersion
  • string

SessionHost'ta aracı sürümü.

properties.allowNewSession
  • boolean

Yeni bir oturuma izin ver.

properties.assignedUser
  • string

SessionHost'a atanan kullanıcı.

properties.lastHeartBeat
  • string

SessionHost'tan son kalp atış.

properties.lastUpdateTime
  • string

Son güncelleştirmenin zaman damgası.

properties.objectId
  • string

SessionHost ObjectId. (iç kullanım)

properties.osVersion
  • string

Oturum ana bilgisayarı üzerinde işletim sistemi sürümü.

properties.resourceId
  • string

SessionHost'un temel alınan sanal makinesinin kaynak kimliği.

properties.sessionHostHealthCheckResults

SessionHostHealthCheckReports Listesi

properties.sessions
  • integer

SessionHost'ta oturum sayısı.

properties.status

SessionHost durumu.

properties.statusTimestamp
  • string

Durumun zaman damgası.

properties.sxSStackVersion
  • string

Oturum ana bilgisayar üzerinde yan yana yığının sürümü.

properties.updateErrorMessage
  • string

Hata iletisi.

properties.updateState

SessionHost'u güncelleştirme durumu.

properties.virtualMachineId
  • string

SessionHost'un temel alınan sanal makinesinin Sanal Makine Kimliği.

type
  • string

Kaynağın türü. Örneğin "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

SessionHostHealthCheckFailureDetails

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

Name Type Description
errorCode
  • integer

Hataya karşılık gelen hata kodu.

lastHealthCheckDateTime
  • string

Son güncelleştirmenin zaman damgası.

message
  • string

Hata iletisi: Neyin yanlış olduğu ve kurtarılma hakkında ipuçları.

SessionHostHealthCheckReport

Oturum ana bilgisayar bilgileri için rapor.

Name Type Description
additionalFailureDetails

Hatayla ilgili ek ayrıntılı bilgi.

healthCheckName

Gerçekleştirilen durum denetimi işlemi adını temsil eder.

healthCheckResult

Gerçekleştirimiz durum denetiminin Durum durumunu temsil eder.

Status

SessionHost durumu.

Name Type Description
Available
  • string

Oturum Ana Bilgisayarı tüm sistem durumu denetimlerini geçti ve bağlantıları işlemek için kullanılabilir.

Disconnected
  • string

Oturum Ana Bilgisayarı şu anda bağlantısı kesildiğinden kullanılamıyor.

DomainTrustRelationshipLost
  • string

SessionHost'un etki alanı güven ilişkisi kayboldu

FSLogixNotHealthy
  • string

FSLogix, oturum ana bilgisayar üzerinde iyi durumda değil.

NeedsAssistance
  • string

Yöneticileri uç noktalarında durumunun sabit olması gerektiğini bildirmek için yeni durum. Bağlantılar başarısız olabilir, bu sorunlar önemli değildir.

NoHeartbeat
  • string

Oturum Ana Bilgisayarı kalp atışları değildir.

NotJoinedToDomain
  • string

SessionHost etki alanına katılmadı.

Shutdown
  • string

Oturum Ana Bilgisayarı kapatıldı - RD Aracısı tarafından bildirilen oturum ana bilgisayarı durdurulur veya devre dışıdır.

SxSStackListenerNotReady
  • string

SessionHost'ta yüklü olan SxS yığını bağlantıları almaya hazır değil.

Unavailable
  • string

Oturum Ana Bilgisayarı kapalı veya hizmetin bu oturum ana bilgisayarlarına bağlantıları yönlendirene kadar başarısız olan kritik sistem durumu denetimleri başarısız oldu. Bunun önceki 'NoOidBeat' durumunun yerini alan bir durum olduğunu unutmayın.

UpgradeFailed
  • string

Kritik bileşen yükseltmesi (aracı, yan yana yığın vb.) başarısız olduğundan Oturum Ana Bilgisayarı kullanılamıyor.

Upgrading
  • string

Şu anda RDAgent/yan yana yığın yükseltmesi devam ediyor olduğundan Oturum Ana Bilgisayarı kullanılamıyor. Not: Yükseltme tamamlandıktan sonra bu durum kaldırılır ve konak bağlantıları kabul eder.

UpdateState

SessionHost'u güncelleştirme durumu.

Name Type Description
Failed
  • string
Initial
  • string
Pending
  • string
Started
  • string
Succeeded
  • string