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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition