New-SPEnterpriseSearchQueryComponent

SharePoint 2010
 

Si applica a: SharePoint Server 2010

Ultima modifica dell'argomento: 2015-03-09

Aggiunge un componente di query a una topologia di query.

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

Il cmdlet New-SPEnterpriseSearchQueryComponent è utilizzato quando la funzionalità di ricerca è configurata inizialmente e si aggiunge un nuovo componente di query a un'applicazione di ricerca condivisa. Una topologia di query ha una o più partizioni indice e uno o più componenti di query. I componenti di query eseguono la ricerca termini full-text generate da query utente in partizioni indice.

Per indicazioni sulle autorizzazioni e per informazioni aggiornate sui cmdlet relativi alla ricerca, vedere la documentazione online (http://go.microsoft.com/fwlink/?linkid=163185&clcid=0x410).

 

Parametro Obbligatorio Tipo Descrizione

IndexPartition

Obbligatorio

Microsoft.Office.Server.Search.Cmdlet.IndexPartitionPipeBind

Specifica la partizione indice da utilizzare per il componente di query.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh oppure un'istanza di un oggetto IndexPartition valido.

QueryTopology

Obbligatorio

Microsoft.Office.Server.Search.Cmdlet.QueryTopologyPipeBind

Specifica la topologia di query che contiene l'insieme di componenti di query.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh oppure un'istanza di un oggetto QueryTopology valido.

SearchServiceInstance

Obbligatorio

Microsoft.Office.Server.Search.Cmdlet.SearchServiceInstancePipeBind

Specifica l'istanza del servizio di ricerca che ospita il nuovo componente di query.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un server di query, ad esempio ServerQueryA, oppure un'istanza di un oggetto SearchServiceInstance valido.

AssignmentCollection

Facoltativo

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

NotaNote
Quando viene utilizzato il parametro Global tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Visualizza una richiesta di conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

FailoverOnly

Facoltativo

System.Management.Automation.SwitchParameter

Specifica se il componente di query viene utilizzato per il failover.

IndexLocation

Facoltativo

System.String

Specifica il percorso per la directory dell'indice in cui sono creati file indice full-text.

Il tipo deve essere un percorso valido in uno dei formati seguenti:

- C:\ nome_cartella

- \\nome_server\nome_cartella

SearchApplication

Facoltativo

Microsoft.Offic1e.Server.Search.Cmdlet.SearchServiceApplicationPipeBind

Specifica l'applicazione di ricerca che contiene la topologia di query.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome di applicazione di ricerca valido (ad esempio AppRicerca1) oppure un'istanza di un oggetto SearchServiceApplication valido.

ShareName

Facoltativo

System.String

Specifica il nome per la condivisione di file relativa al percorso specificato in IndexLocation. La stringa deve contenere solo caratteri validi in un percorso UNC.

Il tipo deve essere un nome valido di una condivisione di file, ad esempio CondivisioneFile1.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

------------------ESEMPIO------------------

$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

Questo esempio crea una topologia di query con una partizione singola e crea un componente di query per tale topologia. In seguito la nuova topologia di query è impostata come topologia di query attiva di un'applicazione di ricerca denominata MySSA e viene eliminata la vecchia topologia.

Mostra: