en-US/about_SPSearchResultSource.help.txt

.NAME
    SPSearchResultSource
 
# Description
     
    **Type:** Distributed
    **Requires CredSSP:** No
     
    This resource is used to configure search result sources in the SharePoint
    search service application. Result sources can be configured to be of the
    following provider types:
     
    * Exchange Search Provider
    * Local People Provider
    * Local SharePoint Provider
    * OpenSearch Provider
    * Remote People Provider
    * Remote SharePoint Provider
     
    > **Important:**
    > The above provider types are specific to the used localized version of SharePoint.
    > Please make sure you use the correct localized values. Use the below script to
    > check of all possible values.
     
    The default value for the Ensure parameter is Present. When not specifying this
    parameter, the result source is created.
     
    To define a result source as global, use the value 'SSA' as the ScopeName
    value.
     
    ## Script
     
    ``` PowerShell
    $serviceApp = Get-SPEnterpriseSearchServiceApplication -Identity "SearchServiceAppName"
     
    $fedManager = New-Object Microsoft.Office.Server.Search.Administration.Query.FederationManager($serviceApp)
    $providers = $fedManager.ListProviders()
    $providers.Keys
    ```
 
.PARAMETER Name
    Key - String
    The name of the result source
 
.PARAMETER ScopeName
    Key - String
    Allowed values: SSA, SPSite, SPWeb
    The scope at which the Result Source will be created. Options are SSA, SPSite or SPWeb
 
.PARAMETER ScopeUrl
    Key - String
    The URI of the site where to create the result source. Leave empty to have it created globally
 
.PARAMETER SearchServiceAppName
    Required - String
    The name of the search service application to associate this result source with
 
.PARAMETER Query
    Required - String
    The query to pass to the provider source
 
.PARAMETER ProviderType
    Required - String
    The provider type to use for the result source
 
.PARAMETER ConnectionUrl
    Write - String
    The URI to connect to the remote location
 
.PARAMETER Ensure
    Write - string
    Allowed values: Present, Absent
    Present if the result source should exist, absent if it should not
 
.PARAMETER InstallAccount
    Write - String
    POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5
 
.EXAMPLE 1
 
This example shows how to create a remote sharepoint search result source
 
    Configuration Example
    {
        param(
            [Parameter(Mandatory = $true)]
            [PSCredential]
            $SetupAccount
        )
        Import-DscResource -ModuleName SharePointDsc
 
        node localhost {
            SPSearchResultSource RemoteSharePointFarm
            {
                Name = "External SharePoint results"
                ScopeName = "SPSite"
                ScopeUrl = "https://SharePoint.contoso.com"
                SearchServiceAppName = "Search Service Application"
                Query = "{searchTerms}"
                ProviderType = "Remote SharePoint Provider"
                PsDscRunAsCredential = $SetupAccount
            }
        }
    }