Export (0) Print
Expand All

Netsh commands for Interface Portproxy

Updated: February 8, 2008

Applies To: Windows Server 2008

The Netsh Interface Portproxy commands provide a command-line tool for use in administering servers that act as proxies between IPv4 and IPv6 networks and applications. You can use these commands to establish proxy service in the following ways:

  • IPv4-configured computer and application messages sent to other IPv4-configured computers and applications.

  • IPv4-configured computer and application messages sent to IPv6-configured computers and applications.

  • IPv6-configured computer and application messages sent to IPv4-configured computers and applications.

  • IPv6-configured computer and application messages sent to other IPv6-configured computers and applications.

When writing batch files or scripts using these commands, each command must be preceded by netsh interface portproxy. For example, when using the delete v4tov6 command to specify that the portproxy server delete an IPv4 port and address from the list of IPv4 addresses for which the server listens, the batch file or script must use the following syntax:

netsh interface portproxy delete v4tov6 listenport= {Integer | ServiceName} [[listenaddress=] {IPv4Address| HostName}] [[protocol=]tcp]

You can run these commands at the command prompt in a Windows Server®2008 operating system or at the command prompt for the netsh interface portproxy context. For these commands to work at the command prompt in Windows Server 2008, you must type netsh interface portproxy before typing commands and parameters as they appear in the syntax below.

For more information about Netsh, see Netsh Overviewand Enter a Netsh Context

To view the command syntax, click a command:

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

Specifies that the portproxy server listen for messages sent to a specific port and IPv4 address, and maps a port and IPv4 address to which to send the messages received after establishing a separate TCP connection.

