Condividi tramite


Get-SPEnterpriseSearchQueryScope

Restituisce un ambito di risultati di query.

Sintassi

Get-SPEnterpriseSearchQueryScope
   [[-Identity] <ScopePipeBind>]
   -SearchApplication <SearchServiceApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Url <Uri>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-SPEnterpriseSearchQueryScope legge un oggetto QueryScope quando si crea o elimina l'ambito condiviso oppure quando si aggiorna la definizione dell'ambito condiviso.

Se il parametro Identity non è specificato, questo cmdlet restituisce l'insieme di ambiti di query dall'applicazione di ricerca specificata.

In SharePoint Server le origini dei risultati forniscono la funzionalità fornita dagli ambiti in SharePoint Server.

Durante un aggiornamento da SharePoint Server, per mantenere le impostazioni legacy, viene eseguita automaticamente la migrazione degli ambiti condivisi. Tali ambiti sono tuttavia di sola lettura dopo la migrazione. Questo cmdlet può essere utilizzato per leggere un ambito condiviso di cui è stata eseguita la migrazione.

Durante un aggiornamento da SharePoint Server, per mantenere le impostazioni legacy, anche gli ambiti locali vengono migrati automaticamente quando viene eseguita la migrazione dei siti o delle raccolte siti corrispondenti. In una farm di SharePoint Server, gli ambiti di un sito o di una raccolta siti in modalità SharePoint Server sono di lettura/scrittura, mentre gli ambiti di un sito o di una raccolta siti dopo l'aggiornamento alla modalità SharePoint Server sono di sola lettura. Questo cmdlet può essere utilizzato per leggere un ambito locale di cui è stata eseguita la migrazione nell'una o nell'altra situazione.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

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

$ssa = Get-SPenterpriseSearchServiceApplication -Identity 'Search service Application'
Get-SPEnterpriseSearchQueryScope -Identity MustCrawl -SearchApplication $ssa | Set-SPEnterpriseSearchQueryScope -Description "Business critical sites to index" -CompilationType 1 -AlternateResultsPage https://altServer

Questo esempio ottiene un riferimento all'ambito denominato MustCrawl sull'applicazione di ricerca denominata MySSA e ne modifica la descrizione, il tipo di compilazione e l'URL di accesso alternativo.

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

-Identity

Specifica l'ambito di risultati da ottenere.

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

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

-SearchApplication

Specifica l'applicazione di ricerca che contiene l'ambito 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.

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

-Url

Filtra per la restituzione di ambiti per gli URL di risultati specificati.

Il tipo deve essere un URL valido nel formato https://server_name.

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