Share via


New-SPEnterpriseSearchQueryComponent

 

Se aplica a: SharePoint Server 2010

Última modificación del tema: 2015-03-09

Agrega un componente de consulta a una topología de consulta.

Syntax

New-SPEnterpriseSearchQueryComponent -IndexPartition <IndexPartitionPipeBind> -QueryTopology <QueryTopologyPipeBind> -SearchServiceInstance <SearchServiceInstancePipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-FailoverOnly <SwitchParameter>] [-IndexLocation <String>] [-SearchApplication <SearchServiceApplicationPipeBind>] [-ShareName <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

El cmdlet New-SPEnterpriseSearchQueryComponent se usa cuando se configura inicialmente la funcionalidad de búsqueda y cuando se agrega un nuevo componente de consulta a una aplicación de búsqueda compartida. Una topología de consulta tiene una o varias particiones de índice y uno o varios componentes de consulta. Los componentes de consulta realizan una búsqueda de término de texto generada por la consulta del usuario en particiones de índice.

Para obtener permisos y la información más actualizada acerca de los cmdlets de búsqueda, vea la documentación en línea (https://go.microsoft.com/fwlink/?linkid=163185&clcid=0xC0A).

Parameters

Parámetro Obligatorio Tipo Descripción

IndexPartition

Obligatorio

Microsoft.Office.Server.Search.Cmdlet.IndexPartitionPipeBind

Especifica la partición de índice que se debe usar para el componente de consulta.

El tipo debe ser un GUID válido, con la forma 12345678-90ab-cdef-1234-567890bcdefgh o una instancia de un objeto IndexPartition válido.

QueryTopology

Obligatorio

Microsoft.Office.Server.Search.Cmdlet.QueryTopologyPipeBind

Especifica la topología de consulta que contiene la colección de componentes de consulta.

El tipo debe ser un GUID válido, con la forma 12345678-90ab-cdef-1234-567890bcdefgh, o una instancia de un objeto QueryTopology válido.

SearchServiceInstance

Obligatorio

Microsoft.Office.Server.Search.Cmdlet.SearchServiceInstancePipeBind

Especifica la instancia de servicio de búsqueda que debe hospedar el nuevo componente de consulta.

El tipo debe ser un GUID válido, con la forma 12345678-90ab-cdef-1234-567890bcdefgh; un nombre de servidor de consultas válido, con la forma MyQueryServer; o una instancia de un objeto SearchServiceInstance válido.

AssignmentCollection

Opcional

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Nota

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Pide al usuario que confirme antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

FailoverOnly

Opcional

System.Management.Automation.SwitchParameter

Especifica si el componente de consulta se debe usar para conmutación por error.

IndexLocation

Opcional

System.String

Especifica la ruta de acceso al directorio de índices donde se crean los archivos de índice de texto.

El tipo debe ser una ruta válida con alguna de las siguientes formas:

- C:\nombre_carpeta

- \\nombre_servidor\nombre_carpeta

SearchApplication

Opcional

Microsoft.Office.Server.Search.Cmdlet.SearchServiceApplicationPipeBind

Especifica la aplicación de búsqueda que contiene la topología de consulta.

El tipo debe ser un GUID válido, con la forma 12345678-90ab-cdef-1234-567890bcdefgh; un nombre de aplicación de búsqueda válido (por ejemplo, AplicaciónBúsqueda1); o una instancia de un objeto SearchServiceApplication válido.

ShareName

Opcional

System.String

Especifica el nombre del recurso compartido de archivos en la ruta de acceso especificada en IndexLocation. La cadena solo debe contener caracteres válidos en una ruta de acceso UNC.

El tipo debe ser un nombre de recurso compartido de archivos válido; por ejemplo, FileShare1.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Tipos de entrada

Tipos de valores devueltos

Example

------------------EJEMPLO------------------

$ssa = GetSPEnterpriseSearchServiceApplication
$qtOld = $ssa | Get-SPEnterpriseSearchQueryTopology -Active
$ssInstance = Get-SPEnterpriseSearchServiceInstance -Local
$qtNew = $ssa | New-SPEnterpriseSearchQueryTopology -Partitions 1 
$idxPartition = (Get-SPEnterpriseSearchIndexPartition -QueryTopology $qtOld)
$queryComponent = New-SPEnterpriseSearchQuerycomponent -QueryTopology $qtNew -IndexPartition $idxPartition -SearchServiceInstance $ssInstance
$qtNew | Set-SPEnterpriseSearchQueryTopology -Active
$qtOld | Remove-SPEnterpriseSearchQueryTopology

Este ejemplo crea una topología de consulta con una sola partición y crea un componente de consulta para dicha topología. Después, establece la topología de consulta recién creada como topología de consulta activa de una aplicación de búsqueda de nombre MySSA y elimina la topología anterior.