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 |