Azure Virtual Desktop에서 세션 호스트 구성 및 세션 호스트 업데이트 문제 해결
Important
Azure Virtual Desktop에 대한 세션 호스트 업데이트는 현재 미리 보기로 제공됩니다. 베타, 미리 보기로 제공되거나 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 약관은 Microsoft Azure 미리 보기에 대한 추가 사용 약관을 참조하세요.
Azure Virtual Desktop의 세션 호스트 업데이트를 사용하면 세션 호스트 구성을 사용하여 호스트 풀에서 세션 호스트 VM(가상 머신)을 쉽게 업데이트할 수 있습니다. 이 문서는 발생할 수 있는 몇 가지 문제를 해결하는 데 도움이 됩니다.
호스트 풀을 만들 때 세션 호스트 구성을 만들지 못함
세션 호스트 구성을 만들 때 확장 유효성 검사에서 구성에 대해 제공된 매개 변수를 확인합니다. 서비스에서 제공된 매개 변수를 사용하여 세션 호스트를 성공적으로 만들 수 없다고 결론을 내린 경우 유효성 검사가 실패할 수 있습니다. Azure 리소스는 구독에 저장되므로 다른 프로세스에서 수정할 수 있습니다. 이 유효성 검사가 완료된 후에도 세션 호스트 구성을 사용하는 경우에도 세션 호스트 만들기가 실패할 수 있습니다.
다음은 몇 가지 오류 예제입니다.
VM 가용성: VM SKU 이름, 지역, 가용성 영역 및 구독의 조합을 사용할 수 없습니다. 발생할 수 있는 오류 중 일부는 다음과
VmSkuNotAvailableInRegionDueToRestrictionAvailabilityZoneNotAvailable같습니다VmSkuNotAvailableInRegion. 선택한 지역 및 구독 할당량에 대한 VM 크기 및 가용성 영역의 가용성을 검토하고 지원되는 조합을 제공해야 합니다. PowerShell cmdletGet-AzComputeResourceSku을 사용하여 지정된 VM SKU 및 지역 조합에 대한 제한을 식별합니다.매개 변수 호환성: VM SKU, 디스크, 이미지 및 가상 네트워크의 조합은 호환되지 않습니다. 발생할 수 있는 오류 중 일부에는 다음이
ImageDiskTypeIncompatibleVnetLocationIncompatible포함됩니다ComputeSkuIncompatibleWithImageHyperVGeneration. Azure Virtual Desktop의 필수 구성 요소를 검토하여 제공된 매개 변수가 세션 호스트 만들기에 대한 요구 사항을 충족하는지 확인합니다.
호스트 풀을 만들 때 세션 호스트 구성을 만들지 못하는 경우 Azure Portal을 사용하여 이 호스트 풀의 세션 호스트 구성을 만들 수 없습니다. PowerShell에서 New-AzWvdSessionHostConfiguration cmdlet을 사용하여 세션 호스트 구성을 만들 수 있습니다. 또는 호스트 풀을 삭제하고 다시 만들 수도 있습니다.
오류: SessionHostConfiguration이 존재하지 않음
PowerShell cmdlet Get-AzWvdSessionHostConfiguration을 사용할 때 오류: SessionHostConfiguration이 존재하지 않음 오류가 발생하는 경우 New-AzWvdSessionHostConfiguration cmdlet을 사용하여 세션 호스트 구성을 만듭니다.
호스트 풀에 세션 호스트를 추가할 때 오류 발생
Azure Portal을 통해 세션 호스트 구성을 사용하여 호스트 풀에 세션 호스트 추가만 지원합니다. 표준 호스트 풀에서 세션 호스트 구성을 사용하는 호스트 풀 간의 주요 차이점은 도메인 조인 확장이 세션 호스트 구성과 함께 사용되지 않는다는 것입니다. 대신 Azure Virtual Desktop 에이전트는 도메인 가입 프로세스를 완료합니다. 이 메서드는 다음을 의미합니다.
- 도메인 조인이 실패하더라도 ARM 템플릿 배포가 성공하여 비정상 세션 호스트가 발생할 수 있습니다.
- 도메인 조인 실패 진단은 세션 호스트 상태의 JSON을 확인하여 세션 호스트 세부 정보의 Azure Portal에서 사용할 수 있습니다.
세션 호스트가 호스트 풀에 추가되는 경우 도메인 조인 실패 및 기타 문제의 경우 세션 호스트 문제 해결에 대한 지침을 따를 수 있습니다.
실패한 업데이트
세션 호스트 업데이트를 사용하여 세션 호스트를 업데이트하는 경우 개별 세션 호스트의 업데이트가 실패할 수 있습니다. 이 경우 세션 호스트 업데이트에서는 해당 세션 호스트에서 업데이트를 롤백하려고 시도합니다. 롤백의 목적은 세션 호스트를 강제로 사용 중지하고 호스트 풀의 용량을 줄이는 것이 아니라, 이 세션 호스트가 이전 버전의 세션 호스트 구성으로 롤백되더라도 전체 호스트 풀의 용량을 유지하는 것입니다. 성공적으로 업데이트된 호스트 풀의 다른 세션 호스트는 롤백되지 않습니다. 업데이트를 시작하지 않은 세션 호스트는 업데이트되지 않습니다.
세션 호스트가 업데이트에 실패하면 세션 호스트 업데이트가 세션 호스트의 현재 일괄 업데이트를 완료한 다음 업데이트를 실패한 것으로 표시합니다. 이 시나리오에서 유일한 옵션은 업데이트를 다시 시도하거나 취소하는 것입니다. 업데이트를 다시 시도하는 경우 세션 호스트 업데이트는 실패한 세션 호스트와 이전에 시도하지 않은 나머지 세션 호스트를 업데이트하려고 다시 시도합니다. 이때 기존 일괄 처리 크기가 사용됩니다.
세션 호스트가 성공적으로 롤백되지 않으면 세션을 호스팅할 수 없으며 용량이 줄어듭니다. 세션 호스트는 호스트 풀의 다른 세션 호스트와 동일하지 않으며 세션 호스트 구성과 일치합니다. 새 업데이트를 예약하기 전에 세션 호스트의 업데이트가 실패한 이유를 조사하고 문제를 해결해야 합니다. 새 업데이트를 예약하면 세션 호스트 업데이트는 실패한 세션 호스트를 모두 일치하도록 업데이트하고 이전 업데이트 시도에서 시작되지 않은 모든 세션 호스트를 업데이트하려고 시도합니다.
다음 상태로 업데이트가 실패할 수 있습니다.
| Status | 설명 |
|---|---|
| 업데이트를 시작하지 못함 | 업데이트 흐름이 잘못되었습니다. 예를 들어 가상 머신 SKU와 호환되지 않는 이미지입니다. 업데이트를 다시 시도할 수 없습니다. 취소하고 새 업데이트를 예약해야 합니다. |
| 업데이트 실패 | 업데이트가 진행 중에 실패했습니다. 업데이트를 다시 시도하면 이전에 중지된 세션 호스트를 계속 진행합니다. |
| 세션 호스트 롤백 실패 | 세션 호스트가 업데이트에 실패하면 세션 호스트 업데이트가 해당 세션 호스트에서 업데이트를 롤백하려고 시도합니다. 롤백이 실패하고 업데이트를 다시 시도하면 이전에 중지된 세션 호스트를 계속 진행합니다. |
업데이트 진행률을 모니터링하는 단계에 따라 업데이트에 대한 오류를 가져올 수 있습니다. Azure PowerShell을 사용하는 경우 변수 $updateProgress에는 다음 속성의 오류 세부 정보가 포함됩니다.
$updateProgress.PropertiesUpdateStatus$updateProgress.UpdateProgressError$updateProgress.UpdateProgressError.FaultText
문제를 식별한 후에는 업데이트를 다시 시도하거나 취소하고 새 업데이트를 예약할 수 있습니다.
업데이트를 시작하지 못했습니다.
세션 호스트 업데이트가 시작되면 서비스는 업데이트를 성공적으로 완료할 수 있는지 여부를 확인합니다. 시작하기 전에 세션 호스트 업데이트가 실패하면 업데이트가 종료되고 세션 호스트 구성이 변경될 수 있습니다. Azure 리소스는 구독에 저장되므로 다른 프로세스에서 수정할 수 있습니다. 이 유효성 검사가 완료된 후에도 세션 호스트 구성을 사용하여 세션 호스트를 만들지 못할 수 있습니다.
다음은 업데이트를 시작하지 못하게 하는 몇 가지 예제 오류입니다.
업데이트할 세션 호스트가 없습니다. 세션 호스트 업데이트의 일부로 업데이트할 세션 호스트가 없으면 오류가
HostpoolHasNoSessionHosts반환됩니다. 업데이트를 시작하기 전에 세션 호스트 구성을 변경하지 않은 경우 이 오류가 반환됩니다.용량 문제: 유효성 검사에서 가상 네트워크 서브넷 및 VM 코어 할당량의 충분한 용량을 확인합니다. 이 검사는 업데이트 중에 용량을 보장하지 않습니다. 세션 호스트 업데이트 외부에서 다른 리소스를 만들면 용량 제한과 관련된 중간 업데이트 오류가 발생할 수 있습니다. 일괄 처리 크기를 구독의 나머지 할당량 이내로 설정합니다.
현재 세션 호스트와의 매개 변수 일관성: 세션 호스트 업데이트는 세션 호스트에 대한 지역, 구독, 리소스 그룹 또는 도메인 조인 유형 변경을 지원하지 않습니다. 세션 호스트 구성에 호스트 풀의 세션 호스트와 다른 이러한 필드의 속성이 포함되어 있으면 업데이트가 시작되지 않습니다. 구성과 일치하지 않는 세션 호스트를 제거해야 합니다.
업데이트 중 오류
세션 호스트 업데이트는 제공된 세션 호스트 구성이 정상 세션 호스트를 발생시키는지 확인하기 위해 초기 일괄 처리 크기 1로 시작합니다. 첫 번째 유효성 검사 일괄 처리 중에 발생하는 오류는 세션 호스트 구성 내의 매개 변수로 인해 발생하는 경우가 많으며 일반적으로 업데이트를 다시 시도하여 해결되지 않습니다. 유효성 검사 일괄 처리 후에 발생하는 오류는 간헐적인 경우가 많으며 업데이트를 다시 시도하여 해결할 수 있습니다.
업데이트 중에 발생할 수 있는 몇 가지 예제 오류는 다음과 같습니다.
VM 만들기 실패: Azure Virtual Desktop과 관련이 없는 다양한 이유로 인해 VM 만들기가 실패할 수 있습니다(예: 구독 용량의 고갈 또는 제공된 이미지 관련 문제). 제공된 오류 메시지를 검토하여 적절한 해결 방법을 확인해야 합니다. 추가 지원이 필요한 경우 Azure 지원 지원 사례를 엽니다.
에이전트 설치, 도메인 조인 및 세션 호스트 상태 오류 또는 시간 제한: 첫 번째 유효성 검사 일괄 처리에서 발생하는 에이전트, 도메인 조인 및 기타 세션 호스트 상태 오류는 Azure Virtual Desktop에 대한 배포 및 도메인 조인 실패를 해결하기 위한 지침을 검토하고 이미지에 PowerShell DSC 확장이 설치되어 있지 않은지 확인하여 해결할 수 있습니다. 확장이 이미지에 설치된 경우 이미지에서 폴더
C:\packages\plugin를 제거합니다. 오류가 간헐적으로 발생하는 경우 일부 세션 호스트가 성공적으로 업데이트되고 다른 세션 호스트에서 다음과 같은AgentRegistrationFailureGeneric오류가 발생하는 경우 업데이트를 다시 시도하면 문제가 해결되는 경우가 많습니다.리소스 수정 및 액세스 오류: 업데이트에 영향을 주는 리소스를 수정하면 업데이트 중에 오류가 발생할 수 있습니다. 발생할 수 있는 오류 중 일부에는 리소스 및 리소스 그룹 삭제, 사용 권한 변경, 전원 상태 변경, 드레이닝 모드 변경 등이 있습니다. 또한 Azure 리소스가 잠겨 있거나 Azure Policy가 Azure Virtual Desktop 서비스가 세션 호스트를 수정하지 못하도록 제한하는 경우 업데이트가 실패합니다. 관련 오류가 발생하는 경우 Azure 활동 로그를 검토하세요. 추가 지원이 필요한 경우 Azure 지원 지원 사례를 엽니다.
New-AzWvdSessionHostConfiguration에 전달된 호환되지 않는 매개 변수
호환되지 않는 매개 변수를 PowerShell cmdlet에 New-AzWvdSessionHostConfiguration 전달할 수 있습니다. 예를 들어 매개 변수 DomainInfoJoinType 를 AzureActiveDirectory로 지정하고 Active Directory 도메인 이름으로 매개 변수 ActiveDirectoryInfoDomainName 를 지정하는 경우 오류를 반환하지 않고 도메인 이름이 무시됩니다.