Set-SPEnterpriseSearchResultSource

Establece las propiedades de un origen de resultados.

Syntax

Set-SPEnterpriseSearchResultSource
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationType <FederationAuthType>]
   [-AutoDiscover <Boolean>]
   [-Confirm]
   [-Description <String>]
   -Identity <ResultSourcePipeBind>
   [-MakeDefault <Boolean>]
   [-Name <String>]
   [-Owner <SearchObjectOwner>]
   [-Password <String>]
   [-ProviderId <Guid>]
   [-QueryTemplate <String>]
   [-RemoteUrl <String>]
   [-SearchApplication <SearchServiceApplicationPipeBind>]
   [-SsoId <String>]
   [-UserName <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

Este cmdlet actualiza las propiedades de un origen de resultados creado por el usuario. Este cmdlet admite las mismas operaciones de actualización que se admiten a través de la página "Administrar orígenes de resultados" de Administración central. El origen de resultados solo puede ser un origen integrado (un origen integrado tiene la propiedad BuiltIn establecida como True) para la operación de actualización consistente en cambiar el origen de resultados predeterminado con el parámetro MakeDefault. Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

--------------------EJEMPLO 1---------------------

$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -Identity $customResultSource -Name "Basic SharePoint Result Source"

En este ejemplo se actualiza el nombre del origen de resultados y la identidad del origen de resultados se especifica como una instancia de origen de resultados. SearchApplication y Owner no son necesarios para esta operación de actualización.

--------------------EJEMPLO 2---------------------

$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -Identity "Custom SharePoint Result Source" -Description "A custom SharePoint Result Source for demonstration purposes"

En este ejemplo se actualiza la descripción del origen de resultados y se especifica la identidad del origen de resultados por nombre.

Parámetros

-AssignmentCollection

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.

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.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AuthenticationType

Especifica un tipo de autenticación para el origen de resultados. Si el parámetro no se especifica, el valor no cambia.

Se admite un conjunto específico de tipos de autenticación para cada tipo de proveedor de búsqueda y, si no se especifica el parámetro , el tipo de autenticación se establecerá de forma predeterminada en función del tipo de proveedor de búsqueda.

Este cmdlet admite el conjunto de mecanismos de autenticación y los tipos correspondientes siguientes: autenticación predeterminada de SharePoint (FederationAuthType.LocalNTAuth), autenticación básica (FederationAuthType.SingleAccountBasicAuth, hay que especificar NombreDeUsuario y Contraseña), autenticación predeterminada y remota de SharePoint (FederationAuthType.PerUserBasicAuth), inicio de sesión único (FederationAuthType.SSO, requiere especificar SsoId), anónima (FederationAuthType.Anonymous), autenticación implícita (FederationAuthType.SingleAccountDigest, hay que especificar NombreDeUsuario y Contraseña), identidad del grupo de aplicaciones NTLM (FederationAuthType.ApplicationPoolIdentity), nombre de usuario y contraseña NTLM (FederationAuthType.SingleAccountNTLM, hay que especificar NombreDeUsuario y Contraseña).

Al usar un proveedor de búsqueda local de SharePoint/búsqueda local de personas de SharePoint, se admiten FederationAuthType.LocalNTAuth (predeterminado) y FederationAuthType.SingleAccountBasicAuth.

Al usar un proveedor de búsqueda remota de SharePoint/búsqueda remota de personas de SharePoint, se admiten FederationAuthType.PerUserBasicAuth (predeterminado) y FederationAuthType.SSO.

Al usar el proveedor de búsqueda OpenSearch 1.0/1.1, se admiten los siguientes tipos de autenticación: FederationAuthType.Anonymous (predeterminado), FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest, FederationAuthType.SingleAccountNTLM y FederationAuthType.ApplicationPoolIdentity.

Todos los tipos de autenticación aparecen en la enumeración FederationAuthType.

Type:FederationAuthType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AutoDiscover

Especifica si se debe usar la detección automática del punto de conexión del servidor de Exchange para el origen de resultados.

Al establecer el valor en True ($true), se indica que la detección automática debe usarse.

Si el parámetro no se especifica, el valor no cambia.

Solo es aplicable al usar un proveedor de búsqueda de Exchange.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Description

Especifica una descripción para el origen de resultados.

Si el parámetro no se especifica, el valor no cambia.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

Especifica el origen de resultados que se va a actualizar.

El tipo debe ser una cadena GUID válida con el formato 12345678-90ab-cdef-1234-567890bcdefgh, un nombre válido de un origen de resultados (por ejemplo, "Custom SharePoint Result Source") o una instancia de un objeto Source válido.

Type:ResultSourcePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-MakeDefault

Especifica si el origen de resultados debe establecerse como origen de resultados predeterminado o no, para el ámbito especificado por el parámetro Owner.

Si no se especifica el parámetro , el origen de resultados predeterminado no cambiará.

Al establecer el valor en True ($true), se indica que el origen de resultados debe establecerse como predeterminado.

Al establecer el valor en false ($false) se indica que el origen de resultados no debe establecerse como predeterminado y, en este caso, si el origen de resultados que se va a actualizar es actualmente el predeterminado, el origen de resultados predeterminado original ("Resultados locales de SharePoint") se establecerá de nuevo como predeterminado.

Sugerencia: Use la instancia, no el nombre ni el identificador de cadena GUID, como Identidad al usar Makedefault, para especificar claramente que el propietario solo se usará para especificar el nivel en el que el origen de resultados debe establecerse como predeterminado (si el valor es true) o donde el valor predeterminado se debe restablecer al original (si el valor es false).

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Name

Especifica un nombre para el origen de resultados.

Si el parámetro no se especifica, el valor no cambia.

Los nombres tienen que ser únicos en todos los niveles administrativos.

Por ejemplo, dos orígenes de resultados de un sitio no pueden tener el mismo nombre, pero uno de un sitio y otro proporcionado por la colección de sitios sí pueden.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Owner

Especifica el propietario del objeto de búsqueda que define el ámbito en el que el origen de resultados correspondiente está disponible.

Type:SearchObjectOwner
Aliases:o
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Password

Especifica la contraseña de las credenciales de usuario que se deben usar para conectar con el origen de resultados.

Si el parámetro no se especifica, el valor no cambia.

Se usa cuando el tipo de autenticación (AuthenticationType) está establecido en un tipo que consume credenciales de usuario (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest o FederationAuthType.SingleAccountNTLM).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ProviderId

Especifica el proveedor de búsqueda que debe usar el origen de resultados.

Si el parámetro no se especifica, el valor no cambia.

Se expresa como Guid o cadena GUID, que debe ser una de las siguientes: FA947043-6046-4F97-9714-40D4C113963D (búsqueda local de SharePoint), E4BCC058-F133-4425-8FFC-1D70596FFD33 (búsqueda local de personas de SharePoint), 1E0C8601-2E5D-4CCB-9561-53743B5DBDE7 (búsqueda remota de SharePoint), E377CAAA-FCAF-4a1b-B7A1-E69A506A07AA (búsqueda remota de personas de SharePoint), 3A17E140-1574-4093-BAD6-E19CDF1C0122 (búsqueda de Exchange), 3A17E140-1574-4093-BAD6-E19CDF1C0121 (OpenSearch 1.0/1.1).

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-QueryTemplate

Especifica la plantilla de transformación de consulta del origen de resultados.

Si el parámetro no se especifica, el valor no cambia.

Las consultas entrantes cambian según la plantilla para usar este nuevo texto de consulta. Incluya la consulta entrante en el texto nuevo usando la variable de consulta "{searchTerms}". Use esto para analizar los resultados.

Por ejemplo, para devolver solo elementos de OneNote, establezca el nuevo texto en "{searchTerms} fileextension=one". Luego, una consulta entrante "sharepoint" se convierte en "sharepoint fileextension=one". El valor predeterminado es {searchTerms}.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-RemoteUrl

Especifica una plantilla de la dirección URL de conexión para el origen de resultados.

Si el parámetro no se especifica, el valor no cambia.

Debe establecerse al usar un proveedor de búsqueda que lo consuma: búsqueda remota de SharePoint, búsqueda remota de personas de SharePoint, OpenSearch 1.0/1.1 y Exchange (si Detección automática no está activado).

Al usar otros proveedores de búsqueda, el parámetro se ignora.

En la búsqueda remota de SharePoint/búsqueda remota de personas de SharePoint, especifique la dirección de la colección de sitios raíz de la granja de servidores remota de SharePoint.

En OpenSearch 1.0/1.1, especifique la dirección URL del origen de OpenSearch.

Incluya la consulta en la dirección URL usando la variable de consulta "{searchTerms}", que se reemplazará automáticamente con la consulta. En Exchange, especifique la dirección URL de EWS de Exchange desde la que quiere recuperar los resultados.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SearchApplication

Especifica la aplicación de búsqueda.

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

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SsoId

Especifica el id. de almacenamiento seguro del certificado de proxy inverso que se debe usar para conectar con el origen de resultados.

Si el parámetro no se especifica, el valor no cambia.

Se debe especificar si el tipo de autenticación (AUthenticationType) está establecido en FederationAuthType.SSO (inicio de sesión único).

Si va a conectarse con su intranet a través de un proxy inverso, escriba el id. de SSO de la entrada de inicio de sesión único que almacena el certificado usado para autenticar en el proxy inverso.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-UserName

Especifica el nombre de usuario de las credenciales de usuario que se deben usar para conectar al origen de resultados.

Si el parámetro no se especifica, el valor no cambia.

Se usa cuando el tipo de autenticación (AuthenticationType) está establecido en un tipo que consume credenciales de usuario (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest o FederationAuthType.SingleAccountNTLM).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition