## Setproxy Task

### Description

Sets Java's web proxy properties, so that tasks and code run in the same JVM can have through-the-firewall access to remote web sites, and remote ftp sites. You can nominate an http and ftp proxy, or a socks server, reset the server settings, or do nothing at all.

### Examples

    <setproxy/>

do nothing

    <setproxy proxyhost="firewall"/>

set the proxy to firewall:80

    <setproxy proxyhost="firewall" proxyport="81"/>

set the proxy to firewall:81

    <setproxy proxyhost=""/>

stop using the http proxy; don't change the socks settings

    <setproxy socksproxyhost="socksy"/>

use socks via socksy:1080

    <setproxy socksproxyhost=""/>

stop using the socks server.

You can set a username and password for http with the `proxyHost` and `proxyPassword` attributes. On Java 1.4 and above these can also be used against SOCKS5 servers.

### Parameters

Attribute | Description | Type | Requirement
nonproxyhosts | A list of hosts to bypass the proxy on. These should be separated with the vertical bar character '|'. Only in Java 1.4 does ftp use this list. e.g. fozbot.corp.sun.com|*.eng.sun.com | String | Optional
proxyhost | the HTTP/ftp proxy host. Set this to "" for the http proxy option to be disabled | String
proxypassword | Set the password for the proxy. Used only if the proxyUser is set. | String
proxyport | the HTTP/ftp proxy port number; default is 80 | int
proxyuser | set the proxy user. Probably requires a password to accompany this setting. Default="" | String
socksproxyhost | The name of a Socks server. Set to "" to turn socks proxying off. | String
socksproxyport | Set the ProxyPort for socks connections. The default value is 1080 | int