Set-SPEnterpriseSearchResultSource
Définit les propriétés d'une origine des résultats.
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>] Description
Cette cmdlet met à jour les propriétés d’une origine des résultats créée par l’utilisateur. Cette applet de commande prend en charge les mêmes opérations de mise à jour que celles prises en charge par le biais de la page « Gérer les sources de résultats » dans l’Administration centrale. L’origine des résultats ne peut pas être une origine prédéfinie (pour une origine prédéfinie, la propriété BuiltIn a la valeur true) pour toute opération de mise à jour autre que la modification de l’origine des résultats par défaut à l’aide du paramètre MakeDefault. 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 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"Cet exemple met à jour le nom de la source du résultat et l’identité de la source du résultat est spécifiée en tant qu’instance de source de résultat. SearchApplication et Owner ne sont pas requis pour cette opération de mise à jour.
--------------------EXEMPLE 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"Cet exemple met à jour la description de la source du résultat et l’identité de la source du résultat est spécifiée par son nom.
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 un type d’authentification pour la source du résultat. Si le paramètre n’est pas spécifié, la valeur est inchangée.
Un ensemble spécifique de types d’authentification est pris en charge pour chaque type de moteur de recherche et si le paramètre n’est pas spécifié, le type d’authentification est défini par défaut en fonction du 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 source du résultat.
La définition de la valeur sur true ($true) indique que la découverte automatique doit être utilisée.
Si le paramètre n’est pas spécifié, la valeur est inchangé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
Indique une description de l’origine des résultats.
Si le paramètre n’est pas spécifié, la valeur est inchangée.
| 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
Spécifie l’origine des résultats à mettre à jour.
Le type doit correspondre à une chaîne de GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh, un nom d’origine des résultats valide (par exemple, « Origine des résultats SharePoint personnalisée ») ou une instance d’un objet Source valide.
| 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
Spécifie si la source de résultat doit être définie comme source de résultats par défaut ou non, pour l’étendue spécifiée par le paramètre Owner.
Si le paramètre n’est pas spécifié, la source de résultats par défaut ne change pas.
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.
La définition de la valeur false ($false) indique que la source des résultats ne doit pas être définie comme source par défaut et, dans ce cas, si la source de résultat à mettre à jour est actuellement la valeur par défaut, la source de résultats par défaut d’origine (« Résultats SharePoint locaux ») est à nouveau définie comme valeur par défaut.
Conseil : utilisez instance, et non nom ou ID de chaîne GUID, comme Identité lors de l’utilisation de Makedefault, pour spécifier clairement que Owner doit uniquement être utilisé pour spécifier le niveau où la source du résultat doit être définie comme valeur par défaut (si la valeur est true) ou où la valeur par défaut doit être réinitialisée à l’origine (si la valeur est false).
| 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
Indique le nom de l’origine des résultats.
Si le paramètre n’est pas spécifié, la valeur est inchangée.
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: | False |
| 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 disponible.
| 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
Spécifie le mot de passe des informations d’identification de l’utilisateur à utiliser pour se connecter à l’origine des résultats.
Si le paramètre n’est pas spécifié, la valeur est inchangée.
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 un fournisseur de recherche destiné à être utilisé par l’origine des résultats.
Si le paramètre n’est pas spécifié, la valeur est inchangée.
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: | False |
| 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 l’origine des résultats.
Si le paramètre n’est pas spécifié, la valeur est inchangée.
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 un modèle d’URL de connexion pour l’origine des résultats.
Si le paramètre n’est pas spécifié, la valeur est inchangée.
Doit être défini en cas d’utilisation d’un fournisseur de recherche qui l’utilise : Recherche SharePoint distante, Recherche de personnes SharePoint distante, OpenSearch 1.0/1.1 et Exchange (si le paramètre AutoDiscover n’est pas activé).
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 correspondre à 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: | False |
| 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 de banque d’informations sécurisée du certificat proxy inverse à utiliser pour la connexion à l’origine des résultats.
Si le paramètre n’est pas spécifié, la valeur est inchangée.
Doit être spécifié si le type d’authentification (AUthenticationType) est défini sur FederationAuthType.SSO (Single Sign On).
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 à l’origine des résultats.
Si le paramètre n’est pas spécifié, la valeur est inchangée.
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 |