Session Hosts - Get

세션 호스트를 가져옵니다.

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

URI 매개 변수

Name In Required Type Description
hostPoolName
path True
  • string

지정된 리소스 그룹 내의 호스트 풀 이름

resourceGroupName
path True
  • string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

sessionHostName
path True
  • string

지정된 호스트 풀 내의 세션 호스트 이름

subscriptionId
path True
  • string

대상 구독의 ID입니다.

api-version
query True
  • string

이 작업에 사용할 API 버전입니다.

응답

Name Type Description
200 OK

세션 호스트를 성공적으로 검색했습니다.

Other Status Codes

작업이 실패한 이유를 설명하는 자동화 오류 응답입니다.

예제

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=2022-02-10-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",
  "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"
        }
      }
    ]
  }
}

정의

CloudError

클라우드 오류 개체입니다.

CloudErrorProperties

클라우드 오류 개체 속성입니다.

createdByType

리소스를 만든 ID의 형식입니다.

HealthCheckName

수행된 상태 검사 작업의 이름을 나타냅니다.

HealthCheckResult

수행한 상태 검사의 상태를 나타냅니다.

SessionHost

SessionHost 정의를 나타냅니다.

SessionHostHealthCheckFailureDetails

오류에 대한 세부 정보를 포함합니다.

SessionHostHealthCheckReport

세션 호스트 정보에 대한 보고서입니다.

Status

SessionHost의 상태입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

UpdateState

SessionHost의 상태를 업데이트합니다.

CloudError

클라우드 오류 개체입니다.

Name Type Description
error

클라우드 오류 개체 속성입니다.

CloudErrorProperties

클라우드 오류 개체 속성입니다.

Name Type Description
code
  • string

오류 코드

message
  • string

작업이 실패한 이유를 나타내는 오류 메시지입니다.

createdByType

리소스를 만든 ID의 형식입니다.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

HealthCheckName

수행된 상태 검사 작업의 이름을 나타냅니다.

Name Type Description
AppAttachHealthCheck
  • string

AppAttachService가 정상인지 확인합니다(패키지 준비 중에 문제가 없음). AppAttachService는 테넌트 관리자가 설정한 MSIX 앱의 스테이징/등록(및 최종 등록 취소/수집)을 사용하도록 설정하는 데 사용됩니다. 이렇게 하면 패키지 준비 중에 구성 요소에 오류가 있는지 확인합니다. 스테이징에 실패하면 일부 MSIX 앱이 최종 사용자에 대해 제대로 작동하지 않습니다. 이 검사가 실패하면 치명적이지 않으며 컴퓨터가 여전히 연결을 서비스할 수 있습니다. 주요 문제는 최종 사용자에게 특정 앱이 작동하지 않을 수 있습니다.

DomainJoinedCheck
  • string

SessionHost가 도메인에 가입되어 있는지 확인합니다. 이 검사가 실패하면 SessionHost가 도메인에 가입되지 않은 경우 연결이 성공하지 못하기 때문에 치명적인 것으로 분류됩니다.

DomainReachable
  • string

SessionHost가 조인된 도메인에 연결할 수 있는지 확인합니다. 이 검사가 실패하면 연결 시 SessionHost가 가입된 도메인에 연결할 수 없는 경우 연결이 성공하지 못하기 때문에 심각한 것으로 분류됩니다.

DomainTrustCheck
  • string

세션이 생성될 때 연결 시 SessionHost에서 인증을 방지하는 도메인 신뢰 문제가 SessionHost에 발생하지 않는지 확인합니다. 이 검사가 실패하면 SessionHost에서 인증을 위해 도메인에 연결할 수 없는 경우 연결이 성공하지 못하기 때문에 치명적인 것으로 분류됩니다.

FSLogixHealthCheck
  • string

