Utiliser des scripts PowerShell pour la recherche SharePoint restreinte

Importante

La recherche SharePoint restreinte est en cours de mise hors service. À 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 restreint (RCD) pour la détectabilité du contenu.

La recherche SharePoint restreinte est conçue pour les clients de Microsoft 365 Copilot expériences de conversation et d’agent. Il est conçu comme une solution à court terme pour permettre aux administrateurs de votre organization de passer en revue 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 une recherche SharePoint restreinte à l’aide de scripts PowerShell

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

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

Avant de commencer

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

Voir Prérequis pour la gestion avancée de SharePoint.

Avant d’utiliser les scripts PowerShell de cet article, consultez Configuration requise pour les modules 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 locataire. Le résultat peut être « Activé » ou « Désactivé » en fonction du paramètre actuel.

Activez ou désactivez le paramètre 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é, 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 locataire restreint pour le locataire.

Exemple 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled

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

Paramètres

-Mode

Définit le mode de recherche de locataire restreint.

Type String
Position: 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 recherche SharePoint restreinte, ajoutez des URL de site à la liste verte dans une chaîne ou un fichier CSV à l’aide de la commande suivante :

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 vos URL de site SharePoint, accédez à votre centre d’administration SharePoint online, accédez à Sites actifs, puis sélectionnez Exporter. La liste des exportations inclut également les sites classiques. Supprimez tous les sites de cette liste 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 de sites pour la liste verte.

Type String
Position: 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 qui contient la liste des URL de site que vous pouvez ajouter à une liste verte lorsque le locataire est défini sur Mode de recherche de locataire restreint.

Type String
Position: 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 les 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 de sites que vous souhaitez supprimer de la liste verte.

Type String
Position: 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 locataire est défini sur Mode de recherche de locataire restreint.

Type String
Position: 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 des URL existantes dans la liste verte

Pour obtenir la liste des URL existantes 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 locataire.

  • Last updated on