New-SPEnterpriseSearchResultSource
Crée une origine des résultats.
Syntaxe
Default (Par défaut)
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 par le biais de la page « Gérer les sources de résultats » dans l’Administration centrale, à l’exception des opérations « Form Authentication » et « Cookie Authentication ». 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
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | SPAssignmentCollection |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AuthenticationType
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | FederationAuthType |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AutoDiscover
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Vous demande une confirmation avant d’exécuter la commande.
Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Description
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie la description de la nouvelle origine des résultats.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MakeDefault
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Owner
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | SearchObjectOwner |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | o |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Password
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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).
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ProviderId
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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).
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-QueryTemplate
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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}.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RemoteUrl
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SearchApplication
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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 un instance d’un objet SearchServiceApplication valide.
Propriétés du paramètre
| Type: | SearchServiceApplicationPipeBind |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SsoId
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-UserName
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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).
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.