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

Importante

La búsqueda restringida de SharePoint se retirará. A partir del 31 de julio de 2026, se bloquean las nuevas habilitaciones. Use controles de datos completos, como la detección de contenido restringido (RCD), para la detección de contenido.

La búsqueda restringida de SharePoint está diseñada para clientes con experiencias Microsoft Copilot Chat y agente. Está diseñado como una solución a corto plazo para dar tiempo a los administradores de su organización a revisar y auditar minuciosamente los permisos del sitio y los archivos, pero no está diseñado ni es escalable para su uso a largo plazo. Hay disponibles soluciones completas de seguridad de datos, como Administración Avanzada de SharePoint y Microsoft Purview.

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. Según el escenario, algunas acciones que debe realizar son:

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

Antes de empezar

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

Consulte Requisitos previos para la administración avanzada de SharePoint.

Antes de usar los scripts de PowerShell de este artículo, consulte Requisitos del módulo de PowerShell 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 comando:

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" según la configuración actual.

Habilite o deshabilite la configuración de búsqueda restringida. El valor predeterminado es disabled. La primera vez que habilite la configuración, la lista de permitidos estará vacía. Para habilitar o deshabilitar la búsqueda restringida de SharePoint, ejecute este comando:

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 habilitado, se excluyen los nuevos sitios, a menos que los agregue a la lista de permitidos.

El ejemplo 1 establece o habilita el modo de búsqueda de inquilinos restringidos para el inquilino.

Ejemplo 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled

En el ejemplo 2, se deshabilita el modo de búsqueda de inquilinos restringido para el inquilino.

Parámetros

-Mode

Establece el modo de búsqueda de inquilinos restringidos.

Tipo Cadena
Posición: 0
Valor predeterminado: Disabled
Necesario: True
Aceptar entrada de canalización: False
Aceptar caracteres comodín: False

Agregar sitios a la lista de permitidos

Al habilitar la búsqueda restringida de SharePoint, agregue direcciones URL de sitios a la lista de permitidos en una cadena o archivo CSV mediante este comando:

Add-SPOTenantRestrictedSearchAllowedList

Módulo: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)")

En este ejemplo se muestra al administrador cómo agregar los sitios a la lista de permitidos.

Ejemplo 2

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

Nota:

Para generar una lista de todas las direcciones URL del 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 de esta lista los sitios que no quiera indexar. Puedes incluir hasta 100 direcciones URL.

En este ejemplo se muestra al administrador cómo agregar los sitios a la lista de permitidos proporcionando un archivo CSV. Agrega la lista de direcciones URL de sitios en la columna URL.

Parámetros

-SitesList

Lista de sitios para la lista de permitidos.

Tipo Cadena
Posición: 0
Valor predeterminado: None
Necesario: True
Aceptar entrada de canalización: False
Aceptar caracteres comodín: False

-SitesListFileURL

Archivo que tiene una lista de direcciones URL de sitios que puede agregar a una lista de sitios permitidos cuando el inquilino está establecido en el modo de búsqueda de inquilinos restringido.

Tipo Cadena
Posición: 0
Valor predeterminado: None
Necesario: True
Aceptar entrada de canalización: False
Aceptar caracteres comodín: False

Quitar sitios de la lista de permitidos

Para quitar sitios de la lista de permitidos, proporcione la dirección URL del sitio en una cadena de caracteres o en un archivo CSV con el siguiente comando de PowerShell:

Remove-SPOTenantRestrictedSearchAllowedList

Módulo: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)")

En el ejemplo 1 se muestra cómo el administrador quita los sitios de la lista de permitidos.

Ejemplo 2

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

En el ejemplo 2 se muestra cómo el administrador agrega los sitios a la lista de permitidos proporcionando un archivo CSV.

Parámetros

-SitesList

Lista de sitios que desea quitar de la lista de permitidos.

Tipo Cadena
Posición: 0
Valor predeterminado: None
Necesario: True
Aceptar entrada de canalización: False
Aceptar caracteres comodín: False

-SitesListFileURL

Archivo que tiene una lista de sitios que puede quitar de una lista de permitidos cuando el inquilino está establecido en el modo de búsqueda de inquilinos restringido.

Tipo Cadena
Posición: 0
Valor predeterminado: None
Necesario: True
Aceptar entrada de canalización: False
Aceptar caracteres comodín: False

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

Para obtener la lista existente de direcciones URL en la lista de direcciones permitidas, ejecute el siguiente comando de PowerShell:

Get-SPOTenantRestrictedSearchAllowedList

Módulo:Microsoft.Online.SharePoint.PowerShell

Se aplica a: SharePoint Online

Sintaxis

Get-SPOTenantRestrictedSearchAllowedList

Ejemplo

Get-SPOTenantRestrictedSearchAllowedList

En este ejemplo se muestra cómo el administrador obtiene la lista de permitidos existente en el inquilino.

  • Last updated on