Article
03/04/2017

New-SPEnterpriseSearchQueryComponent

S’applique à : SharePoint Server 2010

Dernière rubrique modifiée : 2015-03-09

Ajoute un composant de requête à une topologie de requête.

Syntax

New-SPEnterpriseSearchQueryComponent -IndexPartition <IndexPartitionPipeBind> -QueryTopology <QueryTopologyPipeBind> -SearchServiceInstance <SearchServiceInstancePipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-FailoverOnly <SwitchParameter>] [-IndexLocation <String>] [-SearchApplication <SearchServiceApplicationPipeBind>] [-ShareName <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

L’applet de commande New-SPEnterpriseSearchQueryComponent est utilisée lors de la configuration initiale de la fonctionnalité de recherche et lorsqu’un nouveau composant de requête est ajouté à une application de recherche partagée. Une topologie de requête comporte une ou plusieurs partitions d’index et un ou plusieurs composants de requête. Les composants de requête effectuent la recherche en texte intégral générée par requête utilisateur dans les partitions d’index.

Pour connaître les autorisations et les informations les plus récentes sur les applets de commande de recherche, voir la documentation en ligne (https://go.microsoft.com/fwlink/?linkid=163185&clcid=0x40C).

Parameters

Paramètre	Requis	Type	Description
IndexPartition	Requis	Microsoft.Office.Server.Search.Cmdlet.IndexPartitionPipeBind	Spécifie la partition d’index à utiliser pour le composant de requête. Le type doit correspondre à un GUID valide sous la forme 12345678-90ab-cdef-1234-567890bcdefgh ou à une instance d’un objet IndexPartition valide.
QueryTopology	Requis	Microsoft.Office.Server.Search.Cmdlet.QueryTopologyPipeBind	Spécifie la topologie de requête qui contient la collection de composants de requête. Le type doit correspondre à un GUID valide sous la forme 12345678-90ab-cdef-1234-567890bcdefgh ou à une instance d’un objet QueryTopology valide.
SearchServiceInstance	Requis	Microsoft.Office.Server.Search.Cmdlet.SearchServiceInstancePipeBind	Spécifie l’instance du service de recherche utilisée pour héberger le nouveau composant de requête. Le type doit correspondre à un GUID valide sous la forme 12345678-90ab-cdef-1234-567890bcdefgh, à un nom valide de serveur de requêtes sous la forme MyQueryServer ou à une instance d’un objet SearchServiceInstance valide.
AssignmentCollection	Facultatif	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	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. Notes 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.
Confirm	Facultatif	System.Management.Automation.SwitchParameter	Vous demande confirmation avant d’exécuter la commande. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters
FailoverOnly	Facultatif	System.Management.Automation.SwitchParameter	Spécifie si le composant de requête est utilisé à des fins de basculement.
IndexLocation	Facultatif	System.String	Spécifie le chemin d’accès au répertoire d’index dans lequel les fichiers d’index en texte intégral sont créés. Le type doit correspondre à un chemin d’accès valide sous l’une des formes suivantes : - C:\ nom_dossier - \\nom_serveur\nom_dossier
SearchApplication	Facultatif	Microsoft.Office.Server.Search.Cmdlet.SearchServiceApplicationPipeBind	Spécifie l’application de recherche qui contient la topologie de requête. Le type doit correspondre à un GUID valide sous la forme 12345678-90ab-cdef-1234-567890bcdefgh, à un nom d’application de recherche valide (par exemple, SearchApp1) ou à une instance d’un objet SearchServiceApplication valide.
ShareName	Facultatif	System.String	Spécifie le nom du partage de fichiers situé à l’emplacement spécifié dans IndexLocation. La chaîne doit uniquement contenir des caractères valides dans un chemin d’accès UNC. Le type doit correspondre à un nom valide de partage de fichiers (par exemple, FileShare1).
WhatIf	Facultatif	System.Management.Automation.SwitchParameter	Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

Types d’entrée

Types retournés

Example

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

$ssa = GetSPEnterpriseSearchServiceApplication
$qtOld = $ssa | Get-SPEnterpriseSearchQueryTopology -Active
$ssInstance = Get-SPEnterpriseSearchServiceInstance -Local
$qtNew = $ssa | New-SPEnterpriseSearchQueryTopology -Partitions 1 
$idxPartition = (Get-SPEnterpriseSearchIndexPartition -QueryTopology $qtOld)
$queryComponent = New-SPEnterpriseSearchQuerycomponent -QueryTopology $qtNew -IndexPartition $idxPartition -SearchServiceInstance $ssInstance
$qtNew | Set-SPEnterpriseSearchQueryTopology -Active
$qtOld | Remove-SPEnterpriseSearchQueryTopology

Cet exemple crée une topologie de requête avec une seule partition et crée un composant de requête pour cette topologie. Il définit ensuite la topologie de requête tout juste créée en tant que topologie de requête active d’une application de recherche nommée MySSA, puis supprime l’ancienne topologie.

Partager via