Gestire i componenti di ricerca in SharePoint Server
SI APPLICA A:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365
Le procedure e gli esempi in questo articolo presuppongono che SharePoint ServerSharePoint Server e l'applicazione del servizio di ricerca siano installati e che sia presente una topologia di ricerca ed elementi esistenti nell'indice di ricerca di SharePoint Server. Se SharePoint Server e l'applicazione del servizio di ricerca vengono installati di recente e non sono presenti elementi nell'indice di ricerca di SharePoint Server, seguire le procedure illustrate in Modificare la topologia di ricerca predefinita in SharePoint Server.
Le procedure illustrate in questo articolo si applicano ai componenti di ricerca seguenti:
Componente di elaborazione dei dati analitici
Componente di elaborazione del contenuto
Componente di ricerca per indicizzazione
Componente di amministrazione delle ricerche
Componente di elaborazione delle query
Per informazioni sulle procedure per la gestione del componente di indicizzazione, vedere Gestire il componente di indicizzazione in SharePoint Server.
Prima di iniziare
Prima di iniziare, verificare i prerequisiti seguenti.
È necessario che sia stato installato SharePoint Server e che sia stata creata un'applicazione del servizio di ricerca con una topologia di ricerca. L'applicazione del servizio di ricerca deve funzionare correttamente e non deve essere sospesa per alcun motivo.
L'account utente utilizzato per eseguire le procedure illustrate in questo articolo deve essere membro del gruppo Amministratori farm.
Si è pianificata una topologia di ricerca di destinazione.
SharePoint Server deve essere installato in tutti i server in cui si desidera ospitare i componenti di ricerca. I server vengono aggiunti alla farm e si diventa amministratori per tutti questi server. È possibile creare nuovi server applicazioni o definire server applicazioni in una distribuzione esistente.
Importante
[!IMPORTANTE] Per le procedure descritte in questo articolo viene utilizzato Microsoft PowerShell. È possibile eseguire i comandi di Microsoft PowerShell in qualsiasi server della farm. Tuttavia, se si eseguono più procedure di topologia di ricerca, è necessario usare la stessa Shell di gestione di SharePoint per tutti i comandi di Microsoft PowerShell in modo da poter condividere i riferimenti agli oggetti di Microsoft PowerShell tra i comandi.
Avviare un'istanza del servizio di ricerca in un server
Prima di aggiungere i componenti di ricerca a un nuovo server, è necessario innanzitutto avviare un'istanza del servizio di ricerca nel server. Tale istanza avvia tutti i servizi Windows necessari che vengono utilizzati dal servizio di ricerca (OSearch16 e SPSearchHostController).
Per avviare un'istanza del servizio di ricerca
Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.
Avviare SharePoint Management Shell in uno dei server della farm.
Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:
$<host n > = Get-SPEnterpriseSearchServiceInstance -Identity "<Server name>" Start-SPEnterpriseSearchServiceInstance -Identity $<host n >
Dove:
$ <host n> specifica il riferimento all'oggetto di PowerShell per l'istanza del servizio di ricerca.
<Server name> specifica il server in cui si desidera aggiungere un componente di indicizzazione. L'input deve essere un GUID valido, nel formato
12345678-90ab-cdef-1234-567890bcdefgh
, un nome valido di un server (ad esempio , myserver1 ) o un'istanza di un oggetto SearchServiceInstance valido.
Ad esempio:
$hostA = Get-SPEnterpriseSearchServiceInstance -Identity "myserver1" $hostB = Get-SPEnterpriseSearchServiceInstance -Identity "myserver2" Start-SPEnterpriseSearchServiceInstance -Identity $hostA Start-SPEnterpriseSearchServiceInstance -Identity $hostB
Usare i riferimenti ($<host n>) per specificare il server di destinazione quando si aggiungono componenti di ricerca.
Attendere che siano in esecuzione tutte le istanze del servizio di ricerca. Per ognuna di tali istanze, al prompt dei comandi di Microsoft PowerShell digitare il comando seguente e attendere che venga restituito lo stato Online:
Get-SPEnterpriseSearchServiceInstance -Identity $<host n >
Ad esempio:
Get-SPEnterpriseSearchServiceInstance -Identity $hostA TypeName : SharePoint Server Search Description : Index content and serve search queries Id : 82ce8815-ecbd-4cf3-a98e-33f20bd86039 Server : SPServer Name=myserver1.example.com Service : SearchService Name=OSearch16 Role : None Status : Online
Recuperare la topologia di ricerca attiva
Per visualizzare la topologia di ricerca attiva dell'applicazione del servizio di ricerca, è necessario utilizzare Microsoft PowerShell.
Per visualizzare la topologia di ricerca attiva
Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.
Avviare una SharePoint Management Shell. Se è già aperta una SharePoint Management Shell in cui sono stati creati riferimenti a oggetti di Microsoft PowerShell riutilizzabili, utilizzare invece la shell aperta.
Al prompt dei comandi di Microsoft PowerShell digitare il comando seguente:
$ssa = Get-SPEnterpriseSearchServiceApplication $active = Get-SPEnterpriseSearchTopology -Active -SearchApplication $ssa $active
Questo comando restituisce informazioni sulla topologia attiva, ad esempio:TopologyId : 2d7bb046-1ad4-43a9-9984-754c4551a3ec CreationDate : 1/25/2016 3:06:00 AM State : Active ComponentCount : 6
Recuperare un elenco dei componenti di ricerca
Per visualizzare un elenco di componenti di ricerca nella topologia di ricerca attiva con le relative proprietà, è necessario usare Microsoft PowerShell. Una delle proprietà del componente di ricerca è l'ID del componente di ricerca. Sarà necessario solo l'ID del componente di ricerca per rimuovere un componente di ricerca.
Per visualizzare l'elenco di tutti i componenti di ricerca
Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.
Avviare una SharePoint Management Shell. Se si dispone già di una Shell di gestione SharePoint aperta in cui sono stati creati riferimenti a oggetti di SharePoint Management Shell riutilizzabili, usare invece la shell aperta.
Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:
$ssa = Get-SPEnterpriseSearchServiceApplication $active = Get-SPEnterpriseSearchTopology -SearchApplication $ssa -Active Get-SPEnterpriseSearchComponent -SearchTopology $active
Il comando restituisce un elenco dei componenti di ricerca nella topologia di ricerca attiva con le relative proprietà.
Clonare la topologia di ricerca attiva
Per apportare qualsiasi modifica alla topologia di ricerca in un'installazione di ricerca con elementi nell'indice di ricerca, è necessario innanzitutto creare un nuovo oggetto topologia. È possibile modificare tale nuovo oggetto, che è un clone della topologia attiva, aggiungendo o rimuovendo componenti di ricerca. Dopo aver apportato le modifiche all'oggetto topologia clone, è possibile impostare il clone come topologia attiva.
Per clonare la topologia attiva
Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.
Avviare una SharePoint Management Shell. Se è già aperta una SharePoint Management Shell in cui sono stati creati riferimenti a oggetti di Microsoft PowerShell riutilizzabili, utilizzare invece la shell aperta.
Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:
$ssa = Get-SPEnterpriseSearchServiceApplication $active = Get-SPEnterpriseSearchTopology -SearchApplication $ssa -Active $clone = New-SPEnterpriseSearchTopology -SearchApplication $ssa -Clone -SearchTopology $active
Il comando crea una topologia di ricerca clone a cui è possibile fare riferimento con $clone se si continua a usare la stessa Shell di gestione di SharePoint per aggiungere o rimuovere i componenti di ricerca e per attivare la topologia di ricerca.
(Facoltativo) Se si desidera rimuovere componenti di ricerca dalla topologia di ricerca, è necessario recuperare l'ID di tali componenti. Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:
Get-SPEnterpriseSearchComponent -SearchTopology $clone
Il comando restituisce un elenco dei componenti di ricerca nella topologia di ricerca clonata con le relative proprietà, incluso l'ID di tali componenti.
Aggiungere un componente di ricerca
Non è possibile modificare direttamente la topologia di ricerca attiva. In questa procedura si presuppone che sia stato creato un oggetto topologia clone come illustrato in Clonare la topologia di ricerca attiva. È possibile utilizzare i cmdlet di Microsoft PowerShell seguenti per ogni componente di ricerca:
New-SPEnterpriseSearchAdminComponent
New-SPEnterpriseSearchAnalyticsProcessingComponent
New-SPEnterpriseSearchContentProcessingComponent
New-SPEnterpriseSearchCrawlComponent
New-SPEnterpriseSearchQueryProcessingComponent
Nota
[!NOTA] La procedura per aggiungere un componente di indicizzazione è diversa. Per ulteriori informazioni, vedere Gestire il componente di indicizzazione in SharePoint Server.
Per aggiungere un componente di ricerca
Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.
Avviare una SharePoint Management Shell. Se è già aperta una SharePoint Management Shell in cui sono stati creati riferimenti a oggetti di Microsoft PowerShell riutilizzabili, utilizzare invece la shell aperta.
Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:
New-SPEnterpriseSearch<SearchComponent> -SearchTopology $clone -SearchServiceInstance $<host n >
Dove:
<SearchComponent> è il nome del tipo di componente di ricerca da aggiungere.
$clone è la topologia clonata che si desidera modificare. Vedere Clonare la topologia di ricerca attiva.
$<host n> è il riferimento all'oggetto PowerShell all'istanza del servizio di ricerca in esecuzione nel server a cui si vuole aggiungere il componente di ricerca. Vedere Avviare un'istanza del servizio di ricerca in un server.
Ad esempio, il comando seguente aggiunge un componente di elaborazione del contenuto alla topologia clone nel server identificato dal riferimento all'istanza del servizio di ricerca $hostA.
New-SPEnterpriseSearchContentProcessingComponent -SearchTopology $clone -SearchServiceInstance $hostA
Verificare che il nuovo componente di ricerca sia stato aggiunto alla topologia clone. Al prompt dei comandi di Microsoft PowerShell digitare il comando:
Get-SPEnterpriseSearchComponent -SearchTopology $clone
Rimuovere un componente di ricerca
Per rimuovere un componente di ricerca, è necessario utilizzare Windows PowerShell. Non è possibile modificare direttamente la topologia di ricerca attiva. In questa procedura si presuppone che sia stato creato un oggetto topologia clone come illustrato in Clonare la topologia di ricerca attiva.
Nota
[!NOTA] La procedura per rimuovere un componente di indicizzazione è diversa. Per ulteriori informazioni, vedere Gestire il componente di indicizzazione in SharePoint Server.
Per rimuovere un componente di ricerca
Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.
Avviare una SharePoint Management Shell. Se è già aperta una SharePoint Management Shell in cui sono stati creati riferimenti a oggetti di Microsoft PowerShell riutilizzabili, utilizzare invece la shell aperta.
Verificare che la topologia attiva corrente sia integra e che il componente di ricerca da rimuovere sia Attivo. Visualizzare lo stato della topologia di ricerca nella pagina Amministrazione ricerca in Amministrazione centrale o eseguire il cmdlet
Get-SPEnterpriseSearchStatus
di Windows PowerShell.Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:
Remove-SPEnterpriseSearchComponent -Identity <Search component id> -SearchTopology $clone
Dove:
<Search component id> è l'ID del componente di ricerca che si desidera rimuovere. Utilizzare l'ID derivante dalla topologia clone. Per recuperare l'ID del componente di ricerca, vedere il passaggio 4 in Clonare la topologia di ricerca attiva.
$clone è la topologia clonata che si desidera modificare. Vedere Clonare la topologia di ricerca attiva.
Quando richiesto, confermare che si desidera rimuovere il componente di ricerca.
Spostare un componente di ricerca
Se si desidera spostare un componente di ricerca da un server a un altro, è consigliabile aggiungere un nuovo componente di ricerca alla topologia di ricerca prima di rimuovere il componente di ricerca precedente.
Per spostare un componente di ricerca
Clonare la topologia di ricerca attiva. Vedere Clonare la topologia di ricerca attiva.
Aggiungere un nuovo componente di ricerca al server in cui si desidera poi ospitare il componente. Vedere Aggiungere un componente di ricerca.
Attivare la topologia di ricerca. In questa topologia sarà presente un componente di ricerca superfluo. Vedere Attivare una topologia di ricerca.
Verificare che la topologia attiva corrente sia integra. Visualizzare lo stato della topologia di ricerca nella pagina Amministrazione ricerca in Amministrazione centrale o eseguire il cmdlet
Get-SPEnterpriseSearchStatus
di Windows PowerShell.Clonare di nuovo la topologia di ricerca. Vedere Clonare la topologia di ricerca attiva.
Rimuovere il componente di ricerca superfluo. Vedere Rimuovere un componente di ricerca.
Attivare di nuovo la topologia di ricerca. Vedere Attivare una topologia di ricerca.
Attivare una topologia di ricerca
Per attivare una topologia di ricerca, è necessario utilizzare Windows PowerShell.
Per attivare una topologia di ricerca
Verificare che l'account utente che sta eseguendo la procedura sia membro del gruppo Amministratori farm.
Avviare una SharePoint Management Shell. Se è già aperta una SharePoint Management Shell in cui sono stati creati riferimenti a oggetti di Microsoft PowerShell riutilizzabili, utilizzare invece la shell aperta.
Al prompt dei comandi di Microsoft PowerShell digitare i comandi seguenti:
Set-SPEnterpriseSearchTopology -Identity $clone
Dove:
- $clone è la topologia clonata che si desidera modificare. Vedere Clonare la topologia di ricerca attiva.
Verificare che la nuova topologia sia attiva. Al prompt dei comandi di Windows PowerShell digitare i comandi seguenti:
Get-SPEnterpriseSearchTopology -Active -SearchApplication $ssa
Il comando restituisce una panoramica delle topologie attive e inattive, ad esempio:
TopologyId : fce8507d-61c6-4498-8038-4fd2d0a62c6e CreationDate : 1/30/2016 2:52:00 AM State : Inactive ComponentCount : 6 TopologyId : b63d48b2-df5c-41be-a7f4-9abaee483611 CreationDate : 1/30/2016 4:30:00 AM State : Active ComponentCount : 7
Si noterà che il conteggio dei componenti della topologia attiva riflette le modifiche apportate.