

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

# 에이전트 구성 파일
<a name="agent-file"></a>

에이전트 구성 파일(`/etc/dcv-session-manager-agent/agent.conf`Linux 및 macOS의 경우 , Windows`C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf`의 경우 )에는 세션 관리자 기능을 사용자 지정하도록 구성할 수 있는 파라미터가 포함되어 있습니다. 원하는 텍스트 편집기를 사용하여 구성 파일을 편집할 수 있습니다.

다음 표에는 에이전트 구성 파일의 파라미터가 나열되어 있습니다.


| 파라미터 이름 | 필수 | 기본값  | 설명 | 
| --- | --- | --- | --- | 
| agent.broker\$1host | 예 |  | 브로커 호스트의 DNS 이름을 지정합니다. | 
| agent.broker\$1port | 예 | 8445 | 브로커와 통신할 포트를 지정합니다. | 
| agent.ca\$1file | 아니요 |  | tls\$1strict가 true로 설정된 경우에만 필요합니다. TLS 인증서를 검증하는 데 필요한 인증서(.pem) 파일의 경로를 지정합니다. 브로커에서 에이전트로 자체 서명된 인증서를 복사합니다. | 
| agent.init\$1folder | 아니요 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/dcv/latest/sm-admin/agent-file.html)  | Amazon DCV 서버 세션을 만들 때 초기화할 수 있는 사용자 지정 스크립트를 저장하는 데 사용되는 호스트 서버의 폴더 경로를 지정합니다. 절대 경로를 지정해야 합니다. CreateSessions API의 InitFile 요청 파라미터를 사용하는 사용자가 폴더에 접근할 수 있고 파일을 실행할 수 있어야 합니다. | 
| agent.tls\$1strict | 아니요 | true | 엄격한 TLS 검증을 사용해야 하는지 여부를 나타냅니다. | 
| agent.software\$1statement\$1path | 아니요 |  | 기본 소프트웨어 명령문을 사용하지 않는 경우에만 필요합니다. 소프트웨어 명령문 파일의 경로를 지정합니다. 자세한 내용은 [generate-software-statement](generate-software-statement.md) 단원을 참조하십시오. | 
| agent.tags\$1folder | 아니요 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/dcv/latest/sm-admin/agent-file.html)  | 태그 파일이 있는 폴더의 경로를 지정합니다. 자세한 내용은 [태그를 사용하여 Amazon DCV 서버를 대상으로 지정](targeting.md) 단원을 참조하십시오. | 
| agent.autorun\$1folder | 아니요 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/dcv/latest/sm-admin/agent-file.html)  | 세션 시작 시 자동으로 실행되도록 허용된 스크립트와 앱을 저장하는 데 사용되는 호스트 서버의 폴더 경로를 지정합니다. 절대 경로를 지정해야 합니다. CreateSessions API의 AutorunFile 요청 파라미터를 사용하는 사용자가 폴더에 접근할 수 있고 파일을 실행할 수 있어야 합니다. | 
| agent.max\$1virtual\$1sessions | 아니요 | -1 (제한 없음) | Amazon DCV 세션 관리자를 사용하여 Amazon DCV 서버에 생성할 수 있는 최대 가상 세션 수입니다. | 
| agent.max\$1concurrent\$1sessions\$1per\$1user | 아니요 | 1 | Amazon DCV 세션 관리자를 사용하여 단일 사용자가 Amazon DCV 서버에 생성할 수 있는 최대 가상 세션 수입니다. | 
| agent.broker\$1update\$1interval | 아니요 | 30 | 업데이트된 데이터를 브로커에 전송하기 전에 대기할 시간(초)을 지정합니다. 전송된 데이터에는 업데이트된 세션 정보뿐만 아니라 Amazon DCV 서버 및 호스트 상태가 포함됩니다. 값이 낮을수록 세션 관리자는 에이전트가 실행되는 시스템에서 발생하는 변경 사항을 더 잘 인식하지만, 시스템 부하와 네트워크 트래픽이 증가합니다. 값이 높을수록 시스템 및 네트워크 부하가 감소하지만, 시스템 변경에 대한 세션 관리자의 응답성이 떨어지므로 120보다 큰 값은 사용하지 않는 것이 좋습니다. | 
| agent.enable\$1query\$1logged\$1in\$1users | 아니요 | true | Windows에서 로깅된 사용자 가져오기를 활성화합니다. true인 경우는 시스템에서 실제 로그인한 사용자를 쿼리합니다. false인 경우 'unknown'을 반환합니다. | 
| agent.preferred\$1network\$1interface | 아니요 |  | 호스트 IP 감지에 사용할 네트워크 인터페이스 이름을 지정합니다. 예: eth0 (Linux), Ethernet 4 (Windows). Linux/macOS 이름은 대/소문자를 구분하고 Windows 이름은 대/소문자를 구분하지 않습니다. 지정하지 않거나 지정된 네트워크 인터페이스를 찾을 수 없는 경우 루프백이 아닌 첫 번째 인터페이스가 선택됩니다. | 
| log.level | 아니요 | info | 로그 파일 세부 수준을 지정합니다. 다음 세부 수준을 사용할 수 있습니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/dcv/latest/sm-admin/agent-file.html)  | 
| log.directory | 아니요 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/dcv/latest/sm-admin/agent-file.html)  | 로그 파일을 생성할 디렉터리를 지정합니다. | 
| log.rotation | 아니요 | daily | 로그 파일 순환을 지정합니다. 유효값은 다음과 같습니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/dcv/latest/sm-admin/agent-file.html) | 
| log.max-file-size | 아니요 | 10485760 | 로그 파일 크기가 지정된 크기(바이트 단위)에 도달하면 파일이 순환됩니다. 새 로그 파일이 생성되고 새 파일에 추가 로그 이벤트가 배치됩니다. | 
| log.rotate | 아니요 | 9 | 순환에서 보존되는 최대 로그 파일 수입니다. 순환이 발생하고 이 수에 도달할 때마다 가장 오래된 로그 파일이 삭제됩니다. | 