Uso de scripts de PowerShell para la búsqueda restringida de SharePoint
Importante
Restricted SharePoint Search está diseñado para clientes de Microsoft 365 Copilot. Visite aquí y la información general de Restricted SharePoint Search para obtener más información.
De forma predeterminada, la búsqueda restringida de SharePoint no está habilitada. Para habilitar y configurar la búsqueda restringida de SharePoint, debe tener un rol de administrador de SharePoint o superior en Microsoft 365. En función del escenario, algunas de las acciones que debe realizar son:
Obtener el modo actual establecido para la búsqueda restringida
Habilitar y deshabilitar la búsqueda restringida de SharePoint
Agregar sitios a la lista de permitidos proporcionando la dirección URL
Para quitar sitios de la lista permitida, proporcione la dirección URL
Obtener la lista existente de direcciones URL que se agregan en la lista de permitidos
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 superior en Microsoft 365 para ejecutar los siguientes scripts de administrador. Antes de usar los scripts de PowerShell de este artículo, debe hacer lo siguiente:
Si no lo ha hecho, descargue el 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".
Conéctese a SharePoint como administrador de SharePoint o superior en Microsoft 365 en Microsoft 365. Para saber cómo hacerlo, consulte Introducción al Shell de administración de SharePoint Online.
Obtener el modo actual establecido para la búsqueda restringida
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.
Habilitar o deshabilitar la configuración de búsqueda restringida
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
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
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
```
**Example**
```powershell
Get-SPOTenantRestrictedSearchAllowedList
Este ejemplo permite al administrador obtener la lista de permitidos existente en el inquilino.