SPSearchTopology

SPSearchTopology

Parameters

Parameter	Attribute	DataType	Description	Allowed Values
ServiceAppName	Key	String	The name of the search service application for this topology
Admin	Required	String[]	A list of servers that will run the admin component
Crawler	Required	String[]	A list of servers that will run the crawler component
ContentProcessing	Required	String[]	A list of servers that will run the content processing component
AnalyticsProcessing	Required	String[]	A list of servers that will run the analytics processing component
QueryProcessing	Required	String[]	A list of servers that will run the query processing component
IndexPartition	Required	String[]	A list of servers that will host the first (0) index partition
FirstPartitionDirectory	Required	String	The local directory servers will use to store the first index partition
InstallAccount	Write	String	POWERSHELL 4 ONLY: The account to run this resource as, use PsDscRunAsCredential if using PowerShell 5

Description

This resource is responsible for provisioning a search topology in to the current farm. It allows the configuration to dictate the search topology roles that the current server should be running. Any combination of roles can be specified and the topology will be upaded to reflect the current servers new roles. If this is the first server to apply topology to a farm, then at least one search index must be provided. To this end, the FirstPartitionIndex, FirstPartitionDirectory and FirstPartitionServers allow configuring where the first index partition will belong. This will behave the same as the SPSearchIndexPartition resource.

Note that for the search topology to apply correctly, the path specified for FirstPartitionDirectory needs to exist on the server that is executing this resource. For example, if the below example was executed on "Server1" it would also need to ensure that it was able to create the index path at I:. If no disk labeled I: was available on server1, this would fail, even though it will not hold an actual index component.

Examples

Example 1

This example shows how to apply a specific topology to the search service app

    Configuration Example 
    {
        param(
            [Parameter(Mandatory = $true)]
            [PSCredential]
            $SetupAccount
        )
        Import-DscResource -ModuleName SharePointDsc

        node localhost {
            SPSearchTopology LocalSearchTopology
            {
                ServiceAppName          = "Search Service Application"
                Admin                   = @("Server1","Server2")
                Crawler                 = @("Server1","Server2")
                ContentProcessing       = @("Server1","Server2")
                AnalyticsProcessing     = @("Server1","Server2")
                QueryProcessing         = @("Server3","Server4")
                PsDscRunAsCredential    = $SetupAccount
                FirstPartitionDirectory = "I:\SearchIndexes\0"
                IndexPartition          = @("Server3","Server4")
            }
        }
    }