Session Hosts - Get

서비스:: Desktop Virtualization

API 버전:: 2025-10-10

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

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	지정된 리소스 그룹 내의 호스트 풀의 이름입니다
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
sessionHostName	path	True	string minLength: 3 maxLength: 48 pattern: ^[A-Za-z0-9@.\-_ ]*$	지정된 호스트 풀 내의 세션 호스트 이름
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	SessionHost	세션 호스트를 성공적으로 복구했습니다.
Other Status Codes	CloudError	작업이 실패한 이유를 설명하는 자동화 오류 응답입니다.

예제

SessionHost_Get

샘플 요청

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

샘플 응답

상태 코드:: 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"
        }
      }
    ]
  }
}

정의

Name	Description
CloudError	클라우드 오류 객체.
CloudErrorProperties	클라우드 오류 객체 속성.
createdByType	리소스를 만든 ID의 형식입니다.
HealthCheckName	수행된 상태 점검 작업의 이름을 나타냅니다.
HealthCheckResult	수행한 상태 점검의 상태를 나타냅니다.
SessionHost	SessionHost 정의를 나타냅니다.
SessionHostHealthCheckFailureDetails	오류에 대한 세부 정보를 포함합니다.
SessionHostHealthCheckReport	세션 호스트 정보에 대한 보고서입니다.
Status	SessionHost의 상태입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
UpdateState	SessionHost의 상태를 업데이트합니다.

CloudError

Object

클라우드 오류 객체.

Name	형식	Description
error	CloudErrorProperties	클라우드 오류 객체 속성.

CloudErrorProperties

Object

클라우드 오류 객체 속성.

Name	형식	Description
code	string	오류 코드
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.

createdByType

열거형

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

값	Description
User
Application
ManagedIdentity
Key

HealthCheckName

열거형

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

값	Description
DomainJoinedCheck	SessionHost가 도메인에 가입되어 있는지 확인합니다. 이 검사가 실패하면 SessionHost가 도메인에 가입되지 않은 경우 연결이 성공할 수 없으므로 치명적인 것으로 분류됩니다. (현재 사용 중)
DomainTrustCheck	세션이 생성될 때 연결 시 SessionHost에 대한 인증을 방해하는 도메인 신뢰 문제가 SessionHost에 발생하지 않는지 확인합니다. 이 검사가 실패하면 SessionHost에서 인증을 위해 도메인에 연결할 수 없는 경우 연결이 성공할 수 없으므로 치명적인 것으로 분류됩니다. (현재 사용 중)
FSLogixHealthCheck	FSLogix 서비스가 실행 중인지 확인하여 사용자의 프로필이 세션에 로드되었는지 확인합니다. 이 검사가 실패하면 연결이 성공할 수 있더라도 사용자 프로필을 로드할 수 없고 사용자가 세션에서 임시 프로필을 얻게 되므로 사용자 경험이 좋지 않습니다. (현재 비활성화됨)
SxSStackListenerCheck	연결이 성공할 수 있도록 SxS 스택이 실행 중인지 확인합니다. 이 검사가 실패하면 SxS 스택이 준비되지 않은 경우 연결이 성공할 수 없으므로 치명적인 것으로 분류됩니다. (현재 사용 중)
UrlsAccessibleCheck	SessionHost에서 필요한 WVD 서비스 및 Geneva URL에 연결할 수 있는지 확인합니다. 이러한 URL은 에이전트 모니터링(제네바)을 위한 RdTokenUri, RdBrokerURI, RdDiagnosticsUri 및 스토리지 Blob URL입니다. 이 검사가 실패하면 치명적이지 않고 컴퓨터가 여전히 연결을 서비스할 수 있으며, 주요 문제는 모니터링 에이전트가 웜 경로 데이터(로그, 작업 등)를 저장할 수 없다는 것일 수 있습니다. (현재 비활성화됨)
MonitoringAgentCheck	필요한 Geneva 에이전트가 실행 중인지 확인합니다. 이 검사가 실패하면 치명적이지 않고 시스템이 여전히 연결을 서비스할 수 있으며, 주요 문제는 모니터링 에이전트가 누락되었거나 이전 버전을 실행 중일 수 있습니다. (현재 사용 중)
DomainReachable	SessionHost가 가입된 도메인에 여전히 연결할 수 있는지 확인합니다. 이 검사가 실패하면 연결 시 SessionHost가 가입된 도메인에 연결할 수 없는 경우 연결이 성공할 수 없으므로 치명적인 것으로 분류됩니다. (현재 비활성화됨)
WebRTCRedirectorCheck	WebRTCRedirector 구성 요소가 정상인지 확인합니다. WebRTCRedirector 구성 요소는 Microsoft Teams에서 비디오 및 오디오 성능을 최적화하는 데 사용됩니다. 이렇게 하면 구성 요소가 여전히 실행 중인지, 사용 가능한 상위 버전이 있는지 여부를 확인합니다. 이 검사가 실패하면 치명적이지 않고 시스템이 여전히 연결을 서비스할 수 있으며 주요 문제는 WebRTCRedirector 구성 요소를 다시 시작하거나 업데이트해야 한다는 것입니다. (현재 비활성화됨)
SupportedEncryptionCheck	SecurityLayer 등록 키의 값을 확인합니다. 값이 0(SecurityLayer.RDP)이면 이 검사는 오류 코드 = NativeMethodErrorCode.E_FAIL와 함께 실패하고 치명적입니다. 값이 1(SecurityLayer.Negotiate)인 경우 이 검사는 오류 코드 = NativeMethodErrorCode.ERROR_SUCCESS와 함께 실패하며 치명적이지 않습니다. (현재 비활성화됨)
MetaDataServiceCheck	메타데이터 서비스에 액세스할 수 있는지 확인하고 컴퓨팅 속성을 반환합니다. (현재 사용 중)
AppAttachHealthCheck	AppAttachService가 정상인지 확인합니다(패키지 스테이징 중에 문제가 없음). AppAttachService는 테넌트 관리자가 설정한 MSIX 앱의 스테이징/등록(및 최종 등록 취소/삭제)을 가능하게 하는 데 사용됩니다. 이 기능은 패키지 스테이징 중에 부품에 고장이 있었는지 확인합니다. 스테이징 실패로 인해 일부 MSIX 앱이 최종 사용자에 대해 제대로 작동하지 않습니다. 이 검사가 실패하면 치명적이지 않고 컴퓨터가 여전히 연결을 서비스할 수 있으며 주요 문제는 특정 앱이 최종 사용자에게 작동하지 않는다는 것일 수 있습니다. (현재 사용 중)

