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
-
show global
-
show grouptable
-
show ifstats
-
show iftable
-
show interface
-
show proxygrouptable
-
show rasgrouptable
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.
- none specifies that no 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"
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.
- none specifies that no 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
