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.