기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 4단계: 연결 파일 생성(선택 사항)
<a name="using-connection-file"></a>

Windows, Linux 또는 macOS 네이티브 클라이언트를 사용하면 Amazon DCV 세션에 즉시 연결하는 데 사용할 수 있는 연결 파일을 생성할 수 있습니다.

**Topics**
+ [연결 파일 생성](#connection-file-create)
+ [지원되는 파라미터](#connection-file-params)
+ [연결 파일 실행](#connection-file-execute)

## 연결 파일 생성
<a name="connection-file-create"></a>

연결 파일은`.dcv` 파일 확장자를 가진 텍스트 기반 파일입니다. `.dcv` 파일 형식은 `.ini` 파일 형식과 비슷합니다. 파일에는 `[groups]`와 함께 파라미터와 해당 값이 포함됩니다. 그룹 및 파라미터의 형식은 다음과 같습니다.

```
[group_name]
parameter_name=parameter_value
```

예제:

```
[options]
fullscreen=true
```

클라이언트에서 직접 특정 Amazon DCV 세션에 대한 연결 파일을 생성할 수 있습니다. 아니면 텍스트 편집기를 사용하여 연결 파일을 처음부터 생성할 수도 있습니다.

**참고**  
텍스트 편집기를 사용하여 처음부터 연결 파일을 만드는 절차는 Windows, Linux 및 macOS 클라이언트에서 동일합니다.

**클라이언트에서 연결 파일을 생성하려면 다음과 같이 하세요.**

1.  클라이언트를 엽니다.

1. 파일을 생성하려는 서버와 세션에 연결합니다.

1. 오른쪽 상단에서 Amazon DCV 서버의 호스트 이름을 선택하고 **연결을 다른 이름으로 저장**을 선택합니다.

1. **다른 이름으로 저장** 창에서 파일 이름과 대상 폴더를 입력한 후, **저장**을 선택합니다.

기본적으로 연결 파일을 생성하면 파일에는 `format`, `host`, `port`, `user`, `proxytype` 파라미터가 포함됩니다. 이러한 파라미터는 파일이 생성된 세션에 연결하는 데 필요합니다. 언제든 텍스트 편집기를 사용해 파일을 편집하여 파라미터를 수동으로 사용자 지정하거나 추가할 수 있습니다.

**텍스트 편집기를 사용하여 처음부터 연결 파일을 만들려면**

1. `file_name.dcv` 파일 이름 형식으로 `.dcv` 파일을 만듭니다.

1. 선호하는 텍스트 편집기를 사용하여 `.dcv` 파일을 엽니다.

1. `[version]` 그룹 및 `format` 파라미터를 파일 맨 위에 다음 형식으로 추가합니다.

   ```
   [version]
   format=1.0
   ```
**중요**  
`.dcv` 파일에 `[version]` 그룹 및 `format` 파라미터가 포함되어 있지 않으면 구문 분석이 실패합니다.

1. 다음 형식을 사용하여 필요한 파라미터 그룹을 추가합니다.

   ```
   [group_name]
   ```

   파라미터 그룹에 대한 자세한 내용은 [지원되는 파라미터](#connection-file-params) 단원을 참조하십시오.

1. 다음 형식을 사용하여 그룹 뒤에 파라미터와 파라미터 값을 추가합니다.

   ```
   parameter_name=parameter_value
   ```
**참고**  
파라미터 이름은 대/소문자를 구분합니다.
문자열 파라미터 값을 인용 부호로 묶지 마세요.

   파라미터 및 파라미터 값에 대한 자세한 내용은 [지원되는 파라미터](#connection-file-params) 단원을 참조하십시오.

1. 변경 내용을 저장하고 `.dcv` 파일을 닫습니다.

이 절차를 사용하여 언제든 기존 연결 파일에 추가 파라미터를 추가할 수도 있습니다.

## 지원되는 파라미터
<a name="connection-file-params"></a>

현재 `.dcv` 파일은 `[version]`, `[connect]`, `[options]` 등 세 개의 파라미터 그룹에서 파라미터를 지원합니다. 다음 표에는 그룹과 사용 가능한 파라미터가 나와 있습니다.

**Topics**
+ [`[version]` 파라미터](#param-version)
+ [`[connect]` 파라미터](#param-connect)
+ [`[options]` 파라미터](#param-option)
+ [`[debug]` 파라미터](#param-debug)

### `[version]` 파라미터
<a name="param-version"></a>

**중요**  
필수 필드입니다. `.dcv` 파일에 이 그룹이 포함되어 있지 않으면 구문 분석이 실패합니다.

다음 표에는 `[version]` 그룹에서 지정할 수 있는 파라미터가 나와 있습니다.


| 파라미터 | Type | 기본값  | 설명 | 
| --- | --- | --- | --- | 
| 형식 | 문자열 |  |   필수 파라미터입니다. 이 파라미터 값은 `1.0`이어야 합니다. `.dcv` 파일에 이 파라미터가 포함되어 있지 않으면 구문 분석이 실패합니다.   | 

### `[connect]` 파라미터
<a name="param-connect"></a>

다음 표에는 `[connect]` 그룹에서 지정할 수 있는 파라미터가 나와 있습니다.


| 파라미터 | Type | 기본값  | 설명 | 
| --- | --- | --- | --- | 
| host | 문자열 |  | 세션을 호스팅하는 Amazon DCV 서버의 호스트 이름입니다. | 
| 포트 | 정수 | 8443 | Amazon DCV 서버에 연결할 때 사용할 포트입니다. | 
| weburlpath | 문자열 |  | 연결을 위한 Amazon DCV 서버의 사용자 지정 경로입니다. 예를 들어 customPath를 지정하면 클라이언트가 host:port/customPath에 연결을 시도합니다. | 
| sessionid | 문자열 |  | 연결할 Amazon DCV 세션의 ID입니다. | 
| authtoken | 문자열 |  | 연결에 사용할 인증 토큰입니다. authtoken을 지정하면 sessionid도 지정해야 합니다. authtoken을 사용할 때 user 및 password 파라미터를 생략할 수 있습니다. | 
| user | 문자열 |  | Amazon DCV 서버에 연결할 때 사용할 사용자 이름입니다. | 
| 암호 | 문자열 |  | Amazon DCV 서버에 연결할 때 사용할 암호입니다. 암호가 암호화되어 있지 않습니다. | 
| proxytype | 문자열 | SYSTEM | 사용할 프록시 유형입니다. 유효한 값에는 HTTPS, HTTP, SOCKS5\$1SOCKS, SYSTEM 또는 NONE\$1DIRECT 등이 있습니다. SYSTEM을 지정하면 컴퓨터의 프록시 설정이 사용됩니다. | 
| proxyhost | 문자열 |  | 프록시 서버를 통해 연결하는 경우 사용할 프록시 서버의 주소입니다. | 
| proxyport | Integer |  | 프록시 서버를 통해 연결하는 경우 사용할 포트입니다. | 
| proxyuser | 문자열 |  | 프록시 인증에 사용할 사용자 이름입니다. | 
| proxypassword | 문자열 |  | 프록시 인증에 사용할 암호입니다. 암호가 암호화되어 있지 않습니다. | 
| 운송 | 문자열 | auto | 데이터 전송에 사용할 프로토콜입니다. `auto`를 통해 클라이언트는 먼저 QUIC(UDP) 프로토콜을 사용하여 연결을 시도합니다. QUIC 연결이 실패하면 전송이 자동으로 `websocket`으로 돌아갑니다. 데이터 전송에 WebSocket(TCP) 프로토콜을 사용하도록 `websocket`을 지정하거나 데이터 전송에 QUIC(UDP) 프로토콜을 사용하도록 `quic`를 지정합니다. QUIC를 활성화하면 QUIC 프로토콜이 데이터 전송에 사용되고 WebSocket은 인증 트래픽에 사용됩니다. WebSocket을 활성화하면 WebSocket 프로토콜이 데이터 전송과 인증 트래픽에 모두 사용됩니다.  | 
| webport | Integer | 8443 | WebSocket(TCP) 트래픽에 사용할 포트입니다. | 
| quicport | Integer | 8443 | QUIC(UDP) 트래픽에 사용할 포트입니다. | 
| certificatevalidationpolicy | 문자열 | ask-user | 신뢰할 수 없는 인증서를 검증하기 위한 정책입니다. 값에는 strict, accept-untrusted 및 ask-user가 포함됩니다. | 

### `[options]` 파라미터
<a name="param-option"></a>

다음 표에는 `[options]` 그룹에서 지정할 수 있는 파라미터가 나와 있습니다.


| 파라미터 | Type | 기본값  | 설명 | 
| --- | --- | --- | --- | 
| fullscreen | 불 | false | 클라이언트가 전체 화면 모드로 시작해야 하는지 여부를 나타냅니다. | 
| useallmonitors | 불 | false | 전체 화면 모드를 시작할 때 클라이언트가 모든 모니터를 사용해야 하는지 여부를 나타냅니다. | 
| promptreconnect | 부울 | true | 세션에서 연결을 끊은 후 클라이언트가 다시 연결하라는 메시지를 표시해야 하는지 여부를 나타냅니다. 파라미터를 true로 설정하면 연결을 끊을 때 로그인 화면으로 리디렉션됩니다. 파라미터를 false로 설정하면 연결을 끊을 때 클라이언트가 닫힙니다. | 
| enableyuv444decoding | 부울 | false | 동적 비디오 콘텐츠를 인코딩할 때 [높은 색상 정확도(YUV 4:4:4)](using-high-color-accuracy.md)를 사용할지 여부를 나타냅니다. | 

### `[debug]` 파라미터
<a name="param-debug"></a>

다음 표에는 `[debug]` 그룹에서 지정할 수 있는 파라미터가 나와 있습니다.


| 파라미터 | Type | 기본값  | 설명 | 
| --- | --- | --- | --- | 
| loglevel | 문자열 | INFO | 값은 Debug로 설정할 수 있습니다. | 

## 연결 파일 실행
<a name="connection-file-execute"></a>

`.dcv` 연결 파일을 실행하려면 해당 파일을 찾아 두 번 클릭합니다.

또는 파일 경로를 `dcvviewer` 명령의 인수로 지정합니다.
+ Windows 클라이언트

  ```
  C:\> dcvviewer.exe path\connection_file_name.dcv
  ```
+ Linux 및 macOS 클라이언트

  ```
  $ dcvviewer path/connection_file_name.dcv
  ```