Utiliser des scripts PowerShell pour une recherche SharePoint restreinte

Importante

La recherche SharePoint restreinte prend sa retraite. À compter du 31 juillet 2026, la nouvelle activation est bloquée. Utilisez des contrôles de données complets tels que la découverte de contenu restreinte (RCD) pour la découverte de contenu.

La fonctionnalité Recherche SharePoint restreinte est conçue pour les clients disposant d’expériences Microsoft Copilot Chat et agentiques. Il est conçu comme une solution à court terme pour laisser aux administrateurs de votre organisation le temps d’examiner et d’auditer minutieusement les autorisations de site et de fichier, mais il n’est pas destiné ou évolutif pour une utilisation à long terme. Des solutions complètes de sécurité des données sont disponibles, notamment Gestion avancée de SharePoint et Microsoft Purview.

Comment activer et gérer la recherche SharePoint restreinte à l’aide de scripts PowerShell

Par défaut, la recherche SharePoint restreinte n’est pas activée. Pour activer et configurer la recherche SharePoint restreinte, vous devez disposer au moins des autorisations d’un administrateur SharePoint dans Microsoft 365. Selon le scénario, voici quelques actions à effectuer :

Cet article explique comment utiliser les scripts d’administration dans PowerShell pour ces actions.

Avant de commencer

Vous devez être un administrateur SharePoint ou disposer d’autorisations équivalentes dans Microsoft 365 pour exécuter les scripts d’administration PowerShell.

Voir Conditions préalables pour la gestion avancée de SharePoint.

Avant d’utiliser les scripts PowerShell décrits dans cet article, consultez les exigences du module PowerShell SharePoint Online.

La recherche SharePoint restreinte est désactivée par défaut. Pour vérifier le mode actuel de cette fonctionnalité, vous pouvez exécuter la commande suivante :

Get-SPOTenantRestrictedSearchMode

Module : Microsoft.Online.SharePoint.PowerShell

S’applique à : SharePoint Online

Syntaxe

Get-SPOTenantRestrictedSearchMode

Exemple

Get-SPOTenantRestrictedSearchMode

Cet exemple permet à l’administrateur d’obtenir la liste autorisée existante dans le client. Le résultat peut être « Activé » ou « Désactivé » en fonction du paramètre actuel.

Activez ou désactivez le paramètre de recherche restreinte. La valeur par défaut est disabled. La première fois que vous activez le paramètre, la liste verte est vide. Pour activer ou désactiver la recherche SharePoint restreinte, exécutez la commande suivante :

Set-SPOTenantRestrictedSearchMode

Module : Microsoft.Online.SharePoint.PowerShell

S’applique à : SharePoint Online

Syntaxe

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

Exemple 1

Set-SPOTenantRestrictedSearchMode -Mode Enabled

Remarque

Une fois activés, tous les nouveaux sites sont exclus, sauf si vous les ajoutez à la liste verte.

L’exemple 1 définit ou active le mode de recherche de client restreint pour le client.

Exemple 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled

L’exemple 2 désactive le mode de recherche de client restreint pour le client.

Paramètres

-Mode

Définit le mode de la recherche restreinte de clients.

Type String
Poste : 0
Valeur par défaut : Disabled
Obligatoire : True
Accepter l’entrée de pipeline : False
Accepter les caractères génériques : False

Ajouter des sites à la liste verte

Lorsque vous activez la recherche SharePoint restreinte, ajoutez les URL de site à la liste verte dans une chaîne ou un fichier CSV à l’aide de cette commande :

Add-SPOTenantRestrictedSearchAllowedList

Module :Microsoft.Online.SharePoint.PowerShell

S’applique à : SharePoint Online

Syntaxe

Add-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]

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

Exemple 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)")

Cet exemple montre à l’administrateur comment ajouter les sites à la liste verte.

Exemple 2

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

Remarque

Pour générer une liste de toutes les URL de vos sites SharePoint, accédez à votre Centre d’administration SharePoint Online, accédez à Sites actifs, puis sélectionnez Exporter. La liste exportée inclut également les sites classiques. Supprimez de cette liste tous les sites que vous ne souhaitez pas indexer. Vous pouvez inclure jusqu’à 100 URL.

Cet exemple montre à l’administrateur comment ajouter les sites à la liste verte en fournissant un fichier CSV. Ajoutez la liste des URL de site dans la colonne URL.

Paramètres

-SitesList

Liste des sites pour la liste verte.

Type String
Poste : 0
Valeur par défaut : None
Obligatoire : True
Accepter l’entrée de pipeline : False
Accepter les caractères génériques : False

-SitesListFileURL

Fichier contenant la liste des URL de sites que vous pouvez ajouter à une liste verte lorsque le client est configuré en mode de recherche de client restreint.

Type String
Poste : 0
Valeur par défaut : None
Obligatoire : True
Accepter l’entrée de pipeline : False
Accepter les caractères génériques : False

Supprimer des sites de la liste verte

Supprimez des sites de la liste verte en fournissant l’URL du site dans une chaîne ou un fichier CSV à l’aide de la commande PowerShell suivante :

Remove-SPOTenantRestrictedSearchAllowedList

Module :Microsoft.Online.SharePoint.PowerShell

S’applique à : SharePoint Online

Syntaxe

Remove-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]

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

Exemple 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)")

L’exemple 1 montre comment l’administrateur supprime les sites de la liste verte.

Exemple 2

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

L’exemple 2 montre comment l’administrateur ajoute les sites à la liste verte en fournissant un fichier CSV.

Paramètres

-SitesList

Liste des sites que vous souhaitez supprimer de la liste verte.

Type String
Poste : 0
Valeur par défaut : None
Obligatoire : True
Accepter l’entrée de pipeline : False
Accepter les caractères génériques : False

-SitesListFileURL

Fichier contenant la liste des sites que vous pouvez supprimer d’une liste verte lorsque le client est configuré en mode de recherche de client restreint.

Type String
Poste : 0
Valeur par défaut : None
Obligatoire : True
Accepter l’entrée de pipeline : False
Accepter les caractères génériques : False

Obtenir la liste existante d’URL dans la liste verte

Pour obtenir la liste existante d’URL dans la liste verte, exécutez la commande PowerShell suivante :

Get-SPOTenantRestrictedSearchAllowedList

Module :Microsoft.Online.SharePoint.PowerShell

S’applique à : SharePoint Online

Syntaxe

Get-SPOTenantRestrictedSearchAllowedList

Exemple

Get-SPOTenantRestrictedSearchAllowedList

Cet exemple montre comment l’administrateur obtient la liste verte existante dans le client.

  • Last updated on