다음을 통해 공유


원격 데스크톱 URI 체계

이 문서에서는 원격 데스크톱용 URI(Uniform Resource Identifier)의 형식을 정의합니다. 이러한 URI 구성을 통해 원격 데스크톱 클라이언트를 다양한 명령으로 호출할 수 있습니다.

ms-rd URI 스키마

참고 항목

ms-rd URI 스키마는 현재 Windows 데스크톱 클라이언트(MSRDC)에서만 지원됩니다.

ms-rd URI는 클라이언트에 대한 명령과 다음 형식을 사용하여 명령에 고유한 매개 변수 세트를 지정하는 옵션을 제공합니다.

ms-rd:command?parameters

매개 변수는 &로 구분된 key=value 쌍의 쿼리 문자열 형식을 사용하여 지정된 명령에 대한 추가 정보를 제공합니다.

param1=value1&param2=value2&…

명령 및 매개 변수

다음은 현재 지원되는 명령 및 해당 매개 변수의 목록입니다.

명령 없이 ms-rd:를 사용하면 클라이언트가 시작됩니다.

구독

이 명령은 클라이언트를 시작하고 구독 프로세스를 시작합니다.

명령 이름: 구독

명령 매개 변수:

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

예: ms-rd:subscribe?url=https://contoso.com

레거시 rdp URI 스키마

참고 항목

다음 URI 스키마는 macOS, iOS 및 Android 디바이스에 대한 클라이언트에서만 지원됩니다. 이는 위의 새로운 ms-rd URI로 대체됩니다.

Microsoft 원격 데스크톱 클라이언트를 시작할 때 사용되는 미리 구성된 특성 설정을 저장하는 URI 스키마 rdp://query_string을 사용합니다. 쿼리 문자열은 URL로 제공되는 단일 RDP 특성이나 특성 집합을 나타냅니다.

RDP 특성은 앰퍼샌드 기호(&)로 구분됩니다. 예를 들어 PC에 연결할 경우 문자열은 다음과 같습니다.

rdp://full%20address=s:mypc:3389&audiomode=i:2&disable%20themes=i:1

다음 테이블에서는 iOS, Mac 및 Android 원격 데스크톱 클라이언트에서 사용할 수 있는 지원되는 특성의 전체 목록을 제공합니다. 플랫폼 열의 "x"는 특성이 지원됨을 나타냅니다. 펼침 단추(<>)로 표시된 값은 원격 데스크톱 클라이언트에서 지원되는 값을 나타냅니다.

RDP 특성 Android Mac iOS
바탕 화면 구성 허용 = i:<0 또는 1> x x x
글꼴 다듬기 허용 = i:<0 또는 1> x x x
대체 셸 = s:<문자열> x x x
audiomode = i:<0, 1 또는 2> x x x
인증 수준 = i:<0 또는 1> x x x
콘솔에 연결 = i:<0 또는 1> x x x
커서 설정 사용 안 함 = i:<0 또는 1> x x x
전체 창 끌기를 사용 안 함 = i:<0 또는 1> x x x
메뉴 애니메이션 사용 안 함 = i:<0 또는 1> x x x
테마 사용 안 함 = i:<0 또는 1> x x x
배경 무늬 사용 안 함 = i:<0 또는 1> x x x
drivestoredirect = s: * (이것이 값만 지원된) x x
desktopheight = i:<픽셀 단위 값> x
desktopwidth = i:<픽셀 단위 값> x
도메인 = s:<문자열> x x x
전체 주소 = s:<문자열> x x x
gatewayhostname = s:<문자열> x x x
gatewayusagemethod = i:<1 또는 2> x x x
클라이언트에서 자격 증명 확인 = i:<0 또는 1> x
loadbalanceinfo = s:<문자열> x x x
redirectprinters = i:<0 또는 1> x
remoteapplicationcmdline = s:<문자열> x x x
remoteapplicationmode = i:<0 또는 1> x x x
remoteapplicationprogram = s:<문자열> x x x
셸 작업 디렉터리 = s:<문자열> x x x
리디렉션 서버 이름 사용 = i:<0 또는 1> x x x
사용자 이름 = s:<문자열> x x x
화면 모드 ID = i:<1 또는 2> x
세션 bpp = i:<8, 15, 16, 24 또는 32> x
멀티 모니터 사용 = i:<0 또는 1> x