New-SPEnterpriseSearchResultSource

Crée une origine des résultats.

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>]

Description

Cette cmdlet crée une origine des résultats. Les origines des résultats vous permettent de limiter les résultats de la recherche et de fédérer des requêtes vers des sources externes, telles que des moteurs de recherche Internet. Après avoir défini une origine des résultats, configurez des composants WebPart de recherche et des actions de règle de requête pour l’utiliser. Les origines des résultats remplacent les étendues de recherche, qui sont à présent déconseillées. Cette applet de commande prend en charge les mêmes opérations de création que celles prises en charge via la page « Gérer les sources de résultats » dans l’Administration centrale, à l’exception des opérations « Authentification par formulaire » et « Authentification par cookie ». Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

------------------EXEMPLE------------------

$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"

Cet exemple crée une source de résultats au niveau de l’application de service de recherche, nommée « Source de résultats SharePoint personnalisée ».

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

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

Spécifie le type d’authentification de la nouvelle origine des résultats.

Un ensemble spécifique de types d’authentification est pris en charge pour chaque type de fournisseur de recherche et, si le paramètre n’est pas spécifié, le type d’authentification sera basé par défaut sur le type de fournisseur de recherche.

Cette cmdlet prend en charge l’ensemble de mécanismes d’authentification et de types correspondants suivant : authentification SharePoint par défaut (FederationAuthType.LocalNTAuth), authentification de base (FederationAuthType.SingleAccountBasicAuth - indiquez un nom d’utilisateur et un mot de passe), authentification SharePoint à distance par défaut (FederationAuthType.PerUserBasicAuth), authentification unique (FederationAuthType.SSO - nécessite que SsoId soit spécifié), anonyme (FederationAuthType.Anonymous), authentification Digest (FederationAuthType.SingleAccountDigest - indiquez un nom d’utilisateur et un mot de passe), identité du pool d’applications NTLM (FederationAuthType.ApplicationPoolIdentity), nom d’utilisateur et mot de passe NTLM (FederationAuthType.SingleAccountNTLM - indiquez un nom d’utilisateur et un mot de passe).

En cas d’utilisation d’un fournisseur de recherche SharePoint local/de recherche de personnes SharePoint local FederationAuthType.LocalNTAuth (par défaut) et FederationAuthType.SingleAccountBasicAuth sont pris en charge.

En cas d’utilisation d’un fournisseur de recherche SharePoint distant/de recherche de personnes SharePoint distant, FederationAuthType.PerUserBasicAuth (par défaut) et FederationAuthType.SSO sont pris en charge.

En cas d’utilisation du fournisseur de recherche OpenSearch 1.0/1.1, les types d’authentification suivants sont pris en charge : FederationAuthType.Anonymous (par défaut), FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest, FederationAuthType.SingleAccountNTLM et FederationAuthType.ApplicationPoolIdentity.

Tous les types d’authentification sont répertoriés dans l’énumération 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

Spécifie s’il faut utiliser la découverte automatique du point de terminaison de serveur Exchange pour la nouvelle source de résultats.

La définition de la valeur sur true ($true) indique que la découverte automatique doit être utilisée. Si elle n’est pas spécifiée ou si elle est définie sur false ($false), la découverte automatique ne sera pas utilisée.

Applicable uniquement en cas d’utilisation d’un fournisseur de recherche 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

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : 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

Spécifie la description de la nouvelle origine des résultats.

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

-MakeDefault

Indique si la nouvelle origine des résultats doit être définie comme valeur par défaut pour l’étendue spécifiée par le paramètre Owner.

La définition de la valeur sur true ($true) indique que l’origine des résultats doit être définie comme valeur par défaut. Si elle n’est pas spécifiée ou si elle n’est pas définie sur false, la nouvelle source de résultat n’est pas définie par défaut.

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

Spécifie le nom de la nouvelle origine des résultats.

Les noms doivent être uniques à chaque niveau administratif.

