Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Netsh Routing IP IGMP Context Commands

Updated: June 3, 2009

Applies To: Windows Server 2008, Windows Server 2008 R2

The following commands are specific to the routing IP IGMP context within the Netsh environment.

To view the command syntax, click a command:

Add commands

Delete commands

Set commands

Show commands

The following entries provide details for each command.

Displays the Internet Group Management Protocol (IGMP) configuration of a remote access server in script form.

dump

  • You can dump the contents of the current configuration to a file that can be used to restore altered configuration settings.

The following commands save the current configuration as a script in the c:\test\igmpcfg.dmp file.

  • From the command prompt:

    netsh routing ip igmp dump > c:\test\igmpcfg.dmp

  • From the netsh routing ip igmp context prompt:

    set file open c:\test\igmpcfg.dmp

    dump

    set file close

You can use the netsh exec command to run the script created by the netsh dump command.

Configures IGMP on the specified interface.

add interface

name = ] InterfaceName

[ [ igmpprototype = ] { igmprtrv1 | igmprtrv2 | igmprtrv3 | igmpproxy } ]

[ [ ifenabled = ] { enable | disable } ]

[ [ robustvar = ] Integer ]

[ [ genqueryinterval = ] Integer ]

[ [ genqueryresptime = ] Integer ]

[ [ startupquerycount = ] Integer ]

[ [ startupqueryinterval = ] Integer ]

[ [ lastmemquerycount = ] Integer ]

[ [ lastmemqueryinterval = ] Integer ]

[ [ accnonrtralertpkts = ] { yes | no } ]

name = ] InterfaceName
Required. Specifies the name of the interface on which you want to configure IGMP. 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").

igmpprototype = ] { igmprtrv1 | igmprtrv2 | igmprtrv3 | igmpproxy }
Specifies the type of protocol to be configured on the interface. The default type is igmprtrv3.

ifenabled = ] { enable | disable }
Specifies whether the protocol you are configuring should be enabled or disabled. The default is enabled.

robustvar = ] Integer
Specifies the robustness variable, indicating the lossy nature of the subnet to which this interface is attached. IGMP can recover from lost IGMP packets. The value should be greater than zero (0). The default value is 2.

genqueryinterval = ] Integer
Specifies the interval, in seconds, at which general queries should be sent on the interface. The default value is 125 seconds.

genqueryresptime = ] Integer
Specifies the maximum response time, in seconds, by which hosts should respond to a general query. The default value is 10 seconds.

startupquerycount = ] Integer
Specifies the number of general queries that will be sent during startup. The default value is 2.

startupqueryinterval = ] Integer
Specifies the interval, in seconds, between general queries sent during startup. The default value is 31 seconds.

lastmemquerycount = ] Integer
Specifies the number of group-specific queries sent when notice of a host leaving the group is received. The default value is 2.

lastmemqueryinterval = ] Integer
Specifies the interval, in milliseconds, between group-specific queries. The default value is 1000 milliseconds.

accnonrtralertpkts = ] { yes | no }
Specifies whether to accept IGMP packets that do not have the router alert option set. The default is yes.

To add the “Local Area Connection” interface to use IGMP, and to modify the default startup query interval to 21 seconds, type:

add interface "Local Area Connection" startupqueryinterval=21

Installs the IGMP router/proxy component and sets global logging. Used without parameters, install installs the IGMP router/proxy and specifies that only errors related to IGMP are logged.

install

[ [ loglevel = ] { none | error | warn | info } ]

loglevel = ] { none | error | warn | info  }
Specifies which events should be logged.

  • none specifies that no events related to IGMP should be logged.

  • error specifies that only errors related to IGMP should be logged.

  • warn specifies that both errors and warnings related to IGMP should be logged.

  • info specifies that all events related to IGMP should be logged.

Removes an IGMP router or proxy from the specified interface.

delete interface

name = ] InterfaceName

name = ] InterfaceName
Required. Specifies, by name, an interface from which you want to remove an IGMP router or proxy. 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").

To remove an IGMP proxy or router from an interface named Local Area connection, type:

delete interface "Local Area Connection"

Removes the IGMP router/proxy component from all interfaces.

uninstall

Changes interface configuration parameters.

set interface

name = ] InterfaceName

[ [ igmpprototype = ] { igmprtrv1 | igmprtrv2 | igmprtrv3 | igmpproxy } ]

[ [ ifenabled = ] { enable | disable } ]

[ [ robustvar = ] Integer ]

[ [ genqueryinterval = ] Integer ]

[ [ genqueryresptime = ] Integer ]

[ [ startupquerycount = ] Integer ]

[ [ startupqueryinterval = ] Integer ]

[ [ lastmemquerycount = ] Integer ]

[ [ lastmemqueryinterval = ] Integer ]

[ [ accnonrtralertpkts = ] { yes | no } ]

name = ] InterfaceName
Required. Specifies the name of the interface on which you want to configure IGMP. 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").

