DSCResources/MSFT_SPIncomingEmailSettings/MSFT_SPIncomingEmailSettings.psm1
|
function Get-TargetResource { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( [Parameter(Mandatory = $true)] [ValidateSet("Yes")] [System.String] $IsSingleInstance, [Parameter(Mandatory = $true)] [ValidateSet("Present", "Absent")] [System.String] $Ensure, [Parameter()] [System.Boolean] $UseAutomaticSettings, [Parameter()] [ValidateSet("Yes", "No", "Remote")] [System.String] $UseDirectoryManagementService, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $RemoteDirectoryManagementURL, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $ServerAddress, [Parameter()] [System.Boolean] $DLsRequireAuthenticatedSenders, [Parameter()] [System.Boolean] $DistributionGroupsEnabled, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $ServerDisplayAddress, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $DropFolder ) Write-Verbose -Message "Getting SharePoint Incoming Email Settings" $result = Invoke-SPDscCommand -ScriptBlock { $spEmailServiceInstance = (Get-SPServiceInstance | Where-Object { $_.GetType().FullName -eq "Microsoft.SharePoint.Administration.SPIncomingEmailServiceInstance" }) | Select-Object -First 1 $spEmailService = $spEmailServiceInstance.service # some simple error checking, just incase we didn't capture the service for some reason if ($null -eq $spEmailService) { Write-Verbose "Error getting the SharePoint Incoming Email Service" return @{ IsSingleInstance = "Yes" Ensure = $null UseAutomaticSettings = $null UseDirectoryManagementService = $null RemoteDirectoryManagementURL = $null ServerAddress = $null DLsRequireAuthenticatedSenders = $null DistributionGroupsEnabled = $null ServerDisplayAddress = $null DropFolder = $null } } # determine if incoming email is enabled if ($spEmailService.Enabled -eq $true) { $ensure = "Present" } else { return @{ IsSingleInstance = "Yes" Ensure = "Absent" UseAutomaticSettings = $null UseDirectoryManagementService = $null RemoteDirectoryManagementURL = $null ServerAddress = $null DLsRequireAuthenticatedSenders = $null DistributionGroupsEnabled = $null ServerDisplayAddress = $null DropFolder = $null } } #determine directory service integration mode if ($spEmailService.UseDirectoryManagementService -eq $false) { $useDirectoryManagementService = "No" } elseif ($spEmailService.UseDirectoryManagementService -eq $true -and $spEmailService.RemoteDirectoryManagementService -eq $false) { $useDirectoryManagementService = "Yes" $remoteDirectoryManagementURL = $null } elseif ($spEmailService.UseDirectoryManagementService -eq $true -and $spEmailService.RemoteDirectoryManagementService -eq $true) { $useDirectoryManagementService = "Remote" $remoteDirectoryManagementURL = $spEmailService.DirectoryManagementServiceUrl } return @{ IsSingleInstance = "Yes" Ensure = $ensure UseAutomaticSettings = $spEmailService.UseAutomaticSettings UseDirectoryManagementService = $useDirectoryManagementService RemoteDirectoryManagementURL = $remoteDirectoryManagementURL ServerAddress = $spEmailService.ServerAddress DLsRequireAuthenticatedSenders = $spEmailService.DLsRequireAuthenticatedSenders DistributionGroupsEnabled = $spEmailService.DistributionGroupsEnabled ServerDisplayAddress = $spEmailService.ServerDisplayAddress DropFolder = $spEmailService.DropFolder } } return $result } function Set-TargetResource { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [ValidateSet("Yes")] [System.String] $IsSingleInstance, [Parameter(Mandatory = $true)] [ValidateSet("Present", "Absent")] [System.String] $Ensure, [Parameter()] [System.Boolean] $UseAutomaticSettings, [Parameter()] [ValidateSet("Yes", "No", "Remote")] [System.String] $UseDirectoryManagementService, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $RemoteDirectoryManagementURL, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $ServerAddress, [Parameter()] [System.Boolean] $DLsRequireAuthenticatedSenders, [Parameter()] [System.Boolean] $DistributionGroupsEnabled, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $ServerDisplayAddress, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $DropFolder ) Write-Verbose -Message "Setting SharePoint Incoming Email Settings" if ($Ensure -eq 'Present') { if (-not $PSBoundParameters.containskey("UseAutomaticSettings")) { $message = "UseAutomaticSettings parameter must be specified when enabling incoming email." Add-SPDscEvent -Message $message ` -EntryType 'Error' ` -EventID 100 ` -Source $MyInvocation.MyCommand.Source throw $message } if (-not $PSBoundParameters.containskey("ServerDisplayAddress")) { $message = "ServerDisplayAddress parameter must be specified when enabling incoming email" Add-SPDscEvent -Message $message ` -EntryType 'Error' ` -EventID 100 ` -Source $MyInvocation.MyCommand.Source throw $message } if (($PSBoundParameters.UseDirectoryManagementService -eq 'Remote' -and $null -eq $PSBoundParameters.RemoteDirectoryManagementURL) ` -or ($PSBoundParameters.containskey('RemoteDirectoryManagementURL') -and $PSBoundParameters.UseDirectoryManagementService -ne 'Remote')) { $message = "RemoteDirectoryManagementURL must be specified only when UseDirectoryManagementService is set to 'Remote'" Add-SPDscEvent -Message $message ` -EntryType 'Error' ` -EventID 100 ` -Source $MyInvocation.MyCommand.Source throw $message } if ($PSBoundParameters.UseAutomaticSettings -eq $true -and $PSBoundParameters.containskey("DropFolder")) { $message = "DropFolder parameter is not valid when using Automatic Mode" Add-SPDscEvent -Message $message ` -EntryType 'Error' ` -EventID 100 ` -Source $MyInvocation.MyCommand.Source throw $message } if ($PSBoundParameters.UseAutomaticSettings -eq $false -and (-not $PSBoundParameters.containskey("DropFolder"))) { $message = "DropFolder parameter must be specified when not using Automatic Mode" Add-SPDscEvent -Message $message ` -EntryType 'Error' ` -EventID 100 ` -Source $MyInvocation.MyCommand.Source throw $message } } Invoke-SPDscCommand -Arguments @($PSBoundParameters, $MyInvocation.MyCommand.Source) ` -ScriptBlock { $params = $args[0] $eventSource = $args[1] $spEmailServiceInstance = (Get-SPServiceInstance | Where-Object { $_.GetType().FullName -eq "Microsoft.SharePoint.Administration.SPIncomingEmailServiceInstance" }) | Select-Object -First 1 $spEmailService = $spEmailServiceInstance.service #some simple error checking, just incase we didn't capture the service for some reason if ($null -eq $spEmailService) { $message = "Error getting the SharePoint Incoming Email Service" Add-SPDscEvent -Message $message ` -EntryType 'Error' ` -EventID 100 ` -Source $eventSource throw $message } if ($params.Ensure -eq "Absent") { Write-Verbose -Message "Disabling SharePoint Incoming Email" $spEmailService.Enabled = $false } else #Present { Write-Verbose -Message "Enabling SharePoint Incoming Email" $spEmailService.Enabled = $true $spEmailService.ServerDisplayAddress = $params.ServerDisplayAddress if ($params.UseAutomaticSettings -eq $true) { Write-Verbose -Message "Setting Incoming Email Service to use Automatic Settings" $spEmailService.UseAutomaticSettings = $true } else { Write-Verbose -Message "Setting Incoming Email Service to use Advanced Settings" $spEmailService.UseAutomaticSettings = $false $spEmailService.DropFolder = $params.DropFolder } #Configure Directory Management modes if ($params.UseDirectoryManagementService -eq "Yes") { $spEmailService.UseDirectoryManagementService = $true $spEmailService.RemoteDirectoryManagementService = $false } elseif ($params.UseDirectoryManagementService -eq "Remote") { $spEmailService.UseDirectoryManagementService = $true $spEmailService.RemoteDirectoryManagementService = $true $spEmailService.DirectoryManagementServiceURL = $params.RemoteDirectoryManagementURL } else { $spEmailService.UseDirectoryManagementService = $false $spEmailService.RemoteDirectoryManagementService = $false $spEmailService.DirectoryManagementServiceURL = $null } #Optional settings for Directory Management if ($params.UseDirectoryManagementService -eq "Yes" -or $params.UseDirectoryManagementService -eq "Remote") { if ($params.containskey('DLsRequireAuthenticatedSenders')) { $spEmailService.DLsRequireAuthenticatedSenders = $params.DLsRequireAuthenticatedSenders } if ($params.containskey('DistributionGroupsEnabled')) { $spEmailService.DistributionGroupsEnabled = $params.DistributionGroupsEnabled } if ($params.containskey('ServerAddress')) { $spEmailService.ServerAddress = $params.ServerAddress } } } $spEmailService.Update() } } function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( [Parameter(Mandatory = $true)] [ValidateSet("Yes")] [System.String] $IsSingleInstance, [Parameter(Mandatory = $true)] [ValidateSet("Present", "Absent")] [System.String] $Ensure, [Parameter()] [System.Boolean] $UseAutomaticSettings, [Parameter()] [ValidateSet("Yes", "No", "Remote")] [System.String] $UseDirectoryManagementService, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $RemoteDirectoryManagementURL, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $ServerAddress, [Parameter()] [System.Boolean] $DLsRequireAuthenticatedSenders, [Parameter()] [System.Boolean] $DistributionGroupsEnabled, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $ServerDisplayAddress, [Parameter()] [ValidateNotNullOrEmpty()] [System.String] $DropFolder ) Write-Verbose -Message "Testing SharePoint Incoming Email Settings" $CurrentValues = Get-TargetResource @PSBoundParameters Write-Verbose -Message "Current Values: $(Convert-SPDscHashtableToString -Hashtable $CurrentValues)" Write-Verbose -Message "Target Values: $(Convert-SPDscHashtableToString -Hashtable $PSBoundParameters)" $result = Test-SPDscParameterState -CurrentValues $CurrentValues ` -Source $($MyInvocation.MyCommand.Source) ` -DesiredValues $PSBoundParameters Write-Verbose -Message "Test-TargetResource returned $result" return $result } Export-ModuleMember -Function *-TargetResource |