DHCP Option Manager

注意：要仅显示特定设备上存在的功能，请从下面的 SmartDocs 栏中选择一个或多个过滤器。

StageNow - 2.10

概述

DHCP Option Manager (DhcpOptionMgr) 允许应用程序配置设备上的动态主机配置协议 (DHCP) 的选项。这样，就可以通过允许使用 DHCP 协议自动配置网络设置，如设备 IP 地址和默认网关，而不需要让用户或管理员手动配置，从而简化了设备管理。

在设备上使用 DHCP 时，设备上的 DHCP 客户端向 DHCP 服务器发送请求，然后收到 DHCP 确认。设备发送的 DHCP 请求可能包含与设备或 DHCP 客户端有关的信息，可能包含从 DHCP 服务器获得更多信息的请求。DHCP 服务器发送的 DHCP 确认包含由 DHCP 服务器分配给设备的 IP　地址，以及设备在　DHCP　请求中请求的任何附加信息。

“DHCP 选项”是可变长度字符串，用 DHCP 选项编号标识，这些选项编号可能包含在 DHCP 请求或 DHCP 确认中，用来在 DHCP 客户端和 DHCP 服务器之间传达信息。从正在运行 DHCP 客户端的设备的角度，DHCP 选项可以支持写入模式（如果 DHCP 客户端在 DHCP 请求中发送选项到 DHCP 服务器）或读取模式（如果 DHCP 客户端在 DHCP 确认中接收来自 DHCP 服务器的信息）。DHCP 可能支持各种各样的 DHCP 选项，包括可能由设备供应商或最终客户定义的自定义选项。

主要功能

  • 启用/禁用以及设置以下所列的可配置 DHCP 选项的值：
DHCP 选项编号 DHCP 选项名称 默认状态 可配置 支持的模式
1 子网掩码 开 否 读取
3 路由器 开 否 读取
6 域名服务器 开 否 读取
12 主机名 开 是 写入
15 域名 开 否 读取
28 广播地址 关 是 读取
42 NTP 服务器 关 是 读取
43 供应商封装 关 是 读取
51 租赁时间 开 否 读取
60 供应商类 ID 关 是 写入
61 客户端标识符 关 是 写入
66 TFTP 服务器名称 关 是 读取
67 引导文件名 关 是 读取
77 用户类 开 是 写入
81 FQDN 关 是 写入
119 域搜索列表 关 是 读取
150 TFTP 服务器地址 关 是 读取
186 供应商特定 1 关 是 读取
188 供应商特定 2 关 是 读取
230 供应商特定 3 关 是 读取

注意：在上表中显示为不可配置的 DHCP 选项在 Zebra Android 设备上受支持，但是始终启用，不能使用 DhcpOptionMgr 以任何方式修改它们的操作。

主机名 (12)

控制 DHCP 客户端是否通过主机名 DHCP 选项将主机名发送到 DHCP 服务器。主机名通常由 DHCP 服务器用来识别网络上的设备和/或跟踪已分配 IP 地址的设备。

参数名称：HostNameState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：4.4+
1 启用 此值将导致此 DHCP 选项被打开，从而导致指定的主机名选项将由 DHCP 客户端在 DHCP 请求中发送到 DHCP 服务器。

MX：4.4+
2 禁用 此值将导致此 DHCP 选项被关闭，从而阻止 DHCP 客户端将主机名发送到 DHCP 服务器。

MX：4.4+

主机名选项值

用于指定将由 DHCP 客户端在 DHCP 请求中发送到 DHCP 服务器的主机名。

参数值输入规则：

  • 1 到 91 个字符的字符串，其中包含主机名

在以下条件下显示：主机名为“启用”

参数名称：HostNameValue

需要：

  • MX：4.4+

广播地址 (28)

网络的广播地址是允许该网络上的所有设备都接收到消息的 IP 地址。因此，发送到网络的广播地址的消息可被网络上的所有设备而不是某个特定设备收到。

