Utiliser des scripts PowerShell pour la recherche SharePoint restreinte

Importante

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 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 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.

Avant d’utiliser les scripts PowerShell de cet article, vous devez effectuer les étapes suivantes :

  1. Si vous ne l’avez pas déjà fait, téléchargez la dernière SharePoint Online Management Shell.

    Remarque

    Si vous avez installé une version antérieure de SharePoint Online Management Shell, accédez à Ajouter ou supprimer des programmes et désinstaller « SharePoint Online Management Shell ».

  2. Connectez-vous à SharePoint en tant qu’administrateur SharePoint ou avec des autorisations équivalentes dans Microsoft 365. Pour savoir comment procéder, reportez-vous à l’article Prise en main de SharePoint Online Management Shell.

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

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 avec la valeur par défaut désactivée. La première fois que le paramètre est activé, la liste verte est vide. Pour activer ou désactiver la recherche SharePoint restreinte, vous pouvez exécuter :

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 créés sont exclus, sauf s’ils sont ajoutés à la liste autorisée.

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 autorisée

Lorsque la recherche SharePoint restreinte est activée, vous pouvez ajouter des URL de site à la liste autorisée dans un fichier chaîne ou csv :

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 permet à l’administrateur d’ajouter les sites à la liste autorisée.

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 permet à l’administrateur d’ajouter les sites à la liste autorisée 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 autorisée.

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 sites qui peuvent être ajoutées à une liste autorisée 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

Vous pouvez supprimer des sites de la liste autorisée en fournissant l’URL du site dans un fichier de chaîne ou csv à l’aide d’un script PowerShell :

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 permet à l’administrateur de supprimer les sites dans la liste autorisée.

Exemple 2

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

L’exemple 2 permet à l’administrateur d’ajouter les sites à la liste autorisée en fournissant un fichier CSV.

Paramètres

-SitesList

Liste de sites qui seront supprimés de la liste autorisée.

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 sites qui peuvent être supprimés d’une liste autorisée 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 existante des URL dans la liste autorisée

Vous pouvez obtenir la liste des URL existantes dans la liste autorisée en exécutant le script PowerShell suivant :

Get-SPOTenantRestrictedSearchAllowedList

Module :Microsoft.Online.SharePoint.PowerShell

S’applique à : SharePoint Online

Syntaxe

Get-SPOTenantRestrictedSearchAllowedList

Exemple

Get-SPOTenantRestrictedSearchAllowedList

Cet exemple permet à l’administrateur d’obtenir la liste autorisée existante dans le locataire.

  • Last updated on