ProxySettings Class [IIS 7 and higher]

Contains configuration settings for a Web proxy server.

Syntax

class ProxySettings : EmbeddedObject

Methods

This class contains no methods.

Properties

The following table lists the properties exposed by the ProxySettings class.

Name

Description

AutoDetect

A read/write sint32 value that specifies whether the proxy is automatically detected. The possible values are listed later in the Remarks section.

BypassOnLocal

A read/write sint32 value that specifies whether the proxy is bypassed for local resources. The possible values are listed later in the Remarks section.

NoteNote:
Local resources include the local server (for example, http://localhost, http://loopback, or http://127.0.0.1) and a Uniform Resource Identifier (URI) without a period (for example, http://webserver).

ProxyAddress

A read/write string value that contains the URI of the Web proxy server to use.

ScriptLocation

A read/write string value that contains the URI of the automatic proxy detection script.

UseSystemDefault

A read/write sint32 value that specifies whether local system proxy settings are used to determine how local resources are accessed. The possible values are listed later in the Remarks section.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are contained in the Proxy property of the DefaultProxySection class.

The following table lists the possible values for the AutoDetect property. The default is –1 (Unspecified).

Value

Keyword

Description

0

False

The proxy is not automatically detected.

1

True

The proxy is automatically detected.

–1

Unspecified

The AutoDetect setting is not specified.

The following table lists the possible values for the BypassOnLocal property. The default is –1 (Unspecified).

Value

Keyword

Description

0

False

Local resources should be accessed through the proxy.

1

True

Local resources should be accessed directly.

–1

Unspecified

The BypassOnLocal setting is not specified.

The following table lists the possible values for the UseSystemDefault property. The default is –1 (Unspecified).

Value

Keyword

Description

0

False

Do not use system default proxy setting values.

1

True

Use system default proxy setting values.

–1

Unspecified

The UseSystemDefault setting is not specified.

Inheritance Hierarchy

EmbeddedObject

   ProxySettings

Requirements

Type

Description

Client

Requires IIS 7 on Windows Vista.

Server

Requires IIS 7 on Windows Server 2008.

Product

IIS 7

MOF file

WebAdministration.mof

See Also

Reference

DefaultProxySection Class [IIS 7 and higher]

EmbeddedObject Class [IIS 7 and higher]