2.14. cn=tasks,cn=config 下条目的通用任务调用属性
一些核心目录服务器，可以使用 LDAP 工具编辑目录条目来启动任务。这些任务条目包含在 cn=tasks,cn=config 中。可以通过更新条目来调用每个任务，例如：
dn: cn=task_id,cn=task_type,cn=tasks,cn=config ...
本节列出了所有任务类型的通用属性。
任务条目不是永久配置条目。它们仅在任务操作正在运行或直到 ttl 周期过期时才存在于配置文件中。然后，服务器自动删除该条目。
2.14.1. cn
cn 属性标识要启动的新任务操作。cn 属性值可以是任意的，只要它定义了新任务。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | 任何字符串 |
| 默认值 | |
| 语法 | DirectoryString |
| 示例 | cn: example task entry name |
2.14.2. nsTaskCancel
此属性允许在进行过程中中止任务。此属性可以被用户修改。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | true | false |
| 默认值 | |
| 语法 | 不区分大小写的字符串 |
| 示例 | nsTaskCancel: true |
2.14.3. nsTaskCurrentItem
此属性显示任务操作完成的子任务数量，假设任务可以分为子任务。如果只有一个任务，则 nsTaskCurrentItem 在任务运行时为 0，在任务完成后为 1。这样，属性与进度条类似。当 nsTaskCurrentItem 属性的值与 nsTaskTotalItems 相同时，任务已完成。
此属性值由服务器设置，不应 编辑。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | 0 到最大 32 位整数值(2147483647) |
| 默认值 | |
| 语法 | 整数 |
| 示例 | nsTaskCurrentItem: 148 |
2.14.4. nsTaskExitCode
此属性包含任务的退出代码。此属性仅在任务完成后存在，且任何值仅在任务完成后有效。结果代码可以是任何 LDAP 退出代码，但只有 0 值等于成功；任何其他结果代码都是错误。
此属性值由服务器设置，不应 编辑。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | 0 （成功）到 97[a] |
| 默认值 | |
| 语法 | 整数 |
| 示例 | nsTaskExitCode: 0 |
[a]
0 以外的任何响应都是一个错误。
| |
2.14.5. nsTaskLog
此条目包含任务的所有日志消息，包括警告和信息消息。新消息会附加到条目值的末尾，因此此属性值会增大，而不默认删除原始内容。
成功的任务操作( nsTaskExitCode 为 0) 仅在 nsTaskLog 属性中记录。任何非零响应（表示错误）都可以记录为错误，但错误消息仅记录在 nsTaskLog 属性中。因此，使用 nsTaskLog 属性中的信息来查找发生哪些错误。
此属性值由服务器设置，不应 编辑。
2.14.6. nsTaskStatus
此属性包含有关任务状态的更改信息，如累积统计数据或其当前输出消息。只要进程正在运行，属性的整个内容可能会定期更新。
此属性值由服务器设置，不应 编辑。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | 任何字符串 |
| 默认值 | |
| 语法 | case-exact 字符串 |
| 示例 | nsTaskStatus: Loading entries…. |
2.14.7. nsTaskTotalItems
此属性显示必须为任务操作完成的子任务总数。当 nsTaskCurrentItem 属性的值与 nsTaskTotalItems 相同时，任务已完成。
此属性值由服务器设置，不应 编辑。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | 0 到最大 32 位整数值(2147483647) |
| 默认值 | |
| 语法 | 整数 |
| 示例 | nsTaskTotalItems: 152 |
2.14.8. ttl
此属性设置任务条目在任务完成或中止后仍保留在 DSE 的时间（以秒为单位）。设置 ttl 属性允许针对新状态信息轮询任务条目，而不缺少退出代码。将 ttl 属性设置为 0 表示该条目不会被缓存。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | 0 （不能缓存）到最大 32 位整数值(2147483647) |
| 默认值 | |
| 语法 | DirectoryString |
| 示例 | ttl: 120 |
