다음을 통해 공유


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(다음 안에) 필수 형식 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 형식 Description
200 OK

SessionHost

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

Other Status Codes

CloudError

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

예제

SessionHost_Get

샘플 요청

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

샘플 응답

{
  "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"
        }
      }
    ]
  }
}

정의

Name Description
CloudError

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

CloudErrorProperties

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

createdByType

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

HealthCheckName

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

HealthCheckResult

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

SessionHost

SessionHost 정의를 나타냅니다.

SessionHostHealthCheckFailureDetails

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

SessionHostHealthCheckReport

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

Status

SessionHost의 상태입니다.

systemData

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

UpdateState

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

CloudError

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

Name 형식 Description
error

CloudErrorProperties

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

CloudErrorProperties

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

Name 형식 Description
code

string

오류 코드

message

string

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

createdByType

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

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

HealthCheckName

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

Name 형식 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 형식 Description
HealthCheckFailed

string

상태 검사 실패했습니다.

HealthCheckSucceeded

string

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

SessionHostShutdown

string

종료 알림을 받았습니다.

Unknown

string

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

SessionHost

SessionHost 정의를 나타냅니다.

Name 형식 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

SessionHostHealthCheckReport[]

SessionHostHealthCheckReports 목록

properties.sessions

integer

SessionHost의 세션 수입니다.

properties.status

Status

SessionHost의 상태입니다.

properties.statusTimestamp

string

상태 타임스탬프입니다.

properties.sxSStackVersion

string

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

properties.updateErrorMessage

string

오류 메시지입니다.

properties.updateState

UpdateState

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

properties.virtualMachineId

string

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

systemData

systemData

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

type

string

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

SessionHostHealthCheckFailureDetails

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

Name 형식 Description
errorCode

integer

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

lastHealthCheckDateTime

string

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

message

string

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

SessionHostHealthCheckReport

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

Name 형식 Description
additionalFailureDetails

SessionHostHealthCheckFailureDetails

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

healthCheckName

HealthCheckName

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

healthCheckResult

HealthCheckResult

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

Status

SessionHost의 상태입니다.

Name 형식 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 형식 Description
createdAt

string

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

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

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

lastModifiedAt

string

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

lastModifiedBy

string

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

lastModifiedByType

createdByType

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

UpdateState

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

Name 형식 Description
Failed

string

Initial

string

Pending

string

Started

string

Succeeded

string