Azure Virtual Desktop(클래식) PowerShell

Important

이 콘텐츠는 Azure Resource Manager Azure Virtual Desktop 개체를 지원하지 않는 Azure Virtual Desktop(클래식)에 적용됩니다. Azure Resource Manager의 Azure Virtual Desktop 개체를 관리하려는 경우 이 문서를 참조하세요.

이 문서를 사용하여 Azure Virtual Desktop에서 PowerShell을 사용할 때 발생하는 오류 및 문제를 해결합니다. 원격 데스크톱 서비스 PowerShell에 대한 자세한 내용은 Azure Virtual Desktop PowerShell을 참조하세요.

피드백 제공

제품 팀 및 활발하게 활동하는 커뮤니티 멤버들과 Azure Virtual Desktop 서비스에 대해 토론하려면 Azure Virtual Desktop 기술 커뮤니티를 방문하세요.

Azure Virtual Desktop 설치 중에 사용되는 PowerShell 명령

이 섹션에서는 Azure Virtual Desktop을 설정하는 동안 일반적으로 사용되는 PowerShell 명령을 나열하고 이를 사용하는 동안 발생할 수 있는 문제를 해결하는 방법을 제공합니다.

오류: Add-RdsAppGroupUser 명령 - 지정된 UserPrincipalName이 지정된 호스트 풀의 RemoteApp 앱 그룹에 이미 할당되어 있습니다.

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName 'Desktop Application Group' -UserPrincipalName <UserName>

원인: 사용된 사용자 이름이 다른 유형의 애플리케이션 그룹에 이미 할당되었습니다. 동일한 세션 호스트 풀의 원격 데스크톱 및 원격 RemoteApp 애플리케이션 그룹 모두에 사용자를 할당할 수 없습니다.

해결 방법: 사용자에게 RemoteApp과 데스크톱이 모두 필요한 경우, 여러 개의 호스트 풀을 만들거나 사용자에게 원격 데스크톱에 대한 액세스 권한만 부여하여 세션 호스트 VM에서 모든 애플리케이션을 사용하도록 허용합니다.

오류: Add-RdsAppGroupUser 명령 - 지정된 UserPrincipalName이 원격 데스크톱 테넌트와 연결된 Microsoft Entra ID에 없습니다

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName "Desktop Application Group" -UserPrincipalName <UserPrincipalName>

원인: Azure Virtual Desktop 테넌트에 연결된 Microsoft Entra에서 -UserPrincipalName으로 지정된 사용자를 찾을 수 없습니다.

해결 방법: 다음 목록의 항목을 확인합니다.

• 사용자가 Microsoft Entra ID에 동기화됩니다.
• 사용자가 B2C(Business-to-Consumer) 또는 B2B(Business-to-Business) 상거래에 연결되어 있지 않습니다.
• Azure Virtual Desktop 테넌트가 올바른 Microsoft Entra ID에 연결되어 있습니다.

오류: Get-RdsDiagnosticActivities - 사용자에게 관리 서비스를 쿼리할 수 있는 권한이 없습니다.

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

원인: -TenantName 매개 변수

해결 방법: - TenantName <TenantName>을 사용하여 Get-RdsDiagnosticActivities를 실행합니다.

오류: Get-RdsDiagnosticActivities - 사용자에게 관리 서비스를 쿼리할 수 있는 권한이 없습니다.

Get-RdsDiagnosticActivities -Deployment -username <username>

원인: -Deployment 스위치 사용

해결 방법: 배포 관리자만 -Deployment 스위치를 사용할 수 있습니다. 이러한 관리자는 일반적으로 원격 데스크톱 서비스/Azure Virtual Desktop 팀의 멤버입니다. -Deployment 스위치를 -TenantName <TenantName>으로 바꿉니다.

오류: New-RdsRoleAssignment - 사용자에게 관리 서비스를 쿼리할 수 있는 권한이 없습니다.

원인 1: 사용 중인 계정에 테넌트에 대한 원격 데스크톱 서비스 소유자 권한이 없습니다.

해결 방법 1: 원격 데스크톱 서비스 소유자 권한이 있는 사용자가 역할 할당을 실행해야 합니다.

원인 2: 사용 중인 계정에 원격 데스크톱 서비스 소유자 권한이 있지만 테넌트의 Microsoft Entra ID에 속하지 않거나 사용자가 있는 Microsoft Entra ID를 쿼리할 수 있는 권한이 없습니다.

해결 방법 2: Active Directory 권한이 있는 사용자가 역할 할당을 실행해야 합니다.

참고 항목

New-RdsRoleAssignment는 Microsoft Entra ID에 없는 사용자에게 권한을 부여할 수 없습니다.

오류: SessionHostPool을 삭제할 수 없음

이 오류는 일반적으로 다음 명령을 실행하여 세션 호스트를 제거하려고 할 때 발생합니다.

Remove-RdsHostPool -TenantName <TenantName> -Name <HostPoolName>

원인: 호스트 풀의 리프 개체를 삭제하기 전에 명령을 실행하면 작동하지 않습니다.

수정: 다음 명령을 실행하여 세션 호스트를 삭제합니다.

Get-RdsSessionHost-TenantName <TenantName> -Hostpook <HostPoolName> | Remove-RdsSessionHost -Force

force 명령을 사용하면 사용자가 할당된 경우에도 세션 호스트를 삭제할 수 있습니다.

다음 단계

• Azure Virtual Desktop 및 에스컬레이션 트랙 문제 해결에 대한 개요는 문제 해결 개요, 피드백 및 지원을 참조하세요.
• Azure Virtual Desktop 환경에서 테넌트와 호스트 풀을 만드는 동안 발생하는 문제를 해결하려면 테넌트 및 호스트 풀 만들기를 참조하세요.
• Azure Virtual Desktop에서 VM(가상 머신)을 구성하는 동안 발생하는 문제를 해결하려면 세션 호스트 가상 머신 구성을 참조하세요.
• Azure Virtual Desktop 클라이언트 연결 문제를 해결하려면 Azure Virtual Desktop 서비스 연결을 참조하세요.
• 원격 데스크톱 클라이언트와 관련된 문제를 해결하려면 원격 데스크톱 클라이언트 문제 해결을 참조하세요.
• 서비스에 대한 자세한 내용은 Azure Virtual Desktop 환경을 참조하세요.
• 문제 해결 자습서를 진행하려면 자습서: Resource Manager 템플릿 배포 문제 해결을 참조하세요.
• 감사 작업에 대해 알아보려면 리소스 관리자로 작업 감사를 참조하세요.
• 배포 중 오류를 확인하는 작업에 대해 알아보려면 배포 작업 보기를 참조하세요.