Set-SPEnterpriseSearchResultSource
Legt Eigenschaften einer Ergebnisquelle fest.
Syntax
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>] Beschreibung
Dieses Cmdlet aktualisiert Eigenschaften einer vom Benutzer erstellten Ergebnisquelle. Dieses Cmdlet unterstützt dieselben Updatevorgänge, die über die Seite "Ergebnisquellen verwalten" in der Zentraladministration unterstützt werden. Die Ergebnisquelle darf keine vordefinierte Quelle (bei einer vordefinierten Quelle ist die "BuiltIn"-Eigenschaft auf "true" festgelegt) für einen Aktualisierungsvorgang sein, der sich vom Ändern der Standardergebnisquelle mit dem "MakeDefault"-Parameter unterscheidet. Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.
Beispiele
------------------BEISPIEL 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 diesem Beispiel wird der Name der Ergebnisquelle aktualisiert, und die Identität der Ergebnisquelle wird als Ergebnisquelleninstanz angegeben. SearchApplication und Owner sind für diesen Updatevorgang nicht erforderlich.
------------------BEISPIEL 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 diesem Beispiel wird die Beschreibung der Ergebnisquelle aktualisiert, und die Identität der Ergebnisquelle wird durch den Namen angegeben.
Parameter
-AssignmentCollection
Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.
Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten.
Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.
| 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
Gibt einen Authentifizierungstyp für die Ergebnisquelle an. Wird der Parameter nicht angegeben, bleibt der Wert unverändert.
Ein bestimmter Satz von Authentifizierungstypen wird für jeden Suchanbietertyp unterstützt, und wenn der Parameter nicht angegeben ist, basiert der Authentifizierungstyp standardmäßig auf dem Suchanbietertyp.
Dieses Cmdlet unterstützt die folgenden Authentifizierungsmechanismen und entsprechenden Typen: Standard-SharePoint-Authentifizierung (FederationAuthType.LocalNTAuth), Standardauthentifizierung (FederationAuthType.SingleAccountBasicAuth – Angeben von Benutzername und Kennwort), Standardmäßige SharePoint-Remoteauthentifizierung (FederationAuthType.PerUserBasicAuth), Einmaliges Anmelden (FederationAuthType.SSO – SsoId muss angegeben werden), Anonym (FederationAuthType.Anonymous), Digest Authentication ( FederationAuthType.SingleAccountDigest : Geben Sie UserName und Password an, ntlm application pool identity (FederationAuthType.ApplicationPoolIdentity), NTLM User Name and Password (FederationAuthType.SingleAccountNTLM – geben Sie UserName und Password an).
Wenn Sie einen Anbieter für die lokale SharePoint-Suche/lokale SharePoint-Personen-Suche verwenden, werden FederationAuthType.LocalNTAuth (Standard) und FederationAuthType.SingleAccountBasicAuth unterstützt.
Bei Verwendung eines Suchanbieters für Remote sharePoint/Remote SharePoint Personen Search werden FederationAuthType.PerUserBasicAuth (Standard) und FederationAuthType.SSO unterstützt.
Bei Verwendung des Suchanbieters OpenSearch 1.0/1.1 werden die folgenden Authentifizierungstypen unterstützt: FederationAuthType.Anonymous (Standard), FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest, FederationAuthType.SingleAccountNTLM und FederationAuthType.ApplicationPoolIdentity.
Alle Authentifizierungstypen sind in der Enumeration FederationAuthType aufgeführt.
| 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
Gibt an, ob die automatische Ermittlung des Exchange-Serverendpunkts für die Ergebnisquelle verwendet werden soll.
Bei Festlegung auf "true ($true)" wird die automatische Ermittlung verwendet.
Wird der Parameter nicht angegeben, bleibt der Wert unverändert.
Nur zutreffend bei Verwenden eines Exchange-Suchanbieters.
| 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
Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird.
Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: 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
Gibt eine Beschreibung der Ergebnisquelle an.
Wird der Parameter nicht angegeben, bleibt der Wert unverändert.
| 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
Gibt die zu aktualisierende Ergebnisquelle an.
Der Typ muss eine gültige GUID-Zeichenfolge im Format "12345678-90ab-cdef-1234-567890bcdefgh", ein gültiger Name einer Ergebnisquelle (Beispiel: Benutzerdefinierte SharePoint-Ergebnisquelle) oder eine Instanz eines gültigen Source-Objekts sein.
| 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
Gibt an, ob die Ergebnisquelle für den durch den Owner-Parameter angegebenen Bereich als Standardergebnisquelle festgelegt werden soll oder nicht.
Wenn der Parameter nicht angegeben ist, ändert sich die Standardergebnisquelle nicht.
Bei Festlegen des Werts auf "true ($true)" wird die Ergebnisquelle als Standard festgelegt.
Das Festlegen des Werts auf false ($false) gibt an, dass die Ergebnisquelle nicht als Standard festgelegt werden soll. Wenn die zu aktualisierende Ergebnisquelle derzeit die Standardquelle ist, wird die ursprüngliche Standardergebnisquelle ("Lokale SharePoint-Ergebnisse") erneut als Standard festgelegt.
Tipp: Verwenden Sie instanz, nicht name oder GUID-Zeichenfolgen-ID als Identität, wenn Sie Makedefault verwenden, um eindeutig anzugeben, dass Besitzer nur zum Angeben der Ebene verwendet werden soll, auf der die Ergebnisquelle als Standard festgelegt werden soll (wenn der Wert true ist) oder auf den Standardwert zurückgesetzt werden soll (wenn der Wert false ist).
| 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
Gibt den Namen der Ergebnisquelle an.
Wird der Parameter nicht angegeben, bleibt der Wert unverändert.
Auf jeder Verwaltungsstufe müssen Namen eindeutig sein.
Zwei Ergebnisquellen in einer Website können beispielsweise einen Namen nicht gemeinsam nutzen, was jedoch bei einer in einer Website und einer anderen der Fall sein kann, die von der Websitesammlung bereitgestellt wird.
| 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
Gibt den Suchobjektbesitzer an, der den Bereich definiert, in dem die entsprechende Ergebnisquelle verfügbar ist.
| 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
Gibt das Kennwort der Anmeldeinformationen an, die zum Herstellen einer Verbindung mit der Ergebnisquelle verwendet werden sollen.
Wird der Parameter nicht angegeben, bleibt der Wert unverändert.
Wird verwendet, wenn der Authentifizierungstyp (AuthenticationType) auf einen Typ festgelegt ist, der Benutzeranmeldeinformationen nutzt (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest oder 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
Gibt einen Suchanbieter an, der von der Ergebnisquelle verwendet werden soll.
Wenn der Parameter nicht angegeben wird, bleibt der Wert unverändert.
Wird als GUID oder GUID-Zeichenfolge angegeben, die eines der folgenden Formate haben muss: FA947043-6046-4F97-9714-40D4C113963D (Lokale SharePoint-Suche), E4BCC058-F133-4425-8FFC-1D70596FFD33 (Lokale SharePoint-Personensuche), 1E0C8601-2E5D-4CCB-9561-53743B5DBDE7 (SharePoint-Remotesuche), E377CAAA-FCAF-4a1b-B7A1-E69A506A07AA (SharePoint-Remotepersonensuche), 3A17E140-1574-4093-BAD6-E19CDF1C0122 (Exchange-Suche), 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
Gibt die Abfragetransformationsvorlage der Ergebnisquelle an.
Wenn der Parameter nicht angegeben wird, bleibt der Wert unverändert.
Eingehende Abfragen werden gemäß der Vorlage so geändert, dass stattdessen der neue Abfragetext verwendet wird. Fügen Sie mithilfe der Abfragevariablen "{searchTerms}" der eingehenden Abfrage den neuen Text hinzu. Sie legen damit einen Ergebnisbereich fest.
Wenn Sie beispielsweise nur OneNote-Elemente zurückgeben möchten, legen Sie den neuen Text auf "{searchTerms}fileextension=one" fest. Anschließend ändert sich die eingehende Abfrage "sharepoint" in "sharepoint fileextension=one". Der Standardwert ist "{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
Gibt eine Verbindungs-URL-Vorlage für die Ergebnisquelle an.
Wird kein Parameter angegeben, bleibt der Wert unverändert.
Muss festgelegt werden, wenn ein Suchanbieter verwendet wird, der diese nutzt: SharePoint-Remotesuche, SharePoint-Remotepersonensuche, OpenSearch 1.0/1.1 und Exchange (wenn die AutoErmittlung nicht aktiviert ist).
Bei Verwenden anderer Suchanbieter wird der Parameter ignoriert.
Geben Sie für SharePoint-Remotesuche/SharePoint-Remotepersonensuche die Adresse der Stamm-Websitesammlung der SharePoint-Remotefarm an.
Geben Sie für OpenSearch 1.0/1.1 die URL der OpenSearch-Quelle an.
Fügen Sie die Abfrage der URL mithilfe der Abfragevariablen "{searchTerms}" hinzu, die automatisch durch die Abfrage ersetzt wird. Geben Sie für Exchange die Exchange EWS-URL an, von der Ergebnisse abgerufen werden sollen.
| 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
Gibt die Suchanwendung an.
Der Typ muss eine gültige GUID im Format "12345678-90ab-cdef-1234-567890bcdefgh", ein gültiger Name einer Suchanwendung (z. B. "SuchAnw1") oder eine Instanz eines gültigen SearchServiceApplication-Objekts sein.
| 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
Gibt das Reverseproxyzertifikat (ID für einmaliges Anmelden) an, das zum Herstellen der Verbindung mit der Ergebnisquelle verwendet werden soll.
Wird der Parameter nicht angegeben, bleibt der Wert unverändert.
Muss angegeben werden, wenn der Authentifizierungstyp (AUthenticationType) auf FederationAuthType.SSO (Einmaliges Anmelden) festgelegt ist.
Wenn Sie über einen Reverseproxy eine Verbindung mit Ihrem Intranet herstellen, geben Sie die ID für einmaliges Anmelden des Eintrags für einmaliges Anmelden ein, in dem das Zertifikat gespeichert ist, das für eine Authentifizierung beim Reverseproxy verwendet wird.
| 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
Gibt den Benutzernamen der Anmeldeinformationen an, die zum Herstellen einer Verbindung mit der Ergebnisquelle verwendet werden sollen.
Wird der Parameter nicht angegeben, bleibt der Wert unverändert.
Wird verwendet, wenn der Authentifizierungstyp (AuthenticationType) auf einen Typ festgelegt ist, der Benutzeranmeldeinformationen nutzt (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest oder 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
Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen.
Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: 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 |
Ähnliche Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für