此参数允许您控制对广播地址的请求是否通过 DHCP 客户端在 DHCP 请求中发送给 DHCP 服务器。在收到请求时，DHCP 服务器会在 DHCP 确认中将网络的广播地址返回到设备。

参数名称：BroadcastAddrState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：4.4+
1 启用 此值将导致此 DHCP 选项被打开，从而导致 DHCP 客户端在 DHCP 请求中请求广播地址。

MX：4.4+
2 禁用 此值将导致此 DHCP 选项被关闭，从而阻止 DHCP 客户端在 DHCP 请求中请求广播地址。

MX：4.4+

NTP 服务器 (42)

控制对 NTP 服务器地址的请求是否由 DHCP 客户端在 DHCP 请求中发送给 DHCP 服务器。在收到请求时，DHCP 服务器会在 DHCP 确认中将 NTP 服务器地址返回到设备。

一个 NTP（网络时间协议）服务器是能够向设备提供当前日期和时间的服务器。设备通常必须知道 NTP 服务器的名称或地址，才能查询该服务器以获取日期和时间。

注意：DHCP 客户端不会自动使用此 DHCP 选项返回的值来配置设备从返回的 NTP 服务器获取日期和时间。要将设备配置为从 NTP 服务器获取日期和时间，返回的 NTP 服务器地址的值需要使用 DhcpOptionMgr 获取，然后用于通过时钟配置 AutoTime。

参数名称：NTPServerState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：4.4+
1 启用 此值将导致此 DHCP 选项被打开，从而导致 DHCP 客户端在 DHCP 请求中请求 NTP 服务器地址。

MX：4.4+
2 禁用 此值将导致此 DHCP 选项被关闭，从而阻止 DHCP 客户端在 DHCP 请求中请求 NTP 服务器地址。

MX：4.4+

供应商封装 (43)

“供应商封装”也称为“供应商特定”，是一个 DHCP 选项，可由 DHCP 客户端请求。此选项的值由 DHCP 服务器的特定供应商确定。在可能有多个供应商的复杂网络环境中，此选项通常与选项 60 结合使用，使得能够对给定的设备使用正确的 DHCP 服务器。

参数名称：VendorEncapsulatedState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：5.0+
1 启用 此值将导致此 DHCP 选项被打开，从而导致 DHCP 客户端在 DHCP 请求中请求供应商特定选项 43。

MX：5.0+
2 禁用 此值将导致此 DHCP 选项被关闭，从而导致 DHCP 客户端在 DHCP 请求中请求供应商特定选项 43。

MX：5.0+

供应商类标识符 (60)

控制 DHCP 客户端是否通过供应商类 DHCP 选项将供应商类发送到 DHCP 服务器。这种支持允许 DHCP 中继将接收的 DHCP 客户端数据包中的选项 60 字符串与应用程序或管理员在路由器上配置的字符串作比较。在网络环境中提供融合服务时可使用 DHCP 中继选项 60 功能 — 选项 60 支持使 DHCP 中继能够将客户端流量定向到提供客户端所请求服务的特定 DHCP 服务器（供应商-选项服务器）。

另一个选项允许选项 60 字符串配置为将流量定向到当前虚拟路由器中的 DHCP 本地服务器。例如，想象在一个环境中，某个 DHCP 客户端仅需要访问互联网，而其他客户端需要 IPTV 服务。需要访问互联网的客户端将获取本地 DHCP 服务器在 E 系列路由器上分配的地址（平等访问模式）。需要 IPTV 的客户端必须中继到提供该服务的 DHCP 服务器。要支持两种类型的客户端，需要在 DHCP 中继上配置两个选项 60 字符串。在配置选项 60 字符串的情况下收到 DHCP 客户端数据包时，必须将字符串与 DHCP 中继上配置的所有字符串匹配。如果客户端字符串与第一个配置的字符串匹配，则将该客户端定向到 DHCP 服务器，并获得互联网接入。选项 60 字符串与第二个字符串匹配的选项将中继到 IPTV 服务的 DHCP 服务器。此外，还可以配置一个在客户端选项 60 字符串与预配置的字符串都不匹配时由 DHCP 中继执行的默认操作。例如，字符串不匹配的客户端就可能会掉线。

