Import-SPEnterpriseSearchPopularQueries

  • Référence
Module:
SharePointServer
S’applique à:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Importe des requêtes à partir d'une liste séparée par des virgules. La zone de recherche suggère ces requêtes lorsque les utilisateurs tapent du texte.

Syntax

Import-SPEnterpriseSearchPopularQueries
      -ResultSource <Source>
      -SearchApplicationProxy <SearchServiceApplicationProxyPipeBind>
      -Web <SPWeb>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-Filename <String>]
      [-WhatIf]
      [<CommonParameters>]

Description

L’applet de commande Import-SPEnterpriseSearchPopularQueries importe des requêtes à partir d’une liste séparée par des virgules. Lorsque l’utilisateur tape une requête dans la zone de recherche, cette dernière suggère les requêtes de cette liste séparée par des virgules. La zone de recherche base ces suggestions sur :

  • SpWeb sur lequel se trouve la zone de recherche.
  • Source du résultat configurée dans la zone de recherche.

Par exemple, si la zone de recherche se trouve sur le SPWeb « Ingénierie », les requêtes suggérées diffèrent de celles qui se trouvent sur le SPWeb « Gestion ». De même, si la source du résultat dans la zone de recherche est « Résultats SharePoint locaux », les requêtes suggérées seront différentes de celles qui seront proposées si la source de résultat est « Conversations ».

La liste séparée par des virgules doit comprendre une ligne par requête et chaque ligne doit contenir les éléments suivants :

Texte de requête. Expression de requête réelle.

Nombre de requêtes. Nombre d’exécutions de cette requête.

Cliquez sur Nombre. Nombre de fois où un utilisateur a cliqué sur un résultat pour cette requête.

LCID. Identificateur de paramètres régionaux (LCID) pour la langue de la requête.

Chaque ligne doit respecter le format suivant : Texte de requête,Nombre de requêtes,Nombre de clics,LCID. Par exemple, Company store,100,80,1033. Pour que des suggestions apparaissent dans la zone de recherche, la valeur Nombre de clics doit être supérieure à cinq. La zone de recherche ordonne les suggestions de requête par leurs valeurs Nombre de clics (approximativement).

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

--------EXEMPLE--------

$ssap = Get-SPEnterpriseSearchServiceApplicationProxy
$hostname = hostname
$web = get-spsite | get-spweb | where {$_.Url-eq "https://$hostname"}
$owner = new-object Microsoft.Office.Server.Search.Administration.SearchObjectOwner -ArgumentList @([Microsoft.Office.Server.Search.Administration.SearchObjectLevel]::SPWeb,$web)
$mgr = new-object Microsoft.Office.Server.Search.Administration.Query.FederationManager -ArgumentList $ssap
$source = $mgr.GetSourceByName("Local SharePoint Results", $owner)
Import-SPEnterpriseSearchPopularQueries -SearchApplicationProxy $ssap -Filename C:\input.txt -ResultSource $source -Web $web

Cet exemple utilise l’applet de commande Import-SPEnterpriseSearchPopularQueries pour importer le fichier de requêtes nommé C:\input.txt et lui associer l’origine des résultats référencée par $source et le SPWeb référencé par $web. L’exemple définit la variable $web comme SPWeb avec URL https://hostname, et la variable $source comme source de résultat nommée « Résultats SharePoint locaux » au niveau du SPWeb référencé par $web.

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Filename

Spécifie le chemin d’accès UNC (Universal Naming Convention) complet du fichier à importer.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ResultSource

Spécifie l’origine des résultats à associer aux requêtes importées. Le type doit être une instance d’un objet valide.

Type:Source
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SearchApplicationProxy

Spécifie le proxy de l’application de recherche dans laquelle le fichier de requêtes doit être importé. Le type doit correspondre à un GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh, à un nom de proxy d’application de recherche valide (par exemple, SearchAppProxy1) ou à une instance d’un objet SearchServiceApplicationProxy valide.

Type:SearchServiceApplicationProxyPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Web

Spécifie le SPWeb à associer aux requêtes importées. Le type doit être une instance d’un objet SPWeb valide.

Type:SPWeb
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019