New-SPEnterpriseSearchQueryTopology

 

Si applica a: SharePoint Server 2010

Ultima modifica dell'argomento: 2015-03-09

Aggiunge una topologia di query a un'applicazione del servizio di ricerca condivisa.

Syntax

New-SPEnterpriseSearchQueryTopology -SearchApplication <SearchServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Clone <SwitchParameter>] [-Clone <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-QueryTopology <QueryTopologyPipeBind>] [-WhatIf [<SwitchParameter>]]

New-SPEnterpriseSearchQueryTopology -SearchApplication <SearchServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Clone <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-Partitions <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Il cmdlet New-SPEnterpriseSearchQueryTopology viene utilizzato quando viene configurata inizialmente la funzionalità di ricerca o quando viene creata una nuova topologia di query. Un'applicazione del servizio di ricerca può contenere più topologie di query quando un componente di query o una partizione dell'indice vengono aggiunti o eliminati da una topologia.

Parameters

Parametro Obbligatorio Tipo Descrizione

SearchApplication

Obbligatorio

Microsoft.Office.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.

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.

Nota

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.

Clone

Facoltativo

System.Management.Automation.SwitchParameter

Specifica che la nuova topologia di query viene creata mediante la clonazione di una topologia di query esistente.

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

Partitions

Facoltativo

System.String

Specifica il numero di partizioni di query da utilizzare per la nuova topologia di query.

Il tipo deve essere una stringa valida che indica un numero minore o uguale a 256.

QueryTopology

Facoltativo

Microsoft.Office.Server.Search.Cmdlet.QueryTopologyPipeBind

Specifica la topologia di query da clonare per la nuova topologia di query.

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

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

Tipi di input

Tipi restituiti

Example

------------------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

In questo esempio viene creata una topologia di query con una singola partizione e viene creato un componente per la topologia. La nuova topologia di query viene impostata come la topologia di query attiva per l'applicazione del servizio di ricerca MySSA e infine la vecchia topologia viene eliminata.