参数名称：VendorClassIdState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：5.0+
1 启用 此值将导致此 DHCP 选项被打开，从而导致指定的供应商类将由 DHCP 客户端在 DHCP 请求中发送到 DHCP 服务器。

MX：5.0+
2 禁用 此值将导致此 DHCP 选项被关闭，从而阻止 DHCP 客户端将供应商类发送到 DHCP 服务器。

MX：5.0+

供应商类值

用于指定将由 DHCP 客户端在 DHCP 请求中发送到 DHCP 服务器的供应商类值。

参数值输入规则：

  • 1 到 91 个字符的字符串，其中包含供应商类值

在以下条件下显示：供应商类为“启用”

参数名称：VendorClassIdValue

需要：

  • MX：5.0+

客户端标识符启用/禁用 (61)

控制是否可以指定一个用于标识网络上设备的自定义客户端标识符值，用于代替客户端的 MAC　地址。当启用时，允许使用　ClientIdentifierValue 参数指定标识符。当禁用时，将通过 MAC 地址来识别设备。

参数名称：ClientIdentifier

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：6.3+
1 启用 允许指定客户端标识符。

MX：6.3+
2 禁用 阻止指定客户端标识符。

MX：6.3+

客户端标识符值

用于指定可代替　MAC　地址的客户端标识符，用来标识网络上的设备。

参数值输入规则：

  • 1 到 91 个字符的字符串，其中包含类标识符值

在以下条件下显示：客户端标识符设置为“启用”

参数名称：ClientIdentifierValue

需要：

  • MX：6.3+

TFTP　服务器名称启用/禁用 (66)

控制对 TFTP 服务器名称的请求是否由 DHCP 客户端在 DHCP 请求中发送给 DHCP 服务器。在收到请求时，DHCP 服务器会在 DHCP 确认中将 TFTP 服务器名称返回到设备。

TFTP（普通文件传输协议）服务器为远程客户端提供了获取或放入文件的简单方法。TFTP 的主要用途是在首次加入网络时配置设备。之所以使用 TFTP，是因为它实施起来简单，但是必须谨慎使用，因为它缺乏安全性以及其他更多高级文件传输功能。

重要说明：DHCP 客户端不会自动使用获取的　TFTP 服务器名称来执行文件传输或配置。要使用 TFTP　配置设备，可使用 DhcpOptionMgr 　获取 TFTP 服务器名称，并将它提供给执行文件传输的 TFTP 客户端。然后，可以使用传输的文件来执行所需的配置。

参数名称：TFTPServerNameState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：4.4+
1 启用 此值将导致此 DHCP 选项被打开，从而导致　TFTP　客户端在 DHCP 请求中请求 TFTP 服务器名称。

MX：4.4+
2 禁用 此值将导致此 DHCP 选项被关闭，从而阻止 DHCP 客户端在 DHCP 请求中请求 TFTP 服务器名称。

MX：4.4+

TFTP 服务器名称　(66)

注意：此参数已被弃用。改用 TFTPServerNameState.

参数名称：TFTPSerNameState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：4.4+
1 启用 此值将导致此 DHCP 选项被打开，从而导致　TFTP　客户端在 DHCP 请求中请求 TFTP 服务器名称。

MX：4.4+
2 禁用 此值将导致此 DHCP 选项被关闭，从而阻止 DHCP 客户端在 DHCP 请求中请求 TFTP 服务器名称。

MX：4.4+

引导文件名启用/禁用 (67)

控制对引导文件名的请求是否由 DHCP 客户端在 DHCP 请求中发送给 DHCP 服务器。在收到请求时，DHCP 服务器会在 DHCP 确认中将引导文件名返回到设备。

