DSCResources/MSFT_SPSearchCrawlMapping/MSFT_SPSearchCrawlMapping.psm1
|
function Get-TargetResource { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( [Parameter(Mandatory = $true)] [System.String] $ServiceAppName, [Parameter(Mandatory = $true)] [System.String] $Url, [Parameter(Mandatory = $true)] [System.String] $Target, [Parameter()] [ValidateSet("Present","Absent")] [System.String] $Ensure = "Present", [Parameter()] [System.Management.Automation.PSCredential] $InstallAccount ) Write-Verbose -Message "Getting Search Crawl Mapping for '$Url'" $result = Invoke-SPDSCCommand -Credential $InstallAccount ` -Arguments $PSBoundParameters ` -ScriptBlock { $params = $args[0] $searchApp = Get-SPEnterpriseSearchServiceApplication -Identity $params.ServiceAppName if($null -eq $searchApp) { Write-Verbose -Message "Search Service Application $($params.ServiceAppName) not found" $returnVal = @{ ServiceAppName = "" Url = $params.Url Target = "" Ensure = "Absent" InstallAccount = $params.InstallAccount } return $returnVal } $mappings = $searchApp | Get-SPEnterpriseSearchCrawlMapping if($null -eq $mappings) { Write-Verbose -Message "Search Service Application $($params.ServiceAppName) has no mappings" $returnVal = @{ ServiceAppName = $params.ServiceAppName Url = $params.Url Target = "" Ensure = "Absent" InstallAccount = $params.InstallAccount } return $returnVal } $mapping = $mappings | Where-Object -FilterScript { $_.Source -eq "$($params.Url)" } | Select-Object -First 1 if($null -eq $mapping) { Write-Verbose "Search Service Application $($params.ServiceAppName) has no matching mapping" $returnVal = @{ ServiceAppName = $params.ServiceAppName Url = $params.Url Target = "" Ensure = "Absent" InstallAccount = $params.InstallAccount } return $returnVal } else { Write-Verbose "Search Service Application $($params.ServiceAppName) has a matching mapping" $returnVal = @{ ServiceAppName = $params.ServiceAppName Url = $mapping.Source Target = $mapping.Target Ensure = "Present" InstallAccount = $params.InstallAccount } return $returnVal } } return $result } function Set-TargetResource { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [System.String] $ServiceAppName, [Parameter(Mandatory = $true)] [System.String] $Url, [Parameter(Mandatory = $true)] [System.String] $Target, [Parameter()] [ValidateSet("Present","Absent")] [System.String] $Ensure = "Present", [Parameter()] [System.Management.Automation.PSCredential] $InstallAccount ) Write-Verbose -Message "Setting Search Crawl Mapping Rule '$Url'" $result = Get-TargetResource @PSBoundParameters if($result.Ensure -eq "Absent" -and $Ensure -eq "Present") { Write-Verbose "Adding the Crawl Mapping '$Url'" Invoke-SPDSCCommand -Credential $InstallAccount ` -Arguments $PSBoundParameters ` -ScriptBlock { $params = $args[0] $searchApp = Get-SPEnterpriseSearchServiceApplication -Identity $params.ServiceAppName if($null -eq $searchApp) { throw [Exception] "The Search Service Application does not exist" } else { New-SPEnterpriseSearchCrawlMapping -SearchApplication $searchApp -Url $params.Url -Target $params.Target } } } if($result.Ensure -eq "Present" -and $Ensure -eq "Present") { Write-Verbose "Updating the Crawl Mapping '$Url'" Invoke-SPDSCCommand -Credential $InstallAccount ` -Arguments $PSBoundParameters ` -ScriptBlock { $params = $args[0] $searchApp = Get-SPEnterpriseSearchServiceApplication -Identity $params.ServiceAppName $mappings = $searchApp | Get-SPEnterpriseSearchCrawlMapping $mapping = $mappings | Where-Object -FilterScript { $_.Source -eq $params.Url } | Select-Object -First 1 $mapping | Remove-SPEnterpriseSearchCrawlMapping New-SPEnterpriseSearchCrawlMapping -SearchApplication $searchApp -Url $params.Url -Target $params.Target } } if ($result.Ensure -eq "Present" -and $Ensure -eq "Absent") { Write-Verbose "Removing the Crawl Mapping '$Url'" Invoke-SPDSCCommand -Credential $InstallAccount ` -Arguments $PSBoundParameters ` -ScriptBlock { $params = $args[0] $searchapp = Get-SPEnterpriseSearchServiceApplication -Identity $params.ServiceAppName $mappings = $searchApp | Get-SPEnterpriseSearchCrawlMapping $mapping = $mappings | Where-Object -FilterScript { $_.Source -eq $params.Url } | Select-Object -First 1 $mapping | Remove-SPEnterpriseSearchCrawlMapping } } } function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( [Parameter(Mandatory = $true)] [System.String] $ServiceAppName, [Parameter(Mandatory = $true)] [System.String] $Url, [Parameter(Mandatory = $true)] [System.String] $Target, [Parameter()] [ValidateSet("Present","Absent")] [System.String] $Ensure = "Present", [Parameter()] [System.Management.Automation.PSCredential] $InstallAccount ) Write-Verbose -Message "Testing Search Crawl Mapping for '$Url'" $PSBoundParameters.Ensure = $Ensure $CurrentValues = Get-TargetResource @PSBoundParameters if($Ensure -eq "Present") { return Test-SPDscParameterState -CurrentValues $CurrentValues ` -DesiredValues $PSBoundParameters ` -ValuesToCheck @("ServiceAppName","Url","Target","Ensure") } else { return Test-SPDscParameterState -CurrentValues $CurrentValues ` -DesiredValues $PSBoundParameters ` -ValuesToCheck @("Ensure") } } Export-ModuleMember -Function *-TargetResource |