Merge pull request MicrosoftDocs#623 from tseward/patch-309

Update Set-SPEnterpriseSearchResultSource.md

Author: Techwriter40

sharepoint/sharepoint-ps/sharepoint-server/Set-SPEnterpriseSearchResultSource.md

@@ -33,10 +33,10 @@ The result source cannot be a built-in source (a built-in source has the BuiltIn
 
 ### --------------------EXAMPLE 1---------------------
 ```
-C:\PS>$ssa = Get-SPEnterpriseSearchServiceApplication -Identity "Search Service Application"
-$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"
+PS C:\>$ssa = Get-SPEnterpriseSearchServiceApplication
+PS C:\>$owner = Get-SPEnterpriseSearchOwner -Level SSA
+PS C:\>$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
+PS C:\>Set-SPEnterpriseSearchResultSource -Identity $customResultSource -Name "Basic SharePoint Result Source"
 ```
 
 This example updates the name of the result source and the identity of the result source is specified as a result source instance. 
@@ -45,10 +45,10 @@ SearchApplication and Owner are not required for this update operation.
 
 ### --------------------EXAMPLE 2---------------------
 ```
-C:\PS>$ssa = Get-SPEnterpriseSearchServiceApplication -Identity "Search Service Application"
-$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"
+PS C:\>$ssa = Get-SPEnterpriseSearchServiceApplication
+PS C:\>$owner = Get-SPEnterpriseSearchOwner -Level SSA
+PS C:\>$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
+PS C:\>Set-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -Identity "Custom SharePoint Result Source" -Description "A custom SharePoint Result Source for demonstration purposes"
 ```
 
 This example updates the description of the result source and the identity of the result source is specified by name.
@@ -80,13 +80,18 @@ Accept wildcard characters: False
 ```
 
 ### -AuthenticationType
-Specifies an authentication type for the result source.
-If parameter is not specified, the value is unchanged.
+Specifies an authentication type for the result source. If parameter is not specified, the value is unchanged.
+
 A specific set of authentication types are supported for each search provider type and if parameter is not specified, the authentication type will default based on search provider type.
+
 This cmdlet supports the following set of authentication mechanisms and corresponding types: Default SharePoint Authentication (FederationAuthType.LocalNTAuth), Basic Authentication (FederationAuthType.SingleAccountBasicAuth - specify UserName and Password), Default Remote SharePoint Authentication (FederationAuthType.PerUserBasicAuth), Single Sign On (FederationAuthType.SSO - requires SsoId to be specified), Anonymous (FederationAuthType.Anonymous), Digest Authentication (FederationAuthType.SingleAccountDigest - specify UserName and Password), NTLM Application Pool Identity (FederationAuthType.ApplicationPoolIdentity), NTLM User Name and Password (FederationAuthType.SingleAccountNTLM - specify UserName and Password).
+
 When using a Local SharePoint Search/Local SharePoint People Search provider, then FederationAuthType.LocalNTAuth (default) and FederationAuthType.SingleAccountBasicAuth are supported.
+
 When using a Remote SharePoint Search/Remote SharePoint People Search provider, then FederationAuthType.PerUserBasicAuth (default) and FederationAuthType.SSO are supported.
+
 When using OpenSearch 1.0/1.1 search provider, then the following authentication types are supported: FederationAuthType.Anonymous (default), FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest, FederationAuthType.SingleAccountNTLM, and FederationAuthType.ApplicationPoolIdentity. 
+
 All authentication types are listed in the enum FederationAuthType.
 
 
@@ -105,8 +110,11 @@ Accept wildcard characters: False
 
 ### -AutoDiscover
 Specifies whether to use automatic discovery of the Exchange server endpoint for the result source.
+
 Setting value to true ($true) states that automatic discovery should be used.
+
 If parameter is not specified, the value is unchanged.
+
 Only applicable when using an Exchange search provider.
 
 
@@ -143,6 +151,7 @@ Accept wildcard characters: False
 
 ### -Description
 Specifies a description for the result source.
+
 If parameter is not specified, the value is unchanged.
 
 
@@ -161,6 +170,7 @@ Accept wildcard characters: False
 
 ### -Identity
 Specifies the result source to update.
+
 The type must be a valid GUID string, in the form 12345678-90ab-cdef-1234-567890bcdefgh; a valid name of a result source (for example, "Custom SharePoint Result Source"); or an instance of a valid Source object.
 
 
@@ -179,10 +189,14 @@ Accept wildcard characters: False
 
 ### -MakeDefault
 Specifies whether the result source should be set as default result source or not, for the scope specified by the Owner parameter.
+
 If parameter is not specified, the default result source will not change.
+
 Setting value to true ($true) states that the result source should be set as default.
+
 Setting value to false ($false) states that the result source should not be set as default and in this case, if the result source to update is currently the default, the original default result source ("Local SharePoint Results") will be set as default again. 
-        Tip: Use instance, not name or GUID string Id, as Identity when using Makedefault, to clearly specify that Owner is only to be used for specifying the level where the result source should be set as default (if value is true) or where the default should be reset to original (if value is false).
+
+Tip: Use instance, not name or GUID string Id, as Identity when using Makedefault, to clearly specify that Owner is only to be used for specifying the level where the result source should be set as default (if value is true) or where the default should be reset to original (if value is false).
 
 
 ```yaml
@@ -200,8 +214,11 @@ Accept wildcard characters: False
 
 ### -Name
 Specifies a name for the result source.
+
 If parameter is not specified, the value is unchanged.
+
 Names must be unique at each administrative level.
+
 For example, two result sources in a site cannot share a name, but one in a site and one provided by the site collection can.
 
 
@@ -237,7 +254,9 @@ Accept wildcard characters: False
 
 ### -Password
 Specifies the password of the user credentials to use to connect to the result source.
+
 If parameter is not specified, the value is unchanged.
+
 Used when authentication type (AuthenticationType) is set to a type that consumes user credentials (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest or FederationAuthType.SingleAccountNTLM).
 
 
@@ -256,7 +275,9 @@ Accept wildcard characters: False
 
 ### -ProviderId
 Specifies a search provider to be used by the result source.
+
 If parameter is not specified, the value is unchanged.
+
 Is specified as a Guid or GUID string, which must be one of the following: FA947043-6046-4F97-9714-40D4C113963D (Local SharePoint Search), E4BCC058-F133-4425-8FFC-1D70596FFD33 (Local SharePoint People Search), 1E0C8601-2E5D-4CCB-9561-53743B5DBDE7 (Remote SharePoint Search), E377CAAA-FCAF-4a1b-B7A1-E69A506A07AA (Remote SharePoint People Search), 3A17E140-1574-4093-BAD6-E19CDF1C0122 (Exchange Search), 3A17E140-1574-4093-BAD6-E19CDF1C0121 (OpenSearch 1.0/1.1).
 
 
@@ -275,10 +296,13 @@ Accept wildcard characters: False
 
 ### -QueryTemplate
 Specifies the query transformation template of the result source.
+
 If parameter is not specified, the value is unchanged.
+
 Incoming queries are changed according to the template, to use this new query text instead.
 Include the incoming query in the new text by using the query variable "{searchTerms}".
 Use this to scope results.
+
 For example, to only return OneNote items, set the new text to "{searchTerms} fileextension=one".
 Then, an incoming query "sharepoint" becomes "sharepoint fileextension=one".
 Default value is {searchTerms}.
@@ -299,11 +323,17 @@ Accept wildcard characters: False
 
 ### -RemoteUrl
 Specifies a connection URL template for the result source.
+
 If parameter is not specified, the value is unchanged.
+
 Must be set when using a search provider that consumes it: Remote SharePoint Search, Remote SharePoint People Search, OpenSearch 1.0/1.1, and Exchange (if AutoDiscover is not turned on).
+
 When using other search providers the parameter is ignored. 
+
 For Remote SharePoint Search/Remote SharePoint People Search, specify the address of the root site collection of the remote SharePoint farm.
+
 For OpenSearch 1.0/1.1, specify the URL of the OpenSearch source.
+
 Include the query in the URL by using the query variable "{searchTerms}", which will be automatically replaced with the query.
 For Exchange, specify the Exchange EWS URL from which to retrieve results.
 
@@ -323,6 +353,7 @@ Accept wildcard characters: False
 
 ### -SearchApplication
 Specifies the search application.
+
 The type must be a valid GUID, in the form 12345678-90ab-cdef-1234-567890bcdefgh; a valid search application name (for example, SearchApp1); or an instance of a valid SearchServiceApplication object.
 
 
@@ -341,8 +372,11 @@ Accept wildcard characters: False
 
 ### -SsoId
 Specifies the reverse proxy certificate Secure Store Id to use to connect to the result source.
+
 If parameter is not specified, the value is unchanged.
+
 Must be specified if authentication type (AUthenticationType) is set to FederationAuthType.SSO (Single Sign On).
+
 If you are connecting to your intranet through a reverse proxy, enter the SSO Id of the Single Sign On entry which stores the certificate used to authenticate against the reverse proxy.
 
 
@@ -361,7 +395,9 @@ Accept wildcard characters: False
 
 ### -UserName
 Specifies the user name of the user credentials to use to connect to the result source.
+
 If parameter is not specified, the value is unchanged.
+
 Used when authentication type (AuthenticationType) is set to a type that consumes user credentials (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest or FederationAuthType.SingleAccountNTLM).