FSLogix 서비스가 실행 중인지 확인하여 사용자의 프로필이 세션에 로드되었는지 확인합니다. 연결이 성공할 수 있더라도 이 검사가 실패하면 사용자 프로필을 로드할 수 없고 사용자가 세션에서 임시 프로필을 얻게 되므로 사용자 환경이 나빠집니다.

MetaDataServiceCheck
  • string

메타데이터 서비스에 액세스할 수 있는지 확인하고 컴퓨팅 속성을 반환합니다.

MonitoringAgentCheck
  • string

필요한 Geneva 에이전트가 실행 중인지 확인합니다. 이 검사가 실패하면 치명적이 아니고 컴퓨터가 여전히 연결을 서비스할 수 있습니다. 주요 문제는 모니터링 에이전트가 누락되었거나 이전 버전이 실행 중일 수 있습니다.

SupportedEncryptionCheck
  • string

SecurityLayer 등록 키의 값을 확인합니다. 값이 0(SecurityLayer.RDP)이면 오류 코드 = NativeMethodErrorCode.E_FAIL 이 검사가 실패하고 치명적입니다. 값이 1(SecurityLayer.Negotiate)이면 오류 코드 = NativeMethodErrorCode.ERROR_SUCCESS 이 검사가 실패하고 치명적이지는 않습니다.

SxSStackListenerCheck
  • string

연결이 성공할 수 있도록 SxS 스택이 실행 중인지 확인합니다. 이 검사가 실패하면 SxS 스택이 준비되지 않은 경우 연결이 성공하지 못하기 때문에 치명적인 것으로 분류됩니다.

UrlsAccessibleCheck
  • string

SessionHost에서 필요한 WVD 서비스 및 Geneva URL에 연결할 수 있는지 확인합니다. 이러한 URL은 RdTokenUri, RdBrokerURI, RdDiagnosticsUri 및 에이전트 모니터링을 위한 스토리지 Blob URL(geneva)입니다. 이 검사가 실패하면 치명적이 아니고 컴퓨터가 연결을 계속 서비스할 수 있습니다. 주요 문제는 모니터링 에이전트가 웜 경로 데이터(로그, 작업 ...)를 저장할 수 없다는 것입니다.

WebRTCRedirectorCheck
  • string

WebRTCRedirector 구성 요소가 정상인지 확인합니다. WebRTCRedirector 구성 요소는 Microsoft Teams 비디오 및 오디오 성능을 최적화하는 데 사용됩니다. 구성 요소가 여전히 실행 중인지 여부와 더 높은 버전을 사용할 수 있는지 여부를 확인합니다. 이 검사가 실패하면 치명적이 아니고 컴퓨터가 여전히 연결을 서비스할 수 있습니다. 주요 문제는 WebRTCRedirector 구성 요소를 다시 시작하거나 업데이트해야 하는 것일 수 있습니다.

HealthCheckResult

수행한 상태 검사의 상태를 나타냅니다.

Name Type Description
HealthCheckFailed
  • string

상태 검사에 실패했습니다.

HealthCheckSucceeded
  • string

상태 검사가 통과되었습니다.

SessionHostShutdown
  • string

종료 알림을 받았습니다.

Unknown
  • string

상태 검사 결과는 현재 알려져 있지 않습니다.

SessionHost

SessionHost 정의를 나타냅니다.

Name Type Description
id
  • string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

리소스의 이름입니다.

properties.agentVersion
  • string

SessionHost의 에이전트 버전입니다.

properties.allowNewSession
  • boolean

새 세션을 허용합니다.

properties.assignedUser
  • string

SessionHost에 할당된 사용자입니다.

properties.friendlyName
  • string

SessionHost의 이름

properties.lastHeartBeat
  • string

SessionHost에서 마지막 심장 박동.

properties.lastUpdateTime
  • string

마지막 업데이트의 타임스탬프입니다.

properties.objectId
  • string

SessionHost의 ObjectId입니다. (내부 사용)

properties.osVersion
  • string

