Set-SPEnterpriseSearchService

 

Applies to: SharePoint Server 2010

Topic Last Modified: 2010-02-11

Sets the properties of a search service for a farm.

Syntax

Set-SPEnterpriseSearchService [[-Identity] <SearchServicePipeBind>] [-AcknowledgementTimeout <String>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-ConnectionTimeout <String>] [-ContactEmail <String>] [-IgnoreSSLWarnings <String>] [-InternetIdentity <String>] [-PerformanceLevel <String>] [-ProxyType <String>] [-ServiceAccount <String>] [-ServicePassword <SecureString>] [-WhatIf [<SwitchParameter>]]

Detailed Description

The Set-SPEnterpriseSearchService cmdlet updates properties of a search service for a farm.

Parameters

Parameter Required Type Description

Identity

Optional

Microsoft.Office.Server.Search.Cmdlet.SearchServicePipeBind

Specifies the search service to update.

The type must be a valid GUID, in the form 12345678-90ab-cdef-1234-567890bcdefgh; a valid search application name (for example, SearchService1); or an instance of a valid SearchService object.

AcknowledgementTimeout

Optional

System.String

Specifies the amount of time in seconds that the search server will wait for request acknowledgment while connecting to other services.

The type must be string input that can be parsed to an integer value.

AssignmentCollection

Optional

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

Note

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters

ConnectionTimeout

Optional

System.String

Specifies the amount of time in seconds that the search server waits while connecting to other services.

The type must be string input that can be parsed to an integer value.

ContactEmail

Optional

System.String

Specifies an e-mail address to which external site administrators can write if problems occur when the site is being crawled.

The type must be a valid e-mail address, in the form MyAddress@mycompany.com.

IgnoreSSLWarnings

Optional

System.String

Specifies that the search service will ignore Secure Sockets Layer (SSL) certificate name warnings. The default value is False.

The type must be a string that can be cast to a Boolean value; for example, True or False.

InternetIdentity

Optional

System.String

Specifies the value that the crawler sends in the headers of its HTTP requests to sites when it fetches their pages.

PerformanceLevel

Optional

System.String

Specifies the relative number of threads for the indexer performance:

Reduced: Total number of threads = number of processors, Max Threads/host = number of processors

Partly Reduced: Total number of threads = 4 times the number of processors , Max Threads/host = 16 time the number of processors

Maximum: Total number of threads = number of processors

The type must be one of the following values: Reduced, PartlyReduced, or Maximum.

ProxyType

Optional

System.String

Specifies whether the search service uses a proxy server or connects directly when crawling content. The default value is Direct, (No proxy server is used).

The type must be one of the following values: Direct or Proxy.

ServiceAccount

Optional

System.String

Specifies the user account or service account to use for running the Microsoft Office Server Search service. When this parameter is used, the ServicePassword parameter must also be specified.

The type must be a valid account name on the domain, in the form Domain\username or username.

ServicePassword

Optional

System.String

Specifies the password for the service account specified in ServiceAccount.

The type must contain the domain password to the account specified in the ServiceAccount parameter.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

Input Types

Return Types

Example

------------------EXAMPLE------------------

$password = Read-Host -AsSecureString

******** Set-SPEnterpriseSearchService -IgnoreSSLWarnings $true -ServiceAccount contoso\adminAccount -ServicePassword $password

This example configures the search service to ignore SSL warnings, and changes the service account for the search service.