本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 代理配置文件
<a name="agent-file"></a>

代理配置文件（`/etc/dcv-session-manager-agent/agent.conf`适用于 Linux 和 macOS 以及 `C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf` Windows）包括可以配置为自定义会话管理器功能的参数。您可以使用常用的文本编辑器编辑配置文件。

下表列出了 Agent 配置文件中的参数。


| 参数名称 | 必需 | 默认 值 | Description | 
| --- | --- | --- | --- | 
| agent.broker\_host | 是 |  | 指定 Broker 主机的 DNS 名称。 | 
| agent.broker\_port | 是 | 8445 | 指定用于与 Broker 通信的端口。 | 
| agent.ca\_file | 否 |  | 只有在 tls\_strict 设置为 true 时才需要。指定验证 TLS 证书所需的证书（.pem）文件的路径。将自签名证书从 Broker 复制到 Agent。 | 
| agent.init\_folder | 否 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/dcv/latest/sm-admin/agent-file.html)  | 指定主机服务器上的文件夹的路径，用于存储在创建 Amazon DCV 服务器会话时允许对其进行初始化的自定义脚本。您必须指定绝对路径。该文件夹必须是可以访问的，并且这些文件必须可供使用 CreateSessionsAPI InitFile请求参数的用户执行。 | 
| agent.tls\_strict | 否 | true | 指示是否应使用严格 TLS 验证。 | 
| agent.software\_statement\_path | 否 |  | 只有在未使用默认软件声明时才需要。指定软件声明文件的路径。有关更多信息，请参阅 [generate-software-statement](generate-software-statement.md)。 | 
| agent.tags\_folder | 否 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/dcv/latest/sm-admin/agent-file.html)  | 指定标签文件所在文件夹的路径。有关更多信息，请参阅 [使用标签定位 Amazon DCV 服务器](targeting.md)。 | 
| agent.autorun\_folder | 否 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/dcv/latest/sm-admin/agent-file.html)  | 指定主机服务器上的文件夹的路径，用于存储在会话启动时允许自动运行的脚本和应用程序。您必须指定绝对路径。该文件夹必须是可以访问的，并且这些文件必须可供使用 CreateSessionsAPI AutorunFile请求参数的用户执行。 | 
| agent.max\_virtual\_sessions | 否 | -1（无限制） | 可以使用 Amazon DCV Session Manager 在 Amazon DCV 服务器上创建的最大虚拟会话数量。 | 
| agent.max\_concurrent\_sessions\_per\_user | 否 | 1 | 单个用户可以使用 Amazon DCV Session Manager 在 Amazon DCV 服务器上创建的最大虚拟会话数量。 | 
| agent.broker\_update\_interval | 否 | 30 | 指定将更新的数据发送到 Broker 之前等待的秒数。发送的数据包括 Amazon DCV 服务器和主机状态以及更新的会话信息。较低的值使 Session Manager 更早地发现运行 Agent 的系统上发生的变化，但会增加系统负载和网络流量。较高的值会降低系统和网络负载，但 Session Manager 对系统变化的响应速度变慢，因此不建议使用高于 120 的值。 | 
| agent.enable\_query\_logged\_in\_users | 否 | true | 启用在 Windows 上获取登录用户的功能。如果为 true，则在系统中查询实际登录用户。如果为 false，则返回“未知”。 | 
| agent.preferred\_network\_interface | 否 |  | 指定用于主机 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/zh_cn/dcv/latest/sm-admin/agent-file.html)  | 
| log.directory | 否 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/dcv/latest/sm-admin/agent-file.html)  | 指定在其中创建日志文件的目录。 | 
| log.rotation | 否 | daily | 指定日志文件轮换。有效值为：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/dcv/latest/sm-admin/agent-file.html) | 
| log.max-file-size | 否 | 10485760 | 在日志文件达到指定大小（以字节为单位）时，轮换日志文件。将创建新的日志文件，并将后续日志事件放置在新文件中。 | 
| log.rotate | 否 | 9 | 轮换中保留的最大日志文件数量。每次发生轮换并达到该数量时，将删除最早的日志文件。 |