세션 호스트의 OS 버전입니다.

properties.resourceId
  • string

SessionHost의 기본 가상 머신의 리소스 ID입니다.

properties.sessionHostHealthCheckResults

SessionHostHealthCheckReports 목록

properties.sessions
  • integer

SessionHost의 세션 수입니다.

properties.status

SessionHost의 상태입니다.

properties.statusTimestamp
  • string

상태의 타임스탬프입니다.

properties.sxSStackVersion
  • string

세션 호스트의 병렬 스택 버전입니다.

properties.updateErrorMessage
  • string

오류 메시지입니다.

properties.updateState

SessionHost의 상태를 업데이트합니다.

properties.virtualMachineId
  • string

SessionHost의 기본 가상 머신의 Virtual Machine ID입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

type
  • string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft. Storage/storageAccounts"

SessionHostHealthCheckFailureDetails

오류에 대한 세부 정보를 포함합니다.

Name Type Description
errorCode
  • integer

오류에 해당하는 오류 코드입니다.

lastHealthCheckDateTime
  • string

마지막 업데이트의 타임스탬프입니다.

message
  • string

실패 메시지: 무엇이 잘못되었는지 및 복구 방법에 대한 힌트입니다.

SessionHostHealthCheckReport

세션 호스트 정보에 대한 보고서입니다.

Name Type Description
additionalFailureDetails

오류에 대한 자세한 추가 정보입니다.

healthCheckName

수행된 상태 검사 작업의 이름을 나타냅니다.

healthCheckResult

수행한 상태 검사의 상태를 나타냅니다.

Status

SessionHost의 상태입니다.

Name Type Description
Available
  • string

세션 호스트가 모든 상태 검사를 통과했으며 연결을 처리할 수 있습니다.

Disconnected
  • string

세션 호스트는 현재 연결이 끊어지므로 사용할 수 없습니다.

DomainTrustRelationshipLost
  • string

SessionHost의 도메인 트러스트 관계 손실

FSLogixNotHealthy
  • string

FSLogix는 세션 호스트에서 비정상 상태입니다.

NeedsAssistance
  • string

관리자에게 엔드포인트의 상태를 수정해야 한다는 것을 알리는 새로운 상태입니다. 이러한 문제는 치명적이지 않으므로 연결이 실패하지 않을 수 있습니다.

NoHeartbeat
  • string

세션 호스트는 심장 박동이 아닙니다.

NotJoinedToDomain
  • string

SessionHost가 도메인에 가입되지 않았습니다.

Shutdown
  • string

세션 호스트가 종료됨 - RD 에이전트가 세션 호스트를 중지하거나 할당 취소하도록 보고했습니다.

SxSStackListenerNotReady
  • string

SessionHost에 설치된 SxS 스택이 연결을 받을 준비가 되지 않았습니다.

Unavailable
  • string

세션 호스트가 꺼졌거나 중요한 상태 검사에 실패하여 서비스가 이 세션 호스트에 대한 연결을 라우팅할 수 없습니다. 이전 'NoHeartBeat' 상태가 바뀝니다.

UpgradeFailed
  • string

중요한 구성 요소 업그레이드(에이전트, 병렬 스택 등)가 실패했기 때문에 세션 호스트를 사용할 수 없습니다.

Upgrading
  • string

현재 RDAgent/side-by-side 스택의 업그레이드가 진행 중이므로 세션 호스트를 사용할 수 없습니다. 참고: 업그레이드가 완료되고 호스트가 연결을 수락할 수 있게 되면 이 상태가 제거됩니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name Type Description
createdAt
  • string

리소스 만들기의 타임스탬프(UTC)입니다.

createdBy
  • string

리소스를 만든 ID입니다.

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt
  • string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy
  • string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

리소스를 마지막으로 수정한 ID의 형식입니다.

UpdateState

SessionHost의 상태를 업데이트합니다.

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