Azure Virtual Desktop용 원격 데스크톱 클라이언트를 사용하는 Uniform Resource Identifier 스키마

아티클
06/03/2024

URI(Uniform Resource Identifier) 체계를 사용하여 Azure Virtual Desktop에서 사용할 특정 명령, 매개 변수 및 값을 사용하여 원격 데스크톱 클라이언트를 호출할 수 있습니다. 예를 들어 작업 영역을 구독하거나 특정 데스크톱 또는 RemoteApp에 연결할 수 있습니다.

이 문서에서는 몇 가지 예제와 함께 사용 가능한 명령 및 매개 변수에 대해 자세히 설명합니다.

지원되는 클라이언트

다음 표에서는 URI 스키마와 함께 사용할 수 있는 지원되는 클라이언트를 나열합니다.

클라이언트	버전
Windows에 대한 원격 데스크톱 클라이언트	1.2.4065 이상

사용 가능한 URI 체계

ms-avd 및 ms-rd, 지원되는 원격 데스크톱 클라이언트에 대한 두 가지 URI 체계가 있습니다. ms-avd를 사용하여 연결할 특정 Azure Virtual Desktop 리소스 및 사용자를 지정할 수 있습니다. ms-rd를 사용하면 작업 영역을 수동으로 추가하지 않고도 원격 데스크톱 클라이언트의 작업 영역을 자동으로 구독할 수 있습니다.

다음 섹션에서는 각 URI 스키마에 사용할 수 있는 명령 및 매개 변수를 자세히 설명합니다.

ms-avd

이제 Azure Virtual Desktop에 대한 ms-avd Uniform Resource Identifier 스키마를 일반 공급할 수 있습니다. 다음은 ms-avd 및 해당 매개 변수에 대해 현재 지원되는 명령 목록입니다.

ms-avd:connect

ms-avd:connect(은)는 지정된 Azure Virtual Desktop 리소스를 찾고 RDP 세션을 시작하여 지정된 사용자를 해당 리소스에 직접 연결합니다.

명령 이름: 연결

명령 매개 변수:

매개 변수	값	설명
WorkspaceID	개체 ID(GUID).	유효한 작업 영역의 개체 ID를 지정합니다. PowerShell을 사용하여 개체 ID 값을 가져오려면 호스트 풀, 작업 영역, 애플리케이션 그룹 또는 애플리케이션 개체 ID 검색을 참조하세요. 데스크톱 가상화 REST API를 사용할 수도 있습니다.
Resourceid	개체 ID(GUID).	작업 영역에 포함된 게시된 리소스의 개체 ID를 지정합니다. 값은 데스크톱 또는 RemoteApp에 대한 값일 수 있습니다. PowerShell을 사용하여 개체 ID 값을 가져오려면 호스트 풀, 작업 영역, 애플리케이션 그룹 또는 애플리케이션 개체 ID 검색을 참조하세요. 데스크톱 가상화 REST API를 사용할 수도 있습니다.
user	UPN(사용자 계정 이름), 예를 들어 `user@contoso.com`.	지정된 리소스에 대한 액세스 권한이 있는 유효한 사용자를 지정합니다.
env (선택 사항)	avdarm (상업용 Azure) avdgov (Azure Government)	리소스가 있는 Azure 클라우드를 지정합니다.
version	0	사용할 연결 URI 스키마의 버전을 지정합니다.
launchpartnerid (선택 사항)	GUID.	문제 해결에 도움이 되는 Azure Virtual Desktop Diagnostics를 사용할 수 있는 파트너 또는 고객 제공 ID를 지정합니다. New-Guid PowerShell cmdlet을 사용하여 생성할 수 있는 GUID를 사용하는 것이 좋습니다.
peeractivityid (선택 사항)	GUID.	문제 해결에 도움이 되는 Azure Virtual Desktop Diagnostics를 사용할 수 있는 파트너 또는 고객 제공 ID를 지정합니다. New-Guid PowerShell cmdlet을 사용하여 생성할 수 있는 GUID를 사용하는 것이 좋습니다.
usemultimon	true 또는 false	원격 세션에서 로컬 컴퓨터에서 하나 이상의 디스플레이를 사용할지 여부를 지정합니다.

예제:

ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=c2f5facc-196f-46af-991e-a90f3252c185&username=user@contoso.com&version=0

ms-rd

다음은 ms-rd 및 해당 매개 변수에 대해 현재 지원되는 명령 목록입니다.

팁

명령 없이 ms-rd:(을)를 사용하면 원격 데스크톱 클라이언트가 시작됩니다.

ms-rd:subscribe

ms-rd:subscribe(은)는 원격 데스크톱 클라이언트를 시작하고 구독 프로세스를 시작합니다.

명령 이름: 구독

명령 매개 변수:

매개 변수	값	설명
url	https://rdweb.wvd.microsoft.com과 같은 유효한 URL입니다.	작업 영역 URL을 지정합니다.

예제:

ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com

알려진 제한 사항

다음은 URI 스키마의 알려진 제한 사항입니다.

표시 속성은 URI를 통해 구성할 수 없습니다. 호스트 풀에서 관리자 표시 속성을 구성할 수 있습니다. 또는 최종 사용자는 Azure Virtual Desktop 클라이언트 표시 속성을 구성할 수 있습니다.

다음 단계

Windows에 대한 원격 데스크톱 클라이언트를 사용하여 Azure Virtual Desktop에 연결하는 방법을 알아봅니다.

다음을 통해 공유