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.