Utiliser des scripts PowerShell pour la recherche SharePoint restreinte
Importante
La recherche SharePoint restreinte est conçue pour les clients de Microsoft 365 Copilot. Visitez ici et la vue d’ensemble de La recherche SharePoint restreinte pour plus d’informations.
Par défaut, la recherche SharePoint restreinte n’est pas activée. Pour activer et configurer la recherche SharePoint restreinte, vous devez disposer d’un rôle Administrateur SharePoint ou supérieur dans Microsoft 365. Selon le scénario, certaines actions que vous devez effectuer sont les suivantes :
Obtenir le mode actuel défini pour la recherche restreinte
Activer et désactiver la recherche SharePoint restreinte
Ajouter des sites à la liste autorisée en fournissant une URL
Supprimer des sites de la liste autorisée en fournissant une URL
Obtenir la liste existante des URL ajoutées à la liste verte
Cet article explique comment utiliser des scripts d’administration dans PowerShell pour ces actions.
Avant de commencer
Vous devez être administrateur SharePoint ou version ultérieure dans Microsoft 365 pour exécuter les scripts d’administration suivants. Avant d’utiliser les scripts PowerShell de cet article, vous devez effectuer les opérations suivantes :
Si ce n’est pas le cas, téléchargez la dernière version de 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 ».
Connectez-vous à SharePoint en tant qu’administrateur SharePoint ou version ultérieure dans Microsoft 365 dans Microsoft 365. Pour savoir comment procéder, reportez-vous à l’article Prise en main de SharePoint Online Management Shell.
Obtenir le mode actuel défini pour la recherche restreinte
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.
Activer ou désactiver le paramètre Recherche restreinte
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
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: | Désactivé |
| Obligatoire : | Vrai |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
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
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: | Aucune |
| Obligatoire : | Vrai |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-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: | Aucune |
| Obligatoire : | Vrai |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
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: | Aucune |
| Obligatoire : | Vrai |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-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: | Aucune |
| Obligatoire : | Vrai |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
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
```
**Example**
```powershell
Get-SPOTenantRestrictedSearchAllowedList
Cet exemple permet à l’administrateur d’obtenir la liste autorisée existante dans le locataire.