Export (0) Print
Expand All

Netsh Commands for Interface (IPv4 and IPv6)

Updated: February 8, 2008

Applies To: Windows Server 2008

You can use commands in the Netsh Interface context and subcontexts to configure the TCP/IP version 4 protocol (including addresses, default gateways, Domain Name System (DNS) and WINS servers) and to display configuration and statistical information for IPv4.

In addition, you can use commands in this context and related subcontexts (6to4, isatap, portproxy, and teredo) to configure Internet Protocol version 6 (IPv6).

The netsh interface context contains the following commands:

To run these commands from the command prompt, you must either enter the netsh interface context or prepend the context to the command. For example, if you are at the command prompt but have not typed netsh and then interface to enter the netsh interface context, you must type:

netsh interface command

Where command is the command that you want to run, including all of the required parameters for the command.

The Netsh Interface context also includes several subcontexts.

This context provides the following subcontexts:

 

Subcontext name Result

6to4

Changes to the netsh interface 6to4 context.

HTTPSTunnel

netsh interface HTTPSTunnel

ipv4

Changes to the netsh interface ipv4 context.

ipv6

Changes to the netsh interface ipv6 context.

isatap

Changes to the netsh interface isatap context.

portproxy

Changes to the netsh interface portproxy context.

tcp

Changes to the netsh interface tcp context.

teredo

Changes to the netsh interface teredo context.

For information on how to interpret netsh command syntax, see Formatting Legend.

Following are the details for the commands in the Netsh Interface context.

Adds an interface to the router. For full interfaces, a phone book entry with the same name must already exist on the system.

Syntax

add [name=] Name [[type=]full]

Parameters

name
Required. Specifies the name of the interface to be added.

type
Optional. Specifies that a demand dial interface is created when full is designated.

Examples

Following is an example of the add interface command that creates a demand dial interface.

add name="Demand-Dial Interface" type=full

Deletes an interface from the router.

Syntax

delete [ name= ] Name

Parameters

name
Required. Specifies the name of the interface to be deleted.

Examples:

The following example command deletes a demand dial interface at the router

delete name="Demand-Dial Interface"

Deletes all of the interfaces that can be added through this context.

Syntax

reset

Specifies the credentials that are used to connect to or add an interface.

Syntax

set credentials [ name= ] InterfaceName [ user= ]UserName [[ domain= ] Domain [password=] Password ]

Parameters

InterfaceName
Required. Specifies the name of the interface that you want to add.

UserName
Required. Specifies the user account name that has the required permissions to add an interface.

Domain
Optional. Specifies the domain where the user account is located.

Password
Optional. Specifies the password of the user account.

Examples

Following are two examples of the set credentials command.

set credentials name="Demand-Dial Interface" user=guest

set credentials name="Demand-Dial Interface" user=admin domain=mydomain password=mypassword

Changes the parameters for an existing interface.

Syntax

set interface [name = ] IfName [ [admin = ] ENABLED|DISABLED [connect = ] CONNECTED|DISCONNECTED [newname = ] NewName ]

Parameters

IfName
Required. Specifies the name of the interface that you want to modify.

admin
Optional. Specifies whether the interface should be enabled or disabled.

connect
Optional. Specifies whether or not to enable and connect the interface (non-LAN only).

newname
Optional. Specifies a new name for the interface (LAN only).

Remarks

  • At least one option other than the name must be specified.

  • If you specify that the value for connect equals CONNECTED, then the interface is automatically enabled even if you also specify that the value for admin equals DISABLED.

Displays the credentials that are used to connect to an interface.

Syntax

show credentials [name = ] IfName

Parameters

IfName
Required. Specifies the name of the interface whose credentials you want to display.

Displays a list of the configured interfaces, including their current Name, Admin State, State, and Type.

Syntax

show interface [[name=] Name]

Parameters

Name
Optional. Specifies the name of the interface that you want to display. If Name is not specified, all interfaces are displayed.

Examples

Following is an example of the show interface command.

show interface name="Local Area Connection"

See Also

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft