Set-SearchManager

Changes global settings for Windows Search.

Syntax

Set-SearchManager
   [-UserAgent <String>]
   [-ProxyAccess <_PROXY_ACCESS>]
   [-ProxyName <String>]
   [-ProxyPortNumber <UInt32>]
   [-ProxyBypassLocal]
   [-ProxyBypassList <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-SearchManager cmdlet changes the global settings of Windows Search across all search catalogs.

Note

You must run this cmdlet from an elevated PowerShell session. Start PowerShell by using the Run as administrator option.

Examples

Example 1: Configure a custom proxy server

Set-SearchManager -ProxyAccess PROXY_ACCESS_PROXY -ProxyName proxy.foo.org -ProxyPortNumber 8080

This command tells Windows Search to use proxy.foo.org:8080 as the proxy server.

Example 2: Configure local addresses to bypass the proxy.

Set-SearchManager -ProxyBypassLocal -ProxyBypassList localhost, 127.0.0.1, *.foo.org

This command tells Windows Search to bypass the proxy for local addresses and provides a list of those local addresses.

Example 3: Use Windows settings

Set-SearchManager -ProxyAccess PROXY_ACCESS_PRECONFIG

This command tells Windows Search to use the settings as configured in Windows Network & Internet Settings.

Parameters

-ProxyAccess

Specifies if and how a proxy server is used. The acceptable values for this parameter are:

PROXY_ACCESS_PRECONFIG - Use the Windows Network & Internet Settings.
PROXY_ACCESS_DIRECT - Don't use a proxy.
PROXY_ACCESS_PROXY - Use a proxy as specified by the other Proxy... parameters.

Type	_PROXY_ACCESS
Accepted values	PROXY_ACCESS_PRECONFIG, PROXY_ACCESS_DIRECT, PROXY_ACCESS_PROXY
Position	Named
Default value	None
Accept pipeline input	False
Accept wildcard characters	False

-ProxyBypassList

Specifies, as a string array, the local addresses for which the proxy server should not be used. Use this parameter in conjunction with the ProxyBypassLocal parameter.

Type	string[]
Position	Named
Default value	None
Accept pipeline input	False
Accept wildcard characters	False

-ProxyBypassLocal

Use this parameter to bypass the proxy server for local addresses. Use the ProxyBypassList parameter to specifiy a list of local addresses.

Type	SwitchParameter
Position	Named
Default value	None
Accept pipeline input	False
Accept wildcard characters	False

-ProxyName

Specifies the name of the proxy server.

Type	string
Position	Named
Default value	None
Accept pipeline input	False
Accept wildcard characters	False

-ProxyPortNumber

Specifies the port number of the proxy server.

Type	uint
Position	Named
Default value	None
Accept pipeline input	False
Accept wildcard characters	False

-UserAgent

Specifies the user agent string.

Type	string
Position	Named
Default value	None
Accept pipeline input	False
Accept wildcard characters	False

Inputs

None

You can't pipe objects to this cmdlet.

Outputs