ldapsearch 参数表

下表描述可以用于 ldapsearch 的区分大小写的参数。

关于此任务

表 1. 用于 ldapsearch 的参数

参数

用途

-?

打印关于使用 ldapsearch 的帮助。

-a deref

指定别名反向引用。 请输入 never、always、search 或 find。 如果不使用此参数,那么缺省值为 never。

-A

只检索属性的名称,而不检索属性的值。

-b base dn

指定用作搜索起始点的专有名称。 使用引号来指定该值,例如:"ou=West,o=Renovations,c=US"

如果要搜索的服务器需要指定搜索起点,则必须使用此参数。 否则此参数是可选的。

(可选)将 -s-b 一起使用来确定搜索范围。没有 -s-b 就会搜索指定为起始点的条目以及该条目的所有后代。

-B

允许打印非 ASCII 值

-D bind dn

指定服务器用于认证您的专有名称。 名称必须与目录中的条目相符,并且必须拥有搜索目录所需的权限。

在引号中指定该名称,例如:"cn=Directory Manager,o=Renovations,c=US"

如果不使用此参数,则与服务器的连接是匿名的。 如果服务器不允许匿名连接,那么必须使用 -D

除了 -D,还必须使用 -w 参数来指定与专有名称相关联的密码。

-f file

指定包含要使用的搜索过滤器的文件,例如 -f 过滤器。请将每个搜索过滤器置于单独的一行。Ldapsearch 会对每一行执行一次搜索。 可选择指定过滤模式。 例如,指定 -f 过滤器 cn=%s,并在文件的每一行中输入公共名称的值。

-F sep

在属性名称和值之间打印 sep 而不是等号 (=)。例如,如果读取 ldapsearch 输出的工具希望使用其他的分隔符时,可以使用此参数。

-h host name

指定要连接到的服务器的主机名,例如,-h server.renovations.com

-l timelimit

指定完成搜索的时间限制(秒)。 如果没有指定此参数或指定的限制为 0,那么搜索就没有时间限制。但是,ldapsearch 的等待时间决不会超过服务器上设置的搜索时间限制。

-L

指定以 LDIF 格式输出。 LDIF 格式使用冒号 (:) 而不是等号 (=) 作为属性描述符。 LDIF 对一次性添加或修改大量目录条目很有帮助。 例如,可以将输出内容导入兼容 LDAP 的目录中。

-M

将参考对象作为普通条目进行管理,以使 ldapsearch 可返回参考条目本身的属性,而不是所参考的条目的属性。

-n

显示如何执行搜索,但不实际执行搜索

-p port

指定服务器使用的端口。 如果没有使用此参数,缺省情况下 ldapsearch 使用 389 端口。

-R

不自动遵循服务器返回的搜索引用。

-s scope

指定使用 -b 参数时的搜索范围:

  • base - 仅搜索使用 -b 参数指定的条目
  • onelevel - 仅搜索使用 -b 参数指定的条目的直接子条目,但不搜索该条目本身
  • subtree - 搜索使用 -b 参数指定的条目及其所有后代。这是使用 -b 而不使用 -s 时的缺省行为。

指定 -b-s 的顺序并不重要。

-S attribute

按指定的属性排序结果。

-z sizelimit

指定返回条目的最大数目。 如果没有指定此参数或指定的限制为 0,那么返回的条目没有数量限制。但是,ldapsearch 返回的条目决不会多于服务器允许的数量。

-u

指定 ldapsearch 以用户友好格式返回专有名称。

-v

指定 ldapsearch 以详尽方式运行。

-w password

指定与 -D 参数一起使用的专有名称的关联密码。

-x

-S 一起使用以指定该 LDAP 服务器在先对结果排序再将其返回。如果使用 -S 而不使用 -x,ldapsearch 将对结果排序。