Condividi tramite


Get-SPEnterpriseSearchStatus

Recupera informazioni di diagnostica per i componenti di ricerca.

Sintassi

Get-SPEnterpriseSearchStatus
   -SearchApplication <SearchServiceApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Component <String>]
   [-Constellation]
   [-Detailed]
   [-DetailSearchRuntime]
   [-HealthReport]
   [-JobStatus]
   [-Primary]
   [-Text]
   [<CommonParameters>]

Descrizione

Questo cmdlet recupera informazioni di diagnostica per tutti i componenti di ricerca o solo per quelli specificati per la topologia attiva di un'applicazione del servizio di ricerca.

Se non si specifica uno dei parametri facoltativi, il cmdlet recupererà lo stato di integrità di tutti i componenti di ricerca all'interno dell'applicazione del servizio di ricerca. Ogni componente di ricerca sarà associato a uno degli stati seguenti:

  • Active: il componente di ricerca funziona correttamente.
  • Degraded: questo stato indica che il componente di ricerca non è in grado di eseguire tutte le operazioni correttamente. Il motivo di questo stato in genere è dovuto a una situazione provvisoria correlata a un riavvio o a problemi di rete.
  • Failed: il componente di ricerca non è in esecuzione. Questo stato indica che il componente non è in grado di eseguire le operazioni correttamente.
  • Sconosciuto: il componente non può essere raggiunto. Il motivo di questo stato in genere è dovuto a problemi hardware o di comunicazione.

Se è stato definito più di un componente di indicizzazione per una partizione nella topologia di ricerca, questo cmdlet indicherà quale componente di indicizzazione svolge il ruolo principale per la partizione.

È possibile utilizzare il cmdlet per ottenere come output le informazioni aggiuntive seguenti:

  • Elencare lo stato delle attività in background (processi batch) avviate dai componenti di ricerca
  • Elencare lo stato delle attività in background (processi batch) avviate dai componenti di ricerca
  • Elencare informazioni di diagnostica dettagliate per il componente di indicizzazione
  • Eseguire il debug di informazioni che possono essere usate da Microsoft per la risoluzione dei problemi dettagliata

Se non si vuole eseguire l'iterazione dell'output in uno script, usare il parametro Text. Se non si utilizza il parametro Text, il cmdlet genererà un output di un insieme di oggetti con le proprietà seguenti:

  • string Name: nome del componente di ricerca, voce del report sullo stato o proprietà Constellation.
  • string State: stato del componente di ricerca.
  • string Level: quando si usa il parametro HealthReport, questa proprietà indica il livello di importanza di ogni voce del report sullo stato (Errore, Avviso, Informazioni, Dettagliato).
  • string Message: informazioni aggiuntive fornite come stringa di testo.
  • ReadOnlyDictionary<string,string>Details: coppie nome/valore del dizionario che forniscono informazioni di diagnostica aggiuntive

Per le autorizzazioni e le informazioni più aggiornate sulle Windows PowerShell per i prodotti SharePoint, vedere la documentazione online all'indirizzo https://go.microsoft.com/fwlink/p/?LinkId=251831.

Esempio

------------------ESEMPIO 1------------------

Get-SPEnterpriseSearchServiceApplication | Get-SPEnterpriseSearchStatus -Text

In questo esempio viene recuperato un elenco contenente informazioni di diagnostica su tutti i componenti di ricerca dell'applicazione del servizio di ricerca predefinita.

------------------ESEMPIO 2------------------

Get-SPEnterpriseSearchStatus -SearchApplication 'Search Service Application' -JobStatus -Text

In questo esempio viene recuperato lo stato del processo di attività in background per i processi timer di analisi dei dati di ricerca.

------------------ESEMPIO 3------------------

Get-SPEnterpriseSearchServiceApplication | Get-SPEnterpriseSearchStatus -HealthReport -Component IndexComponent1 -Text

In questo esempio vengono recuperate le informazioni di diagnostica per il componente di indicizzazione denominato IndexComponent1.

Parametri

-AssignmentCollection

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.

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.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Component

Specifica il nome del componente di ricerca. Questo parametro viene utilizzato solo insieme ai parametri HealthReport e Primary.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Constellation

Specifica se devono essere fornite informazioni di diagnostica interne per la topologia di ricerca. Questo parametro deve essere utilizzato solo per il debug.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Detailed

Specifica il livello di dettaglio del parametro HealthReport. Quando viene utilizzato questo parametro, il cmdlet genera nell'output anche informazioni di diagnostica dettagliate.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DetailSearchRuntime

Specifica se devono essere fornite informazioni di diagnostica interne per il runtime di ricerca. Questo parametro deve essere utilizzato solo per il debug.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-HealthReport

Specifica se devono essere fornite informazioni di diagnostica per il componente di ricerca. Quando si utilizza questo parametro, è necessario specificare il nome del componente utilizzando il parametro Component.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-JobStatus

Specifica se devono essere fornite informazioni sullo stato per i processi timer Analisi dati di ricerca e Analisi dati di utilizzo.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Primary

Specifica se il componente di amministrazione svolge il ruolo principale. Quando si utilizza questo parametro, è necessario specificare il nome del componente utilizzando il parametro Component. Restituisce true se il componente di amministrazione svolge il ruolo principale.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SearchApplication

Specifica l'applicazione del servizio di ricerca che contiene i componenti di ricerca.

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Text

Specifica se l'output di stampa di questo cmdlet deve essere generato in un formato adatto per la lettura. Se questo parametro non viene utilizzato, il cmdlet genera come output un oggetto SearchStatusInfo.

Quando si utilizza questo parametro, l'output viene stampato sulla console e non può essere inviato tramite pipe a un file o a un altro programma.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition