Netsh Routing IP IGMP Context Commands

  • Article

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:

  • dump

  • install

  • uninstall

Add commands

  • add interface

Delete commands

  • delete interface

Set commands

  • set interface

  • set global

Show commands

  • show global

  • show grouptable

  • show ifstats

  • show iftable

  • show interface

  • show proxygrouptable

  • show rasgrouptable

Netsh commands for routing IP IGMP

The following entries provide details for each command.

dump

Displays the Internet Group Management Protocol (IGMP) 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\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.

add interface

Configures IGMP on the specified interface.

Syntax

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 } ]

Parameters

  • [ 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.

Example

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

install

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.

Syntax

install

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

Parameters

  • **[ 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.

delete interface

Removes an IGMP router or proxy from the specified interface.

Syntax

delete interface

[ name = ] InterfaceName

Parameters

  • [ 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").

Example

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

delete interface "Local Area Connection"

uninstall

Removes the IGMP router/proxy component from all interfaces.

Syntax

uninstall

set interface

Changes interface configuration parameters.

Syntax

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 } ]

Parameters

  • [ 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.

Example

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

set global

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

Syntax

set global

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

Parameters

  • [ 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.

Example

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

set global loglevel=none

show interface

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

Syntax

show interface

[ name = ] InterfaceName

Parameters

  • [ 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").

show global

Displays the global IGMP parameters.

Syntax

show global

show ifstats

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

Syntax

show ifstats

[ [ index = ] Integer ]

[ [ rr = ] Integer ]

Parameters

  • [ 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.

Example

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

show ifstats index=1001 rr=5

show iftable

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

Syntax

show iftable

[ [ index = ] Integer ]

[ [ rr = ] Integer ]

Parameters

  • [ 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.

Example

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

show iftable index=1001 rr=5

show grouptable

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.

Syntax

show grouptable

[ [ index = ] Integer ]

[ [ rr = ] Integer ]

Parameters

  • [ 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.

Example

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

show rasgrouptable

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.

Syntax

show rasgrouptable

[ [ index = ] IPv4Address ]

[ [ rr = ] Integer ]

Parameters

  • [ 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.

Example

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

show proxygrouptable

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

Syntax

show proxygrouptable

[ [ name = ] InterfaceName ]

[ [ rr = ] Integer ]

Parameters

  • [ 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.

Example

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

show proxygrouptable rr=5