Windows Server 2003 in a Nutshell
| netsh/Interface Context |
Configures router interfaces for Routing and Remote Access Service.
Subcontexts
- IP
Commands
- add interface name =iname type=[tunnel full]
-
Adds an interface to the router, specifying its name ( iname ) and type ( tunnel for VPN interfaces and full for demand-dial interfaces). The name of the interface must be in quotes if it contains spaces.
- delete interface name=iname
-
Removes the specified interface.
- dump
-
Dumps the configuration of the interfaces for the Routing and Remote Access Service as a series of NetShell commands.
- ip
-
Switches to the IP subcontext to further configure IP interfaces on the router. The commands available in this subcontext are listed in Table 5-11.
- reset all
-
Resets the router configuration by deleting all interfaces.
- set credentials name=iname user =username domain=domainname password=password
-
Specifies the credentials needed to connect to an interface.
- set interface name=iname admin=[enabled disabled] connect=[connected disconnected] [newname=newiname]
-
Sets the current state of the WAN interface called iname to either enabled or disabled . If connected is specified, the interface is automatically enabled. newiname is used only for renaming the default LAN interface.
- show credentials name=iname
-
Displays the credentials needed to connect to each interface.
- show interface [name=iname]
-
Displays the name, type, and current state of each interface on the router. If no name is specified, all interfaces are displayed.
Table 5-11. Commands available in Interface IP subcontext
| Command | Option | Description |
|---|---|---|
| add | address | Adds IP address |
| dns | Adds static DNS server address | |
| wins | Adds static WINS server address | |
| delete | address | Deletes IP address or default gateway |
| arpcache | Flushes ARP cache | |
| dns | Removes DNS settings | |
| wins | Removes WINS settings | |
| dump | Dumps configuration as netsh commands | |
| set | address | Specifies IP address or default gateway |
| dns | Specifies DNS server mode and addresses | |
| wins | Specifies WINS server mode and addresses | |
| show | address | Lists all addresses |
| config | Lists IP addresses and configuration settings | |
| dns | Lists addresses of DNS servers | |
| icmp | Displays ICMP statistics | |
| interface | Displays interface statistics | |
| ipaddress | Lists IP addresses | |
| ipnet | Lists net-to-media mappings | |
| ipstats | Displays statistics for IP addresses | |
| joins | Lists joined multicast groups | |
| offload | Lists offload information | |
| tcpconn | Lists TCP connections | |
| tcpstats | Displays TCP statistics | |
| udpconn | Lists UDP connections | |
| udpstats | Displays UDP statistics | |
| wins | Lists addresses of WINS servers |
Examples
Display interfaces on router:
C:\> netsh netsh> interface interface> show interface Admin State State Type Interface Name ------------------------------------------------------ Enabled Connected Loopback Loopback Enabled Connected Internal Internal Enabled Connected Dedicated Local Area Connection
Switch to IP subcontext and view details of interfaces:
interface> ip interface ip> show interface MIB-II Interface Information ------------------------------------------------------ Index: 1 User-friendly Name: Loopback GUID Name: Loopback Type: Loopback MTU: 32768 Speed: 10000000 Physical Address: Admin Status: Up Operational Status: Operational Last Change: 0 In Octets: 0 In Unicast Packets: 0 In Non-unicast Packets: 0 In Packets Discarded: 0 In Erroneous Packets: 0 In Unknown Protocol Packets: 0 Out Octets: 0 Out Unicast Packets: 0 Out Non-unicast Packets: 0 Out Packets Discarded: 0 Out Erroneous Packets: 0 Output Queue Length: 0 Description: Internal loopback interface for 127.0.0 network Index: 2 User-friendly Name: Local Area Connection GUID Name: {54414D01-02DA-4783-B931-C9AC7A70EDDD} Type: Ethernet MTU: 1500 Speed: 10000000 Physical Address: 00-00-B4-A0-47-74 Admin Status: Up Operational Status: Operational Last Change: 0 In Octets: 4722820 In Unicast Packets: 16263 In Non-unicast Packets: 6698 In Packets Discarded: 0 In Erroneous Packets: 0 In Unknown Protocol Packets: 8151 Out Octets: 2970151 Out Unicast Packets: 21769 Out Non-unicast Packets: 3745 Out Packets Discarded: 0 Out Erroneous Packets: 0 Output Queue Length: 0 Description: Realtek RTL8029(AS) Ethernet Adapt (Microsoft's Packet Scheduler)
Display IP address info for "Local Area Connection" interface:
interface ip> show address "Local Area Connection" Configuration for interface "Local Area Connection" DHCP enabled: No IP Address: 172.16.11.104 SubnetMask: 255.255.255.0 Default Gateway: 172.16.11.196 GatewayMetric: 1 InterfaceMetric: 1
Before adding a second IP address for this interface, first check the syntax for the add address command:
interface ip> add address ? Usage: add address [name=] string [[addr=]IP address [mask=]IP subnet mask][[gateway=]IP address [gwmetric=]integer] Parameters: name - The name of the IP interface. addr - The IP address to be added for the interface. mask - The IP subnet mask for the specified IP address. gateway - The default gateway for the specified IP address. gwmetric - The metric to the default gateway. Remarks: Adds IP addresses and default gateways to an interface configured with static IP addresses. Examples: add address "Local Area Connection" 10.0.0.2 255.0.0.0 add address "Local Area Connection" gateway=10.0.0.3 gwmetric=2 The first command adds a static IP address of 10.0.0.2 with a subnet mask of 255.0.0.0 to the Local Area Connection interface. The second command adds the IP address of 10.0.0.3 as a second default gateway for this interface with a gateway metric of 2.
Add a second IP address 172.16.11.105 for this interface:
interface ip> add address "Local Area Connection" 172.16.11.105 255.255.255.0 Ok.
Verify the result:
interface ip> show address "Local Area Connection" Configuration for interface "Local Area Connection" DHCP enabled: No IP Address: 172.16.11.104 SubnetMask: 255.255.255.0 IP Address: 172.16.11.105 SubnetMask: 255.255.255.0 Default Gateway: 172.16.11.196 GatewayMetric: 1 InterfaceMetric: 1 interface ip>
You can also verify that the address was successfully added by accessing the TCP/IP properties sheet for this interface in the GUI:
Right-click on My Network Places
See Also
Connections, Routing and Remote Access