add v4tov4 listenport= {Integer | ServiceName} [[connectaddress=] {IPv4Address | HostName}] [[connectport=] {Integer | ServiceName}] [[listenaddress=] {IPv4Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv4 port, by port number or service name, on which to listen.

connectaddress
Specifies the IPv4 address to which to connect. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

connectport
Specifies the IPv4 port, by port number or service name, to which to connect. If connectport is not specified, the default is the value of listenport on the local computer.

listenaddress
Specifies the IPv4 address for which to listen. Acceptable values are IP address, computer NetBIOS name, or computer Domain Name System (DNS) name. If an address is not specified, the default is the local computer.

protocol
Specifies the protocol to use. Currently, only Transmission Control Protocol (TCP) is supported.

/?
Displays help at the command prompt.

Specifies that the portproxy server listen for messages sent to a specific port and IPv4 address, and maps a port and IPv6 address to which to send the messages received after establishing a separate TCP connection.

add v4tov6 listenport= {Integer | ServiceName} [[connectaddress=] {IPv6Address | HostName}] [[connectport=] {Integer | ServiceName}] [[listenaddress=] {IPv4Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv4 port, by port number or service name, on which to listen.

connectaddress
Specifies the IPv6 address to which to connect. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

connectport
Specifies the IPv6 port, by port number or service name, to which to connect. If connectport is not specified, the default is the value of listenport on the local computer.

listenaddress
Specifies the IPv4 address on which to listen. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

protocol
Specifies the protocol to use. Currently only TCP is supported.

/?
Displays help at the command prompt.

Specifies that the portproxy server listen for messages sent to a specific port and IPv6 address, and maps a port and IPv4 address to which to send the messages received after establishing a separate TCP connection.

add v6tov4 listenport= {Integer | ServiceName} [[connectaddress=] {IPv4Address | HostName}] [[connectport=] {Integer | ServiceName}] [[listenaddress=] {IPv6Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv6 port, by port number or service name, on which to listen.

connectaddress
Specifies the IPv4 address to which to connect. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

connectport
Specifies the IPv4 port, by port number or service name, to which to connect. If connectport is not specified, the default is the value of listenport on the local computer.

listenaddress
Specifies the IPv6 address on which to listen. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

protocol
Specifies the protocol to use. Currently only TCP is supported.

/?
Displays help at the command prompt.

Specifies that the portproxy server listen for messages sent to a specific port and IPv6 address, and maps a port and IPv6 address to which to send the messages received after establishing a separate TCP connection.

add v6tov6 listenport= {Integer | ServiceName} [[connectaddress=] {IPv6Address | HostName}] [[connectport=] {Integer | ServiceName}] [[listenaddress=] {IPv6Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv6 port, by port number or service name, on which to listen.

connectaddress
Specifies the IPv6 address to which to connect. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

connectport
Specifies the IPv6 port, by port number or service name, to which to connect. If connectport is not specified, the default is the value of listenport on the local computer.

listenaddress
Specifies the IPv6 address on which to listen. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

protocol
Specifies the protocol to use. Currently only TCP is supported.

/?
Displays help at the command prompt.

Specifies that the portproxy server delete an IPv4 address from the list of IPv4 ports and addresses for which the server listens.

delete v4tov4 listenport= {Integer | ServiceName} [[listenaddress=] {IPv4Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv4 port to delete.

listenaddress
Specifies the IPv4 address to delete. If an address is not specified, the default is the local computer.

protocol
Specifies the protocol to use. Currently only TCP is supported.

/?
Displays help at the command prompt.

Specifies that the portproxy server delete an IPv4 port and address from the list of IPv4 addresses for which the server listens.

delete v4tov6 listenport= {Integer | ServiceName} [[listenaddress=] {IPv4Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv4 port to delete.

listenaddress
Specifies the IPv4 address to delete. If an address is not specified, the default is the local computer.

protocol
Specifies the protocol to use. Currently only TCP is supported.

/?
Displays help at the command prompt.

Specifies that the portproxy server delete an IPv6 port and address from the list of IPv6 addresses for which the server listens.

delete v6tov4 listenport= {Integer | ServiceName} [[listenaddress=] {IPv6Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv6 port to delete.

listenaddress
Specifies the IPv6 address to delete. If an address is not specified, the default is the local computer.

protocol
Specifies the protocol to use. Currently only TCP is supported.

/?
Displays help at the command prompt.

Specifies that the portproxy server delete an IPv6 address from the list of IPv6 addresses for which the server listens.

delete v6tov6 listenport= {Integer | ServiceName} [[listenaddress=] {IPv6Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv6 port to delete.

listenaddress
Specifies the IPv6 address to delete. If an address is not specified, the default is the local computer.

protocol
Specifies the protocol to use. Currently only TCP is supported.

/?
Displays help at the command prompt.

Resets the IPv6 configuration state.

reset

Modifies the parameter values of an existing entry on the portproxy server created with the add v4tov4 command, or adds a new entry to the list that maps port/address pairs.

set v4tov4 listenport= {Integer | ServiceName} [[connectaddress=] {IPv4Address | HostName}] [[connectport=] {Integer | ServiceName}] [listenaddress=] {IPv4Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv4 port, by port number or service name, on which to listen.

connectaddress
Specifies the IPv4 address to which to connect. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

connectport
Specifies the IPv4 port, by port number or service name, to which to connect. If connectport is not specified, the default is the value of listenport on the local computer.

listenaddress
Specifies the IPv4 address for which to listen. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

protocol
Specifies the protocol to use. Currently, only Transmission Control Protocol (TCP) is supported.

/?
Displays help at the command prompt.

  • You can change any parameter values for an existing portproxy server entry. If values are not supplied, no changes are made.

Modifies the parameter values of an existing entry on the portproxy server created with the add v4tov6 command, or adds a new entry to the list that maps port/address pairs.

set v4tov6 listenport= {Integer | ServiceName} [[connectaddress=] {IPv6Address | HostName}] [[connectport=] {Integer | ServiceName}] [[listenaddress=] {IPv4Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv4 port, by port number or service name, on which to listen.

connectaddress
Specifies the IPv6 address to which to connect. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

connectport
Specifies the IPv6 port, by port number or service name, to which to connect. If connectport is not specified, the default is the value of listenport on the local computer.

listenaddress
Specifies the IPv4 address on which to listen. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

protocol
Specifies the protocol to use. Currently only TCP is supported.

/?
Displays help at the command prompt.

  • You can change any parameter values for an existing portproxy server entry. If values are not supplied, no changes are made.

Modifies the parameter values of an existing entry on the portproxy server created with the add v6tov4 command, or adds a new entry to the list that maps port/address pairs.

set v6tov4 listenport= {Integer | ServiceName} [[connectaddress=] {IPv4Address | HostName}] [[connectport=] {Integer | ServiceName}] [[listenaddress=] {IPv6Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv6 port, by port number or service name, on which to listen.

connectaddress
Specifies the IPv4 address to which to connect. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

connectport
Specifies the IPv4 port, by port number or service name, to which to connect. If connectport is not specified, the default is the value of listenport on the local computer.

listenaddress
Specifies the IPv6 address on which to listen. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

protocol
Specifies the protocol to use. Currently only TCP is supported.

/?
Displays help at the command prompt.

  • You can change any parameter values for an existing portproxy server entry. If values are not supplied, no changes are made.

Modifies the parameter values of an existing entry on the portproxy server created with the add v6tov6 command, or adds a new entry to the list that maps port/address pairs.

set v6tov6 listenport= {Integer | ServiceName} [[connectaddress=] {IPv6Address | HostName}] [[connectport=] {Integer | ServiceName}] [[listenaddress=] {IPv6Address| HostName}] [[protocol=]tcp]

listenport
Required. Specifies the IPv6 port, by port number or service name, on which to listen.

connectaddress
Specifies the IPv6 address to which to connect. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If an address is not specified, the default is the local computer.

connectport
Specifies the IPv6 port, by port number or service name, to which to connect. If connectport is not specified, the default is the value of listenport on the local computer.

listenaddress
Specifies the IPv6 address on which to listen. Acceptable values are IP address, computer NetBIOS name, or computer DNS name. If you do not specify an address, the default is the local computer.

protocol
Specifies the protocol to use. Currently only TCP is supported.

/?
Displays help at the command prompt.

  • You can change any parameter values for an existing portproxy server entry. If values are not supplied, no changes are made.

Displays all portproxy parameters, including port/address pairs for v4tov4, v4tov6, v6tov4, and v6tov6.

show all

Displays v4tov4 portproxy parameters.

show v4tov4

Displays v4tov6 portproxy parameters.

show v4tov6

Displays v6tov4 portproxy parameters.

show v6tov4

Displays v6tov6 portproxy parameters.

show v6tov6

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

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

Community Additions

ADD
Show:
© 2014 Microsoft