引导文件是通常用来在设备首次加入网络时配置设备的文件。常见的使用场景是，从 TFTP 服务器中提取给定名称的引导文件，然后使用该引导文件配置设备。

注意：DHCP 客户端不会自动使用引导文件名执行任何文件传输或配置。要配置设备，需要使用 DhcpOptionMgr 获取引导文件名和 TFTP 服务器名称，然后提供给可能执行引导文件传输并使用该文件执行所需配置的 TFTP 客户端。

参数名称：BootFileState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：4.4+
1 启用 此值将导致此 DHCP 选项被打开，从而导致　DHCP 客户端在 DHCP 请求中请求引导文件名称。

MX：4.4+
2 禁用 此值将导致此 DHCP 选项被关闭，从而阻止 DHCP 客户端在 DHCP 请求中请求引导文件名称。

MX：4.4+

用户类启用/禁用 (77)

控制 DHCP 客户端是否通过用户类 DHCP 选项将用户类发送到 DHCP 服务器。用户类通常由 DHCP 服务器用来选择要从中获取分配给设备的 IP 地址的正确 IP 地址池。它也可能由 DHCP 服务器用来确定应该在 DHCP 确认中向设备返回哪些附加信息。

参数名称：UserClassState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：4.4+
1 启用 此值将导致此 DHCP 选项被打开，从而导致指定的用户类将由 DHCP 客户端在 DHCP 请求中发送到 DHCP 服务器。

MX：4.4+
2 禁用 此值将导致此 DHCP 选项被关闭，从而阻止 DHCP 客户端将用户类发送到 DHCP 服务器。

MX：4.4+

用户类值

用于指定将由 DHCP 客户端在 DHCP 请求中发送到 DHCP 服务器的用户类值。

参数值输入规则：

  • 1 到 91 个字符的字符串，其中包含用户类值

在以下条件下显示：用户类为“启用”

参数名称：HostNameValue

需要：

  • MX：4.4+

FQDN 启用/禁用 (81)

控制 DHCP 客户端是否可以将完全限定域名 (FQDN) 值和可选标记发送到 DHCP 服务器，作为更新 IP 地址到 FQDN 映射的方式。

FQDN 是特定 Internet 主机的完整域名，包括它的主机名和域名。例如，Google 的 Gmail 服务器的 FQDN“mail.google.com”包括主机名“mail”和域名“google.com”。服务器的主机名用来将它与 Google.com 域中的其他服务器区分别开，它的域名则将 Google 的邮件服务器与其他公共邮件服务器区分开。

有关 FQDN 选项的完整信息，请参阅 IETF 的 FQDN 选项页面。

参数名称：FqdnState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：6.3+
1 启用 允许 DHCP 客户端发送 FQDN 值和可选标记。

MX：6.3+
2 禁用 阻止 DHCP 客户端发送 FQDN 信息。

MX：6.3+

FQDN 值

用于指定 DHCP 客户端要向 DHCP 服务器传达的完全限定域名 (FQDN)。

参数值输入规则：

  • 1 到 91 个字符的字符串，其中包含 FQDN 值

在以下条件下显示：FQDN 设置为“启用”

参数名称：FqdnValue

需要：

  • MX：6.3+

FQDN 标记值

用于指定可选 FQDN 标记的值，DHCP 客户端可使用它来传达有关 DNS 更新的信息。

参数值输入规则：

  • 刚好 7 个字符的字符串，其中包含一个 FQDN 标记值

在以下条件下显示：FQDN 设置为“启用”

参数名称：FqdnFlagValue

需要：

  • MX：6.3+

域搜索启用/禁用 (119)

控制对域搜索列表的请求是否由 DHCP 客户端在 DHCP 请求中发送给 DHCP 服务器。在收到请求时，DHCP 服务器会在 DHCP 确认中将网络的域搜索列表返回到设备。

