Set-SPEnterpriseSearchResultSource
Legt Eigenschaften einer Ergebnisquelle fest.
Syntax
Default (Standardwert)
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 Ergebnisquelle instance 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
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | SPAssignmentCollection |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-AuthenticationType
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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 wird, 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 – Geben Sie Benutzername und Kennwort an), Standardmäßige SharePoint-Remoteauthentifizierung (FederationAuthType.PerUserBasicAuth), Single Sign-On (FederationAuthType.SSO – erfordert die Angabe von SsoId), Anonym (FederationAuthType.Anonymous), Digest Authentication (FederationAuthType.SingleAccountDigest – Angeben von Benutzername und Kennwort), NTLM-Anwendungspoolidentität (FederationAuthType.ApplicationPoolIdentity), NTLM-Benutzername und -Kennwort (FederationAuthType.SingleAccountNTLM – Angeben von Benutzername und Kennwort).
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.
Parametereigenschaften
| Typ: | FederationAuthType |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-AutoDiscover
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Description
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt eine Beschreibung der Ergebnisquelle an.
Wird der Parameter nicht angegeben, bleibt der Wert unverändert.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | ResultSourcePipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MakeDefault
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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 der Standardwert ist, wird die ursprüngliche Standardergebnisquelle ("Lokale SharePoint-Ergebnisse") erneut als Standard festgelegt.
Tipp: Verwenden Sie instance, 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).
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Owner
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt den Suchobjektbesitzer an, der den Bereich definiert, in dem die entsprechende Ergebnisquelle verfügbar ist.
Parametereigenschaften
| Typ: | SearchObjectOwner |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | o |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Password
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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).
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ProviderId
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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).
Parametereigenschaften
| Typ: | Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-QueryTemplate
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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}".
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RemoteUrl
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SearchApplication
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | SearchServiceApplicationPipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SsoId
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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 (Single Sign-On) 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UserName
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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).
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.