igmpprototype = ] { igmprtrv1 | igmprtrv2 | igmprtrv3 | igmpproxy }
Specifies the type of protocol to be configured on the interface. The default type is igmprtrv2.

ifenabled = ] { enable | disable }
Specifies whether the protocol you are configuring should be enabled or disabled. The default is enabled.

robustvar = ] Integer
Specifies the robustness variable. The value should be greater than zero (0). The default value is 2.

genqueryinterval = ] Integer
Specifies the interval, in seconds, at which general queries should be sent on the interface. The default value is 125 seconds.

genqueryresptime = ] Integer
Specifies the maximum response time, in seconds, by which hosts should respond to a general query. The default value is 10 seconds.

startupquerycount = ] Integer
Specifies the number of general queries that will be sent during startup. The default value is 2.

startupqueryinterval = ] Integer
Specifies the interval, in seconds, between general queries sent during startup. The default value is 31 seconds.

lastmemquerycount = ] Integer
Specifies the number of group-specific queries sent when notice of a host leaving the group is received. The default value is 2.

lastmemqueryinterval = ] Integer
Specifies the interval, in milliseconds, between group-specific queries. The default value is 1,000 milliseconds.

accnonrtralertpkts = ] { yes | no }
Specifies whether to accept IGMP packets that do not have the router alert option set. The default is to accept those packets.

To modify the default startup query interval to 21 seconds for use with IGMP configuration of an interface named Local Area Connection, type:

set interface "Local Area Connection" startupqueryinterval=21

Sets IGMP global parameters. Used without parameters, set global specifies that warnings are logged but that no other events related to IGMP are logged.

set global

loglevel = ] { none | error | warn | info }

loglevel = ] { none | error | warn | info }
Required. Specifies which events should be logged.

  • none specifies that no events related to IGMP should be logged.

  • error specifies that only errors related to IGMP should be logged.

  • warn specifies that only warnings related to IGMP should be logged.

  • info specifies that all events related to IGMP should be logged.

To specify that no events related to IGMP should be logged, type:

set global loglevel=none

Displays the IGMP configuration of the specified interface. Used without parameters, show interface displays IGMP configuration information for all interfaces.

show interface

name = ] InterfaceName

name = ] InterfaceName
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").

Displays the global IGMP parameters.

show global

Displays IGMP statistics for the specified interface. Used without parameters, show ifstats shows IGMP statistics once for all interfaces.

show ifstats

[ [ index = ] Integer ]

[ [ rr = ] Integer ]

index = ] Integer
Specifies a number identifying the interface for which you want to display information. To determine the interface index number, use the netsh interface ip show interfaces command.

rr = ] Integer
Specifies, in seconds, how often you want the information to be refreshed.

To show IGMP statistics every 5 seconds for an interface with an index value of 1001, type:

show ifstats index=1001 rr=5

Shows IGMP host groups for a specified interface. Used without parameters, show iftable shows IGMP host groups for all interfaces once.

show iftable

[ [ index = ] Integer ]

[ [ rr = ] Integer ]

index = ] Integer
Specifies, by index number, the interface for which you want to display information. To determine the interface index number, use the netsh interface ip show interfaces command.

rr = ] Integer
Specifies, in seconds, how often you want the information to be refreshed.

To show IGMP host groups every 5 seconds for an interface with an index value of 1001, type:

show iftable index=1001 rr=5

Shows the IGMP hosts group table for a multicast group. Used without parameters, show grouptable shows the IGMP hosts group tables once for all multicast groups on all interfaces associated with the router.

show grouptable

[ [ index = ] Integer ]

[ [ rr = ] Integer ]

index = ] IPv4Address
Specifies the IPv4 address of the multicast group for which you want to display information.

rr = ] Integer
Specifies, in seconds, how often you want the information to be refreshed.

To display the IGMP hosts group table every 5 seconds for an IGMP multicast group identified by the IP address of 192.168.100.239, type:

show grouptable index=192.168.100.239 rr=5

Displays the hosts group table for a remote access client interface. Used without parameters, show rasgrouptable displays the hosts group tables once for all remote access client interfaces.

show rasgrouptable

[ [ index = ] IPv4Address ]

[ [ rr = ] Integer ]

index = ] IPv4Address
Specifies the IPv4 address of the remote access client interface for which you want to display information.

rr = ] Integer
Specifies, in seconds, how often you want the information to be refreshed.

To display the hosts group table for a remote access client interface with an IP address of 10.10.1.100 and to refresh the information every five seconds, type:

show rasgrouptable index=10.10.1.100 rr=5

Displays the IGMP hosts group table for an IGMP proxy interface. Used without parameters, show proxygrouptable displays information for all interfaces one time.

show proxygrouptable

[ [ name = ] InterfaceName ]

[ [ rr = ] Integer ]

name = ] InterfaceName
Specifies, by name, the interface for which you want to display information.

rr = ] Integer
Specifies, in seconds, how often you want the information to be refreshed.

To display IGMP hosts group tables for all IGMP proxy interfaces and to refresh the information every five seconds, type:

show proxygrouptable rr=5

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.