域名系统 (DNS) 是一个分层的分布式命名系统，用于将域名与 IP 地址关联。在设法解析名称时，可能需要按优先顺序联系一个或多个域名服务器，直到成功解析名称。网络的域搜索列表是用来解析该网络上的名称的 DNS 服务器地址的有序列表。

注意：DHCP 客户端不会自动使用域搜索列表配置 DNS 客户端基于该列表解析名称。这可能是未来的一个增强功能，当 DNS 客户端提供了配置它使用此类列表的方式时。与此同时，如果需要基于此列表执行名称解析，将会在应用程序级别实施。应用程序将需要使用 DhcpOptionMgr 获取域搜索列表，然后利用该列表中提供的信息来驱动一个从所列域的 DNS 服务器中请求名称解析的显式流程。

参数名称：DomainSearchState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：4.4+
1 启用 此值将导致此 DHCP 选项被打开，从而导致　DHCP 客户端在 DHCP 请求中请求域搜索列表。

MX：4.4+
2 禁用 此值将导致此 DHCP 选项被关闭，从而阻止 DHCP 客户端在 DHCP 请求中请求域搜索列表。

MX：4.4+

TFTP 服务器地址启用/禁用 (150)

控制对 TFTP 服务器地址的请求是否由 DHCP 客户端在 DHCP 请求中发送给 DHCP 服务器。在收到请求时，DHCP 服务器会在 DHCP 确认中将 TFTP 服务器地址返回到设备。

TFTP 服务器地址 DHCP 选项（选项 150）基本上就是标准 TFTP 服务器名称 DHCP 选项（选项编号 150）的 Cisco 专有版本。

注意：DHCP 客户端不会自动使用 TFTP 服务器地址执行任何文件传输或配置。要使用 TFTP 配置设备，需要使用 DhcpOptionMgr 获取 TFTP 服务器地址，然后提供给可能执行一个或多个文件的传输并使用这些文件执行所需配置的 TFTP 客户端。

参数名称：TFTPServerAddrState

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）将导致不更改此 DHCP 选项的配置方式。

MX：4.4+
1 启用 此值将导致此 DHCP 选项被打开，从而导致 DHCP 客户端在 DHCP 请求中请求 TFTP 服务器地址。

MX：4.4+
2 禁用 此值将导致此 DHCP 选项被关闭，从而阻止 DHCP 客户端在 DHCP 请求中请求 TFTP 服务器地址。

MX：4.4+

供应商特定 186 启用/禁用

控制 DHCP 客户端是否可以请求供应商特定选项 186。此请求的可能返回值由 DHCP 服务器供应商确定。

参数名称：VendorSpecific1State

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）导致不会更改如何配置此 DHCP 选项；任何以前选择的设置都将保留。

MX：5.0+
1 启用 允许 DHCP 客户端请求供应商特定选项 186。

MX：5.0+
2 禁用 阻止请求供应商特定选项 186。

MX：5.0+

供应商特定 188 启用/禁用

控制 DHCP 客户端是否可以请求供应商特定选项 188。此请求的可能返回值由 DHCP 服务器供应商确定。

参数名称：VendorSpecific2State

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）导致不会更改如何配置此 DHCP 选项；任何以前选择的设置都将保留。

MX：5.0+
1 启用 允许 DHCP 客户端请求供应商特定选项 188。

MX：5.0+
2 禁用 阻止请求供应商特定选项 188。

MX：5.0+

供应商特定 230 启用/禁用

控制 DHCP 客户端是否可以请求供应商特定选项 230。此请求的可能返回值由 DHCP 服务器供应商确定。

参数名称：VendorSpecific230State

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）导致不会更改如何配置此 DHCP 选项；任何以前选择的设置都将保留。

MX：6.3+
1 启用 允许 DHCP 客户端请求供应商特定 DHCP 选项 230。

MX：6.3+
2 禁用 阻止请求供应商特定 DHCP 选项 230。

MX：6.3+