Par exemple, deux origines des résultats dans un site ne peuvent pas partager le même nom, mais ils peuvent avoir un nom dans un site et un fourni par la collection de sites.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Owner

Spécifie le propriétaire de l’objet de recherche qui définit l’étendue à laquelle l’origine des résultats correspondante est créée.

Type:SearchObjectOwner
Aliases:o
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Password

Spécifie le mot de passe des informations d’identification de l’utilisateur à utiliser pour la connexion à la nouvelle origine des résultats.

Utilisé lorsque le type d’authentification (AuthenticationType) est défini sur un type qui utilise des informations d’identification d’utilisateur (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest ou 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

Spécifie le fournisseur de recherche que doit utiliser la nouvelle origine des résultats.

Spécifié en tant que GUID ou chaîne de GUID, qui doit être l’un des éléments suivants : FA947043-6046-4F97-9714-40D4C113963D (Recherche SharePoint locale), E4BCC058-F133-4425-8FFC-1D70596FFD33 (Recherche de personnes SharePoint locale), 1E0C8601-2E5D-4CCB-9561-53743B5DBDE7 (Recherche SharePoint distante), E377CAAA-FCAF-4a1b-B7A1-E69A506A07AA (Recherche de personnes SharePoint distante), 3A17E140-1574-4093-BAD6-E19CDF1C0122 (Recherche Exchange), 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-QueryTemplate

Spécifie le modèle de transformation de requête de la nouvelle origine des résultats.

Les requêtes entrantes sont modifiées selon le modèle, pour utiliser ce nouveau texte de requête à la place. Incluez la requête entrante dans le nouveau texte à l’aide de la variable de requête « {searchTerms} ». Utilisez-la pour limiter les résultats.

Par exemple, pour renvoyer uniquement des éléments OneNote, définissez le nouveau texte sur « {searchTerms} fileextension=one ». Une requête entrante « sharepoint » devient ainsi « sharepoint fileextension=one ». La valeur par défaut est {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

Spécifie le modèle de l’URL de connexion de la nouvelle origine des résultats.

Doit être défini lors de l’utilisation d’un moteur de recherche qui l’utilise : Recherche SharePoint distante, Recherche sharePoint Personnes distante, OpenSearch 1.0/1.1 et Exchange (si la découverte automatique n’est pas activée).

Le paramètre est ignoré en cas d’utilisation d’autres fournisseurs de recherche.

Pour Recherche SharePoint distante/Recherche de personnes SharePoint distante, spécifiez l’adresse de la collection de sites racine de la batterie SharePoint distante.

Pour OpenSearch 1.0/1.1, spécifiez l’URL de l’origine OpenSearch.

Incluez la requête dans l’URL à l’aide de la variable de requête « {searchTerms} », qui sera automatiquement remplacée par la requête. Pour Exchange, spécifiez l’URL du service web Exchange à partir de laquelle récupérer les résultats.

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

Spécifie l’application de recherche.

Le type doit être un GUID valide, au format 12345678-90ab-cdef-1234-567890bcdefgh ; un nom d’application de recherche valide, par exemple SearchApp1, ou une instance d’un objet SearchServiceApplication valide.

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

-SsoId

Spécifie l’ID du magasin sécurisé du certificat de proxy inverse à utiliser pour se connecter à la nouvelle source de résultat.

Doit être spécifié si le type d’authentification (AuthenticationType) est défini sur FederationAuthType.SSO (authentification unique).

Si vous vous connectez à votre intranet via un proxy inverse, entrez l’identificateur SSO de l’entrée Authentification unique qui stocke le certificat utilisé pour l’authentification sur le proxy inverse.

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

Spécifie le nom d’utilisateur des informations d’identification de l’utilisateur à utiliser pour la connexion à la nouvelle origine des résultats.

Utilisé lorsque le type d’authentification (AuthenticationType) est défini sur un type qui utilise des informations d’identification d’utilisateur (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest ou 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

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, entrez la commande suivante : 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