Set-SPEnterpriseSearchResultSource
Définit les propriétés d'une origine des résultats.
Syntaxe
Default (Par défaut)
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 via 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 des résultats et l’identité de la source du résultat est spécifiée en tant que source de résultat instance. 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
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 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.
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 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.
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
Indique une description de l’origine des résultats.
Si le paramètre n’est pas spécifié, la valeur est inchangée.
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 |
-Identity
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriétés du paramètre
| Type: | ResultSourcePipeBind |
| 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 |
-MakeDefault
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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 pas le nom ou l’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).
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
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.
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 |
-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 disponible.
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: | False |
| 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 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).
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 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).
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: | False |
| 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 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}.
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 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.
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 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.
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: | False |
| 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 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 (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 à 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).
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.