Get-SPEnterpriseSearchQueryScopeRule

Riferimento

Modulo:: sharepoint-server

Si applica a:: SharePoint Server Subscription Edition

Restituisce una regola di ambito condivisa.

Sintassi

Get-SPEnterpriseSearchQueryScopeRule
   [[-Identity] <ScopeRulePipeBind>]
   -Scope <ScopePipeBind>
   [-Url <Uri>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-SearchApplication <SearchServiceApplicationPipeBind>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-SPEnterpriseSearchQueryScopeRule legge un oggetto QueryScopeRule quando si crea, aggiorna o elimina una regola di ambito condivisa. SPEnterpriseSearchQueryScopeRule rappresenta una regola di ambito risultato di query che può essere applicata a un ambito.

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 una regola di ambito di 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 una regola di ambito di 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'
$scope = Get-SPEnterpriseSearchQueryScope -Identity MustCrawl -SearchApplication $ssa
Get-SPEnterpriseSearchQueryScopeRule -Scope $scope -Url https://criticalSite | Set-SPEnterpriseSearchQueryScopeRule -Url https://criticalSite -UrlScopeRuleType Url

In questo esempio viene ottenuto un riferimento a una regola di ambito per l'URL https://criticalSitee viene impostato il tipo di regola su URL.

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 la regola di ambito da ottenere.

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

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

-Scope

Restituisce le regole di ambito query per l'ambito specificato.

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
Aliases:	n
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SearchApplication

Specifica l'applicazione di ricerca che contiene l'insieme delle regole di 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:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Url

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

Restituisce le regole di ambito query per l'URL dei risultati specificato.

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