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