The following commands are specific to the routing IPv6 relayv6 context within the Netsh environment.
To view the command syntax, click a command:
Add commands
Delete commands
Set commands
Show commands
Netsh commands for routing IPv6 relayv6
- The following entries provide details for
each command.
dump
Displays the Dynamic Host Configuration Protocol (DHCP) Relay Agent configuration of a remote access server in script form.
Syntax
dump
Remarks
- You can dump the contents of the current
configuration to a file that can be used to restore altered
configuration settings.
Example
The following commands save the current configuration as a script in the c:\test\ipv6relaycfg.dmp file.
- From the command prompt:
netsh routing ipv6 relayv6 dump > c:\test\ipv6relaycfg.dmp
- From the netsh routing ipv6 relayv6 context
prompt:
set file open c:\test\ipv6relaycfg.dmp
dump
set file close
You can use the netsh exec command to run the script created by the netsh dump command.
add dhcpserver
Adds a DHCPv6 server to the list of DHCP servers whose messages will be forwarded by DHCPv6 Relay Agent.
Syntax
add dhcpserver
[ server = ] IPv6Address
Parameters
- [ server = ] IPv6Address
- Required. Specifies the global IPv6 address of a DHCPv6 server to add to the global list.
Example
To add a DHCPv6 server with the IPv6 address of 3000:1234:1234:1234::1 to the global list of DHCPv6 servers, type:
add dhcpserver 3000:1234:1234:1234::1
add interface
Enables the DHCPv6 Relay Agent on the specified interface.
Syntax
add interface
[ name = ] InterfaceName
Parameters
- [ name = ] InterfaceName
- Required. Specifies, by name, the interface on which you want to enable the DHCPv6 Relay Agent. The InterfaceName parameter must match the name of the interface as specified in Network Connections. If InterfaceName contains spaces, use quotation marks around the text (for example, "Interface Name").
Example
To enable the DHCPv6 Relay Agent on the “Local Area Connection” interface, type:
add interface "Local Area Connection"
delete interface
Disables DHCPv6 Relay Agent on the specified interface.
Syntax
delete interface
[ name = ] InterfaceName
Parameters
- [ name = ] InterfaceName
- Required. Specifies, by name, the interface on which you want to disable the DHCPv6 Relay Agent. The InterfaceName parameter must match the name of the interface as specified in Network Connections. If InterfaceName contains spaces, use quotation marks around the text (for example, "Interface Name").
Example
To disable the DHCPv6 Relay Agent on the “Local Area Connection” interface, type:
delete interface "Local Area Connection"
delete dhcpserver
Removes a DHCPv6 server from the list of DHCPv6 servers whose messages will be forwarded by DHCPv6 Relay Agent.
Syntax
delete dhcpserver
[ server = ] IPv6Address
Parameters
- [ server = ] IPv6Address
- Required. Specifies, by IPv6 address, the DHCPv6 server to be removed from the global list.
Example
To delete a DHCPv6 server with the IPv6 address of 3000:1234:1234:1234::1 from the global list of DHCPv6 servers, type:
delete dhcpserver 3000:1234:1234:1234::1
set global
Sets global parameters for DHCPv6 Relay Agent configuration.
Syntax
set global
[ loglevel = ] { none | error | warn | info }
Parameters
- [ loglevel = ] { none | error | warn | info }
- Required. Specifies which DHCPv6 Relay Agent events should be
logged.
- none specifies that no events related
to DHCPv6 Relay Agent should be logged.
- error specifies that only errors
related to DHCPv6 Relay Agent should be logged.
- warn specifies that both errors and
warnings related to DHCPv6 Relay Agent should be logged.
- info specifies that all events related
to DHCPv6 Relay Agent should be logged.
- none specifies that no events related
to DHCPv6 Relay Agent should be logged.
Example
To configure global parameters for DHCPv6 Relay Agent to not log events, type:
set global loglevel=none
set interface
Modifies the DHCPv6 Relay Agent configuration on an interface.
Syntax
set interface
[ name = ] InterfaceName
[ relaymode = ] { enable | disable }
[ [ maxhop = ] Integer ]
[ [ minsecs = ] Integer ]
Parameters
- [ name = ] InterfaceName
- Required. Specifies, by name, the interface on which you want to modify the configuration of DHCPv6 Relay Agent. The InterfaceName parameter must match the name of the interface as specified in Network Connections. If InterfaceName contains spaces, use quotation marks around the text (for example, "Interface Name").
- [ relaymode = ] { enable | disable }
- Required. Specifies whether the DHCPv6 Relay Agent is enabled or disabled.
- [ maxhop = ] Integer
- Specifies the number of hops a DHCPv6 packet can make before it should be dropped and should no longer be relayed.
- [ minsecs = ] Integer
- Specifies the minimum number of seconds from boot time that must appear in a DHCPv6 packet before it should be sent to a DHCPv6 server in the list of servers whose messages will be forwarded by DHCPv6 Relay Agent.
Example
To update the DHCPv6 Relay Agent configuration on the “Local Area Connection” interface with a maximum hop count of 16 and a value of 3200 seconds for the minimum seconds from boot time, type:
set interface name="Local Area Connection" enable 16 3200
show interface
Displays configuration information for the DHCPv6 Relay Agent on the specified interface. Used without parameters, show interface displays DHCPv6 Relay Agent configuration information for all interfaces.
Syntax
show interface
[ name = ] InterfaceName
Parameters
- [ name = ] InterfaceName
- Required. Specifies, by name, the interface for which you want to display information. The InterfaceName parameter must match the name of the interface as specified in Network Connections. If InterfaceName contains spaces, use quotation marks around the text (for example, "Interface Name").
show global
Displays DHCPv6 Relay Agent global configuration.
Syntax
show global
install
Installs the DHCPv6 Relay Agent under IPv6.
Syntax
install
uninstall
Removes the DHCPv6 Relay Agent component from under IPv6.
Syntax
uninstall