Compartir a través de


Uso de scripts de PowerShell para la búsqueda restringida de SharePoint

Importante

Restricted SharePoint Search está diseñado para los clientes de Microsoft 365 Copilot. Visite aquí y la información general de Restricted SharePoint Search para obtener más información.

Cómo habilitar y administrar la búsqueda restringida de SharePoint mediante scripts de PowerShell

De forma predeterminada, la búsqueda restringida de SharePoint no está habilitada. Para habilitar y configurar la búsqueda restringida de SharePoint, debe tener al menos los permisos de un administrador de SharePoint en Microsoft 365. En función del escenario, algunas de las acciones que debe realizar son:

En este artículo se explica cómo usar scripts de administrador en PowerShell para estas acciones.

Antes de empezar

Debe ser administrador de SharePoint o tener permisos equivalentes en Microsoft 365 para ejecutar los scripts de administrador de PowerShell.

Antes de usar los scripts de PowerShell de este artículo, debe realizar los pasos siguientes:

  1. Si no lo ha hecho, descargue la Shell de administración de SharePoint Online más reciente.

    Nota:

    Si instaló una versión anterior del Shell de administración de SharePoint Online, vaya a Agregar o quitar programas y desinstale "Shell de administración de SharePoint Online".

  2. Conéctese a SharePoint como administrador de SharePoint o con permisos equivalentes en Microsoft 365 en Microsoft 365. Para saber cómo hacerlo, consulte Introducción al Shell de administración de SharePoint Online.

La búsqueda restringida de SharePoint está deshabilitada de forma predeterminada. Para comprobar el modo actual de esta característica, puede ejecutar el siguiente script:

Get-SPOTenantRestrictedSearchMode

Módulo: Microsoft.Online.SharePoint.PowerShell

Se aplica a: SharePoint Online

Sintaxis

Get-SPOTenantRestrictedSearchMode

Ejemplo

Get-SPOTenantRestrictedSearchMode

Este ejemplo permite al administrador obtener la lista de permitidos existente en el inquilino. El resultado puede ser "Habilitado" o "Deshabilitado" en función de la configuración actual.

Habilite o deshabilite la configuración de búsqueda restringida con el valor predeterminado deshabilitado. La primera vez que se habilita la configuración, la lista de permitidos está vacía. Para habilitar o deshabilitar la búsqueda de SharePoint restringida, puede ejecutar:

Set-SPOTenantRestrictedSearchMode

Módulo: Microsoft.Online.SharePoint.PowerShell

Se aplica a: SharePoint Online

Sintaxis

Set-SPOTenantRestrictedSearchMode 
[-Mode] {Disabled | Enabled}
 [<CommonParameters>]

Ejemplo 1

Set-SPOTenantRestrictedSearchMode -Mode Enabled  

Nota:

Una vez habilitados, los sitios nuevos creados se excluyen a menos que se agreguen a la lista permitida.

En el ejemplo 1 se establece o habilita el modo de búsqueda de inquilino restringido para el inquilino.

Ejemplo 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled  

El ejemplo 2 deshabilita el modo de búsqueda de inquilinos restringidos para el inquilino.

Parámetros

-Modo

Establece el modo para la búsqueda de inquilinos restringidos.

Tipo Cadena
Posición: 0
Valor predeterminado: Deshabilitada
Necesario: Verdadero
Aceptar entrada de canalización: Falso
Acepte caracteres comodín: Falso

Adición de sitios a la lista de permitidos

Cuando la búsqueda restringida de SharePoint está habilitada, puede agregar direcciones URL de sitio a la lista permitida en un archivo csv o de cadena:

Add-SPOTenantRestrictedSearchAllowedList

Module:Microsoft.Online.SharePoint.PowerShell

Se aplica a: SharePoint Online

Sintaxis

Add-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]
Add-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]  
 [<CommonParameters>]

Ejemplo 1

Add-SPOTenantRestrictedSearchAllowedList -SitesList @("[https://contoso.sharepoint.com/sites/Marketing](https://contoso.sharepoint.com/sites/Marketing)", "[https://contoso.sharepoint.com/sites/Benefits](https://contoso.sharepoint.com/sites/Benefits)")

Este ejemplo permite al administrador agregar los sitios a la lista permitida.

Ejemplo 2

Add-SPOTenantRestrictedSearchAllowedList  -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv

Nota:

Para generar una lista de todas las direcciones URL de sitio de SharePoint, vaya al Centro de administración de SharePoint Online, vaya a Sitios activos y seleccione Exportar. La lista exportada también incluye sitios clásicos. Quite los sitios de esta lista que no quiera indexar. Puede incluir hasta 100 direcciones URL.

Este ejemplo permite al administrador agregar los sitios a la lista permitida proporcionando un archivo CSV. Agregue la lista de direcciones URL de sitio en la columna URL.

Parámetros

-SitesList

Lista de sitios para la lista de permitidos.

Tipo Cadena
Posición: 0
Valor predeterminado: Ninguno
Necesario: Verdadero
Aceptar entrada de canalización: Falso
Acepte caracteres comodín: Falso

-SitesListFileURL

Archivo que tiene una lista de direcciones URL de sitios que se pueden agregar a una lista permitida cuando el inquilino está establecido en Modo de búsqueda de inquilino restringido.

Tipo Cadena
Posición: 0
Valor predeterminado: Ninguno
Necesario: Verdadero
Aceptar entrada de canalización: Falso
Acepte caracteres comodín: Falso

Eliminación de sitios de la lista de permitidos

Puede quitar sitios de la lista permitida proporcionando la dirección URL del sitio en un archivo de cadena o csv mediante el script de PowerShell:

Remove-SPOTenantRestrictedSearchAllowedList

Module:Microsoft.Online.SharePoint.PowerShell

Se aplica a: SharePoint Online

Sintaxis

Remove-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]
Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]
 [<CommonParameters>]

Ejemplo 1

Remove-SPOTenantRestrictedSearchAllowedList -SitesList @("[https://contoso.sharepoint.com/sites/Marketing](https://contoso.sharepoint.com/sites/Marketing)", "[https://contoso.sharepoint.com/sites/HR](https://contoso.sharepoint.com/sites/HR)")

El ejemplo 1 permite al administrador quitar los sitios de la lista permitida.

Ejemplo 2

Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv

El ejemplo 2 permite al administrador agregar los sitios a la lista permitida proporcionando un archivo CSV.

Parámetros

-SitesList

Lista de sitios que se quitará de la lista permitida.

Tipo Cadena
Posición: 0
Valor predeterminado: Ninguno
Necesario: Verdadero
Aceptar entrada de canalización: Falso
Acepte caracteres comodín: Falso

-SitesListFileURL

Archivo que tiene una lista de sitios que se pueden quitar de una lista permitida cuando el inquilino está establecido en Modo de búsqueda de inquilino restringido.

Tipo Cadena
Posición: 0
Valor predeterminado: Ninguno
Necesario: Verdadero
Aceptar entrada de canalización: Falso
Acepte caracteres comodín: Falso

Obtener la lista existente de direcciones URL en la lista de permitidos

Para obtener la lista existente de direcciones URL en la lista permitida, ejecute el siguiente script de PowerShell:

Get-SPOTenantRestrictedSearchAllowedList

Module:Microsoft.Online.SharePoint.PowerShell

Se aplica a: SharePoint Online

Sintaxis

Get-SPOTenantRestrictedSearchAllowedList

Ejemplo

Get-SPOTenantRestrictedSearchAllowedList

Este ejemplo permite al administrador obtener la lista de permitidos existente en el inquilino.