Get-SPEnterpriseSearchQueryScopeRule
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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |