New-SPEnterpriseSearchResultSource
Erstellt eine neue Ergebnisquelle.
Syntax
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>] Beschreibung
Dieses Cmdlet erstellt eine Ergebnisquelle. Mithilfe von Ergebnisquellen können Sie Suchergebnisbereiche festlegen und Abfragen mit externen Quellen verknüpfen, z. B. Suchmaschinen im Internet. Konfigurieren Sie nach der Definition einer Ergebnisquelle Suchwebparts und Abfrageregelaktionen, die diese nutzen. Ergebnisquellen ersetzen Suchbereiche, die ab jetzt als veraltet gelten. Dieses Cmdlet unterstützt dieselben Erstellungsvorgänge, die über die Seite "Ergebnisquellen verwalten" in der Zentraladministration unterstützt werden, mit Ausnahme der Vorgänge "Formularauthentifizierung" und "Cookieauthentifizierung". Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.
Beispiele
--------------------BEISPIEL--------------------
$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 diesem Beispiel wird eine neue Ergebnisquelle auf Suchdienst-Anwendungsebene mit dem Namen "Benutzerdefinierte SharePoint-Ergebnisquelle" erstellt.
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 Subscription Edition |
-AuthenticationType
Gibt den Authentifizierungstyp der neuen Ergebnisquelle an.
Ein bestimmter Satz von Authentifizierungstypen wird für jeden Suchanbietertyp unterstützt, und wenn kein Parameter 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 Subscription Edition |
-AutoDiscover
Gibt an, ob die automatische Ermittlung des Exchange-Serverendpunkts für die neue Ergebnisquelle verwendet werden soll.
Bei Festlegung auf "true ($true)" wird die automatische Ermittlung verwendet. Wenn nicht angegeben oder auf false ($false) festgelegt ist, wird die automatische Ermittlung nicht verwendet.
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 Subscription Edition |
-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 Subscription Edition |
-Description
Gibt die Beschreibung der neuen Ergebnisquelle an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-MakeDefault
Gibt an, ob die neue Ergebnisquelle für den vom Parameter Owner angegebenen Bereich als Standard festgelegt werden soll oder nicht.
Bei Festlegen des Werts auf "true ($true)" wird die Ergebnisquelle als Standard festgelegt. Wenn nicht angegeben oder auf false festgelegt ist, wird die neue Ergebnisquelle nicht als Standard festgelegt.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Name
Gibt den Namen der neuen Ergebnisquelle an.
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: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Owner
Gibt den Suchobjektbesitzer an, der den Bereich definiert, in dem die entsprechende Ergebnisquelle erstellt wird.
| Type: | SearchObjectOwner |
| Aliases: | o |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Password
Gibt das Kennwort der Anmeldeinformationen an, die zum Herstellen einer Verbindung mit der neuen Ergebnisquelle verwendet werden sollen.
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 Subscription Edition |
-ProviderId
Gibt den Suchanbieter, der von der neuen Ergebnisquelle verwendet werden soll.
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: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-QueryTemplate
Gibt die Abfragetransformationsvorlage der neuen Ergebnisquelle an.
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 Subscription Edition |
-RemoteUrl
Gibt die Verbindungs-URL-Vorlage der neuen Ergebnisquelle an.
Muss festgelegt werden, wenn ein Suchanbieter verwendet wird, der es nutzt: Remote sharePoint Search, Remote SharePoint Personen Search, OpenSearch 1.0/1.1 und Exchange (wenn 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 Subscription Edition |
-SearchApplication
Gibt die Suchanwendung an.
Der Typ muss eine gültige GUID im Format 12345678-90ab-cdef-1234-567890bcdefgh sein; ein gültiger Suchanwendungsname, z. B. SearchApp1, oder eine Instanz eines gültigen SearchServiceApplication-Objekts.
| Type: | SearchServiceApplicationPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SsoId
Gibt die Secure Store-ID des Reverseproxyzertifikats an, die zum Herstellen einer Verbindung mit der neuen Ergebnisquelle verwendet werden soll.
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 Subscription Edition |
-UserName
Gibt den Benutzernamen der Anmeldeinformationen an, die zum Herstellen einer Verbindung mit der neuen Ergebnisquelle verwendet werden sollen.
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 Subscription Edition |
-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 Subscription Edition |