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.