New-SPEnterpriseSearchResultSource

Crea una nuova origine dei risultati.

Sintassi

New-SPEnterpriseSearchResultSource
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationType <FederationAuthType>]
   [-AutoDiscover <Boolean>]
   [-Confirm]
   [-Description <String>]
   [-MakeDefault <Boolean>]
   -Name <String>
   -Owner <SearchObjectOwner>
   [-Password <String>]
   -ProviderId <Guid>
   [-QueryTemplate <String>]
   [-RemoteUrl <String>]
   -SearchApplication <SearchServiceApplicationPipeBind>
   [-SsoId <String>]
   [-UserName <String>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Questo cmdlet crea un'origine dei risultati. Utilizzare le origini dei risultati per definire l'ambito dei risultati della ricerca ed eseguire la federazione delle query su origini esterne, ad esempio i motori di ricerca su Internet. Dopo avere definito un'origine dei risultati, configurare le Web part di ricerca e le azioni delle regole di query per utilizzarla. Le origini dei risultati sostituiscono gli ambiti di ricerca, che ora sono deprecati. Questo cmdlet supporta le stesse operazioni di creazione supportate tramite la pagina "Gestisci origini risultati" in Amministrazione centrale, ad eccezione delle operazioni "Autenticazione modulo" e "Autenticazione cookie". 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
$owner = Get-SPEnterpriseSearchOwner -Level SSA
New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"

In questo esempio viene creata una nuova origine dei risultati a livello di applicazione del servizio di ricerca denominata "Origine risultati SharePoint personalizzata".

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

-AuthenticationType

Specifica il tipo di autenticazione della nuova origine dei risultati.

Per ogni tipo di provider di ricerca è supportato un set specifico di tipi di autenticazione e, se il parametro non viene specificato, il tipo di autenticazione predefinito varia in base al tipo di provider di ricerca.

Questo cmdlet supporta il seguente set di meccanismi di autenticazione con i tipi corrispondenti: autenticazione predefinita di SharePoint (FederationAuthType.LocalNTAuth), autenticazione di base (FederationAuthType.SingleAccountBasicAuth, è necessario specificare UserName e Password), autenticazione remota predefinita di SharePoint (FederationAuthType.PerUserBasicAuth), Single Sign-On (FederationAuthType.SSO, è necessario specificare SsoId), anonima (FederationAuthType.Anonymous), autenticazione del digest (FederationAuthType.SingleAccountDigest, è necessario specificare UserName e Password), identità del pool di applicazioni NTLM (FederationAuthType.ApplicationPoolIdentity), nome utente e password NTLM (FederationAuthType.SingleAccountNTLM, è necessario specificare UserName e Password).

Quando si utilizza un provider di ricerca di SharePoint locale o di ricerca di utenti di SharePoint locale, sono supportati i tipi di autenticazione FederationAuthType.LocalNTAuth (impostazione predefinita) e FederationAuthType.SingleAccountBasicAuth.

Quando si utilizza un provider di ricerca di SharePoint remoto o di ricerca di utenti di SharePoint remoto, sono supportati i tipi di autenticazione FederationAuthType.PerUserBasicAuth (impostazione predefinita) e FederationAuthType.SSO.

Quando si utilizza il provider di ricerca OpenSearch 1.0/1.1, sono supportati i seguenti tipi di autenticazione: FederationAuthType.Anonymous (impostazione predefinita), FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest, FederationAuthType.SingleAccountNTLM e FederationAuthType.ApplicationPoolIdentity.

Tutti i tipi di autenticazione sono elencati nell'enumerazione FederationAuthType.

Type:FederationAuthType
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

-AutoDiscover

Specifica se utilizzare l'individuazione automatica dell'endpoint del server Exchange per la nuova origine dei risultati.

Se il valore viene impostato su true ($true), l'individuazione automatica viene utilizzata. Se il valore non viene specificato o viene impostato su false ($false), l'individuazione automatica non viene utilizzata.

È applicabile solo quando si utilizza un provider di ricerca di Exchange.

Type:Boolean
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

-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

-Description

Specifica la descrizione della nuova origine dei risultati.

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

-MakeDefault

Specifica se la nuova origine dei risultati deve essere impostata come predefinita per l'ambito definito dal parametro Owner.

Se il valore viene impostato su true ($true), l'origine dei risultati viene impostata come predefinita. Se non viene specificato o impostato su false, la nuova origine dei risultati non verrà impostata come predefinita.

Type:Boolean
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

-Name

Specifica il nome della nuova origine dei risultati.

I nomi devono essere univoci in ogni livello amministrativo.

Ad esempio, due origini dei risultati in un sito non possono avere lo stesso nome, mentre ciò è possibile se una è in un sito e una viene fornita dalla raccolta siti.

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

-Owner

Specifica il proprietario dell'oggetto ricerca che definisce l'ambito in cui viene creata l'origine dei risultati corrispondente.

Type:SearchObjectOwner
Aliases:o
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

-Password

Specifica la password delle credenziali utente da utilizzare per la connessione alla nuova origine dei risultati.

Viene utilizzato quando il tipo di autenticazione (AuthenticationType) è impostato su un valore che richiede credenziali utente (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest o FederationAuthType.SingleAccountNTLM).

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

-ProviderId

Specifica il provider di ricerca che deve essere utilizzato dalla nuova origine dei risultati.

Viene specificato come GUID o stringa GUID, che deve corrispondere a una delle seguenti: FA947043-6046-4F97-9714-40D4C113963D (ricerca di SharePoint locale), E4BCC058-F133-4425-8FFC-1D70596FFD33 (ricerca di utenti di SharePoint locale), 1E0C8601-2E5D-4CCB-9561-53743B5DBDE7 (ricerca di SharePoint remota), E377CAAA-FCAF-4a1b-B7A1-E69A506A07AA (ricerca di utenti di SharePoint remota), 3A17E140-1574-4093-BAD6-E19CDF1C0122 (ricerca di Exchange), 3A17E140-1574-4093-BAD6-E19CDF1C0121 (OpenSearch 1.0/1.1).

Type:Guid
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

-QueryTemplate

Specifica il modello di trasformazione query della nuova origine dei risultati.

Le query in ingresso vengono modificate in base al modello, per usare invece questo nuovo testo di query. Includere la query in ingresso nel nuovo testo usando la variabile di query "{searchTerms}". Usare questa opzione per definire l'ambito dei risultati.

Ad esempio, per restituire solo elementi di OneNote, impostare il nuovo testo su "{searchTerms} fileextension=one". Una query in ingresso "sharepoint" diventa quindi "sharepoint fileextension=one". Il valore predefinito è {searchTerms}.

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

-RemoteUrl

Specifica il modello di URL di connessione della nuova origine dei risultati.

Deve essere impostato quando si usa un provider di ricerca che lo utilizza: Ricerca remota di SharePoint, Ricerca remota di SharePoint Persone, OpenSearch 1.0/1.1 ed Exchange (se l'individuazione automatica non è attivata).

Per altri provider di ricerca, questo parametro viene ignorato.

Per la ricerca di SharePoint remota e la ricerca di utenti di SharePoint remota, specificare l'indirizzo della raccolta siti radice della farm di SharePoint remota.

Per OpenSearch 1.0/1.1, specificare l'URL dell'origine OpenSearch.

Includere la query nell'URL utilizzando la variabile di query "{searchTerms}", che verrà automaticamente sostituita dalla query. Per Exchange, specificare l'URL di Servizi Web Exchange da cui recuperare i risultati.

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

-SearchApplication

Specifica l'applicazione di ricerca.

Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh; un nome di applicazione di ricerca valido, ad esempio SearchApp1 o 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SsoId

Specifica l'ID di archiviazione sicura del certificato proxy inverso da usare per connettersi alla nuova origine dei risultati.

Deve essere specificato se il tipo di autenticazione (AuthenticationType) è impostato su FederationAuthType.SSO (Single Sign-On).

Se si esegue la connessione alla rete Intranet tramite un proxy inverso, immettere l'ID SSO della voce Single Sign-On in cui è memorizzato il certificato utilizzato per eseguire l'autenticazione con il proxy inverso.

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

-UserName

Specifica il nome utente delle credenziali utente da utilizzare per la connessione alla nuova origine dei risultati.

Viene utilizzato quando il tipo di autenticazione (AuthenticationType) è impostato su un valore che richiede credenziali utente (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest o FederationAuthType.SingleAccountNTLM).

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