Set-SPEnterpriseSearchResultSource

Imposta le proprietà di un'origine dei risultati.

Sintassi

Set-SPEnterpriseSearchResultSource
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationType <FederationAuthType>]
   [-AutoDiscover <Boolean>]
   [-Confirm]
   [-Description <String>]
   -Identity <ResultSourcePipeBind>
   [-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 aggiorna le proprietà di un'origine dei risultati creata dall'utente. Questo cmdlet supporta le stesse operazioni di aggiornamento supportate tramite la pagina "Gestisci origini risultati" in Amministrazione centrale. L'origine dei risultati non può essere un'origine predefinita, ovvero la cui proprietà BuiltIn è impostata su true, per qualsiasi operazione di aggiornamento diversa dalla modifica dell'origine dei risultati predefinita tramite il parametro MakeDefault. 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 1---------------------

$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -Identity $customResultSource -Name "Basic SharePoint Result Source"

In questo esempio viene aggiornato il nome dell'origine dei risultati e l'identità dell'origine dei risultati viene specificata come istanza di origine del risultato. SearchApplication e Owner non sono necessari per questa operazione di aggiornamento.

--------------------ESEMPIO 2---------------------

$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -Identity "Custom SharePoint Result Source" -Description "A custom SharePoint Result Source for demonstration purposes"

In questo esempio viene aggiornata la descrizione dell'origine dei risultati e l'identità dell'origine dei risultati viene specificata in base al nome.

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 un tipo di autenticazione per l'origine dei risultati. Se il parametro non viene specificato, il valore rimane invariato.

Un set specifico di tipi di autenticazione è supportato per ogni tipo di provider di ricerca e se il parametro non è specificato, il tipo di autenticazione verrà predefinito 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 di Exchange Server per l'origine dei risultati.

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

Se il parametro non viene specificato, il valore rimane invariato.

È 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 una descrizione per l'origine dei risultati.

Se il parametro non viene specificato, il valore rimane invariato.

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

-Identity

Specifica l'origine dei risultati da aggiornare.

Il tipo deve essere una stringa GUID valida nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un'origine dei risultati (ad esempio "Origine risultati di SharePoint personalizzati") oppure un'istanza di un oggetto Source valido.

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

-MakeDefault

Specifica se l'origine dei risultati deve essere impostata come origine del risultato predefinita o meno per l'ambito specificato dal parametro Owner.

Se il parametro non è specificato, l'origine dei risultati predefinita non verrà modificata.

Se il valore viene impostato su true ($true), l'origine dei risultati viene impostata come predefinita.

L'impostazione del valore su false ($false) indica che l'origine dei risultati non deve essere impostata come predefinita e, in questo caso, se l'origine dei risultati da aggiornare è attualmente predefinita, l'origine dei risultati predefinita originale ("Risultati di SharePoint locali") verrà nuovamente impostata come predefinita.

Suggerimento: usare l'istanza, non il nome o l'ID stringa GUID, come Identità quando si usa Makedefault, per specificare chiaramente che Il proprietario deve essere usato solo per specificare il livello in cui l'origine dei risultati deve essere impostata come predefinita (se il valore è true) o dove il valore predefinito deve essere reimpostato su originale (se il valore è false).

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 un nome per l'origine dei risultati.

Se il parametro non viene specificato, il valore rimane invariato.

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:False
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 è disponibile l'origine dei risultati corrispondente.

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

-Password

Specifica la password delle credenziali utente da utilizzare per la connessione all'origine dei risultati.

Se il parametro non viene specificato, il valore rimane invariato.

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 dall'origine dei risultati.

Se il parametro non viene specificato, il valore rimane invariato.

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:False
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 dell'origine dei risultati.

Se il parametro non viene specificato, il valore rimane invariato.

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 un modello di URL di connessione per l'origine dei risultati.

Se il parametro non viene specificato, il valore rimane invariato.

Deve essere impostato quando si utilizza un provider di ricerca che lo richiede: ricerca di SharePoint remota, ricerca di utenti di SharePoint remota, OpenSearch 1.0/1.1 e ricerca di Exchange (se è attivata l'individuazione automatica).

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 AppRicerca1, oppure un'istanza di un oggetto SearchServiceApplication valido.

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

-SsoId

Specifica l'ID di archiviazione sicura del certificato del proxy inverso da utilizzare per la connessione all'origine dei risultati.

Se il parametro non viene specificato, il valore rimane invariato.

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 all'origine dei risultati.

Se il parametro non viene specificato, il valore rimane invariato.

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