Skip to main content
New-ProxySettings

Define proxy settings to use when connecting to SharePoint with PowerShell

Updated over a week ago

Command

New-ProxySettings

Description

The command to create the proxy settings for a SharePoint connection.

For more info, see Use a proxy.

Examples

Connect to SharePoint with proxy settings

$proxySettings = New-ProxySettings -Server myproxyserver -Port 888 
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -ProxySettings $proxySettings

Syntax

New-ProxySettings-Server <String>
[-Port <Int32>]
New-ProxySettings-Server <String>
-WindowsCredentials <SwitchParameter>
[-Port <Int32>]
New-ProxySettings-Server <String>
-UserName <String>
-Password <SecureString>
[-Port <Int32>]
New-ProxySettings-Server <String>
-Credential <PSCredential>
[-Port <Int32>]

Parameters

-Credential <PSCredential>

Specifies the credentials.

Required?

True

Default value

None

Accept pipeline input?

True (ByValue, ByPropertyName)

Accept wildcard characters?

False

Parameter set name

Credential

Aliases

None

-Password <SecureString>

Specifies the password.

Required?

True

Default value

None

Accept pipeline input?

False

Accept wildcard characters?

False

Parameter set name

Manual

Aliases

None

-Port <Int32>

Specifies the port of the proxy server.

Required?

False

Default value

80

Accept pipeline input?

False

Accept wildcard characters?

False

Parameter set name

(All)

Aliases

None

-Server <String>

Specifies the IP address or server name of the proxy server.

Required?

True

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

False

Parameter set name

(All)

Aliases

None

-UserName <String>

Specifies the username.

Required?

True

Default value

None

Accept pipeline input?

False

Accept wildcard characters?

False

Parameter set name

Manual

Aliases

None

-WindowsCredentials <SwitchParameter>

Specifies the credentials associated with the current Windows session, otherwise, Sharegate will use the credentials specified when you connected to SharePoint.

Required?

True

Default value

None

Accept pipeline input?

False

Accept wildcard characters?

False

Parameter set name

Windows

Aliases

None

Did this answer your question?