HealthCheckResult

열거형

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

값	Description
Unknown	상태검사 결과는 현재 알려지지 않았습니다.
HealthCheckSucceeded	상태 점검을 통과했습니다.
HealthCheckFailed	상태 점검에 실패했습니다.
SessionHostShutdown	종료 알림을 받았습니다.

SessionHost

Object

SessionHost 정의를 나타냅니다.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 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 (date-time)	SessionHost의 마지막 하트 비트입니다.
properties.lastUpdateTime	string (date-time)	마지막 업데이트의 타임스탬프입니다.
properties.objectId	string	SessionHost의 ObjectId입니다. (내부 사용)
properties.osVersion	string	세션 호스트의 OS 버전입니다.
properties.resourceId	string	SessionHost의 기본 가상 머신의 리소스 ID입니다.
properties.sessionHostHealthCheckResults	SessionHostHealthCheckReport[]	SessionHostHealthCheckReports 목록
properties.sessions	integer (int32)	SessionHost의 세션 수입니다.
properties.status	Status	SessionHost의 상태입니다.
properties.statusTimestamp	string (date-time)	상태의 타임스탬프입니다.
properties.sxSStackVersion	string	세션 호스트의 병렬 스택 버전입니다.
properties.updateErrorMessage	string	오류 메시지입니다.
properties.updateState	UpdateState	SessionHost의 상태를 업데이트합니다.
properties.virtualMachineId	string	SessionHost의 기본 가상 머신의 가상 머신 ID입니다.
systemData	systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

SessionHostHealthCheckFailureDetails

Object

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

Name	형식	Description
errorCode	integer (int32)	오류에 해당하는 오류 코드입니다.
lastHealthCheckDateTime	string (date-time)	마지막 업데이트의 타임스탬프입니다.
message	string	실패 메시지: 무엇이 잘못되었는지, 어떻게 복구해야 하는지에 대한 힌트입니다.

SessionHostHealthCheckReport

Object

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

Name	형식	Description
additionalFailureDetails	SessionHostHealthCheckFailureDetails	실패에 대한 추가 세부 정보입니다.
healthCheckName	HealthCheckName	수행된 상태 점검 작업의 이름을 나타냅니다.
healthCheckResult	HealthCheckResult	수행한 상태 점검의 상태를 나타냅니다.

Status

열거형

SessionHost의 상태입니다.

값	Description
Available	세션 호스트가 모든 상태 검사를 통과했으며 연결을 처리할 수 있습니다.
Unavailable	세션 호스트가 꺼져 있거나 중요한 상태 점검에 실패하여 서비스가 이 세션 호스트에 연결을 라우팅할 수 없습니다. 이는 이전 'NoHeartBeat' 상태를 대체합니다.
Shutdown	세션 호스트가 종료됨 - RD 에이전트가 세션 호스트를 중지하거나 할당 취소하도록 보고했습니다.
Disconnected	세션 호스트는 현재 연결이 끊어져 있으므로 사용할 수 없습니다.
Upgrading	현재 RDAgent/side-by-side 스택의 업그레이드가 진행 중이므로 세션 호스트를 사용할 수 없습니다. 참고: 업그레이드가 완료되고 호스트가 연결을 수락할 수 있게 되면 이 상태가 제거됩니다.
UpgradeFailed	중요한 구성 요소 업그레이드(에이전트, 병렬 스택 등)가 실패했기 때문에 세션 호스트를 사용할 수 없습니다.
NoHeartbeat	세션 호스트가 심장 박동을 일으키지 않습니다.
NotJoinedToDomain	SessionHost가 도메인에 가입되어 있지 않습니다.
DomainTrustRelationshipLost	SessionHost의 도메인 신뢰 관계 손실
SxSStackListenerNotReady	SessionHost에 설치된 SxS 스택이 연결을 받을 준비가 되지 않았습니다.
FSLogixNotHealthy	FSLogix는 세션 호스트에서 비정상 상태입니다.
NeedsAssistance	엔드포인트의 상태를 수정해야 함을 관리자에게 알리는 새 상태입니다. 이러한 문제는 치명적이지 않으므로 연결이 실패하지 않을 수 있습니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

UpdateState

열거형

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

값	Description
Initial
Pending
Started
Succeeded
Failed

다음을 통해 공유

Session Hosts - Get

URI 매개 변수

응답

예제

SessionHost_Get

샘플 요청

샘플 응답

정의

CloudError

CloudErrorProperties

createdByType

HealthCheckName

HealthCheckResult

SessionHost

SessionHostHealthCheckFailureDetails

SessionHostHealthCheckReport

Status

systemData

UpdateState