New-SPEnterpriseSearchQueryScopeRule

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Aggiunge una regola di ambito condivisa a un ambito di query.

Sintassi

New-SPEnterpriseSearchQueryScopeRule
   -RuleType <String>
   -Scope <ScopePipeBind>
   -Url <Uri>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-FilterBehavior <String>]
   [-ManagedProperty <ManagedPropertyPipeBind>]
   [-MatchingString <String>]
   [-PropertyValue <String>]
   [-SearchApplication <SearchServiceApplicationPipeBind>]
   [-UrlScopeRuleType <String>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Dopo aver aggiornato un'applicazione servizio di ricerca a SharePoint Server, è possibile visualizzare gli ambiti condivisi, ma non è possibile crearli, aggiornarli o eliminarli. Non è possibile pertanto utilizzare questo cmdlet per gli ambiti condivisi dopo aver eseguito l'aggiornamento. È tuttavia possibile convertire gli ambiti condivisi in origini dei risultati, che hanno uno scopo simile. Analogamente, dopo aver aggiornato una raccolta siti di SharePoint Server alla modalità SharePoint Server, è possibile visualizzare gli ambiti locali, ma non è possibile crearli, aggiornarli o eliminarli. Non è possibile pertanto utilizzare questo cmdlet per gli ambiti locali dopo aver eseguito l'aggiornamento di una raccolta siti. È tuttavia possibile convertire gli ambiti locali in origini dei risultati, che hanno uno scopo simile.

Il New-SPEnterpriseSearchQueryScopeRule cmdlet crea una nuova regola di ambito condiviso. SPEnterpriseSearchQueryScopeRule rappresenta una regola di ambito dei risultati di query applicabile a un ambito.

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------------------

C:\PS>$ssa = Get-SPEnterpriseSearchServiceApplication
C:\PS>$scope = Get-SPEnterpriseSearchQueryScope -Identity MustCrawl -SearchApplication $ssa
New-SPEnterpriseSearchQueryScopeRule -Scope $scope -RuleType AllContent -Url https://criticalSite

In questo esempio viene creata una nuova regola di ambito di tipo AllContent per l'URL https://criticalSite.

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

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
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

-FilterBehavior

Specifica il tipo di regola di ambito da creare per l'ambito di query. Il valore predefinito è Include.

Il tipo deve essere uno dei valori seguenti: Exclude, Include o Require.

Type:String
Aliases:f
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

-ManagedProperty

Specifica la proprietà gestita da utilizzare per la regola di ambito PropertyQuery.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome di proprietà gestita valido (ad esempio ProprietàGestita1) oppure un'istanza di un oggetto ManagedProperty valido.

Type:ManagedPropertyPipeBind
Aliases:mname
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

-MatchingString

Specifica la stringa da utilizzare per il tipo di regola URL.

Type:String
Aliases:text
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

-PropertyValue

Specifica il valore di proprietà da utilizzare per il tipo di regola PropertyQuery.

Type:String
Aliases:value
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

-RuleType

Specifica il tipo di regola di ambito da creare.

Il tipo deve essere uno dei valori seguenti: AllContent, Url o PropertyQuery.

Type:String
Aliases:type
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Scope

Applica la regola di ambito di query all'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:s
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

Specifica l'URL dei risultati associato alla regola di ambito di query.

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

Type:Uri
Aliases:u
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-UrlScopeRuleType

Specifica il valore da utilizzare per il tipo di regola URL.

Type:String
Aliases:ut
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

-WhatIf

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
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