DSCResources/MSFT_EXOHostedContentFilterPolicy/MSFT_EXOHostedContentFilterPolicy.psm1
|
function Get-TargetResource { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( [Parameter(Mandatory = $true)] [System.String] $Identity, [Parameter()] [System.String] $AddXHeaderValue, [Parameter()] [System.String] $AdminDisplayName, [Parameter()] [System.String[]] $AllowedSenderDomains = @(), [Parameter()] [System.String[]] $AllowedSenders = @(), [Parameter()] [System.String[]] $BlockedSenderDomains = @(), [Parameter()] [System.String[]] $BlockedSenders = @(), [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $BulkSpamAction = 'MoveToJmf', [Parameter()] [ValidateRange(1, 9)] [uint32] $BulkThreshold = 7, [Parameter()] [System.Boolean] $DownloadLink = $false, [Parameter()] [System.Boolean] $EnableEndUserSpamNotifications = $false, [Parameter()] [System.Boolean] $EnableLanguageBlockList = $false, [Parameter()] [System.Boolean] $EnableRegionBlockList = $false, [Parameter()] [ValidatePattern("^$|^[a-zA-Z0-9.!£#$%&'^_`{}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$")] [System.String] $EndUserSpamNotificationCustomFromAddress, [Parameter()] [System.String] $EndUserSpamNotificationCustomFromName, [Parameter()] [System.String] $EndUserSpamNotificationCustomSubject, [Parameter()] [ValidateRange(1, 15)] [uint32] $EndUserSpamNotificationFrequency = 3, [Parameter()] [ValidateSet('Default', 'English', 'French', 'German', 'Italian', 'Japanese', 'Spanish', 'Korean', 'Portuguese', 'Russian', 'ChineseSimplified', 'ChineseTraditional', 'Amharic', 'Arabic', 'Bulgarian', 'BengaliIndia', 'Catalan', 'Czech', 'Cyrillic', 'Danish', 'Greek', 'Estonian', 'Basque', 'Farsi', 'Finnish', 'Filipino', 'Galician', 'Gujarati', 'Hebrew', 'Hindi', 'Croatian', 'Hungarian', 'Indonesian', 'Icelandic', 'Kazakh', 'Kannada', 'Lithuanian', 'Latvian', 'Malayalam', 'Marathi', 'Malay', 'Dutch', 'NorwegianNynorsk', 'Norwegian', 'Oriya', 'Polish', 'PortuguesePortugal', 'Romanian', 'Slovak', 'Slovenian', 'SerbianCyrillic', 'Serbian', 'Swedish', 'Swahili', 'Tamil', 'Telugu', 'Thai', 'Turkish', 'Ukrainian', 'Urdu', 'Vietnamese')] [System.String] $EndUserSpamNotificationLanguage = 'Default', [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $HighConfidenceSpamAction = 'MoveToJmf', [Parameter()] [System.Boolean] $InlineSafetyTipsEnabled = $true, [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithBizOrInfoUrls = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithImageLinks = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithNumericIps = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithRedirectToOtherPort = 'Off', [Parameter()] [System.String[]] $LanguageBlockList = @(), [Parameter()] [System.Boolean] $MakeDefault = $false, [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamBulkMail = 'On', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamEmbedTagsInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamEmptyMessages = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamFormTagsInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamFramesInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamFromAddressAuthFail = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamJavaScriptInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamNdrBackscatter = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamObjectTagsInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamSensitiveWordList = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamSpfRecordHardFail = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamWebBugsInHtml = 'Off', [Parameter()] [System.String] $ModifySubjectValue, [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $PhishSpamAction = 'MoveToJmf', [Parameter()] [ValidateRange(1, 30)] [uint32] $QuarantineRetentionPeriod = 15, [Parameter()] [System.String[]] $RedirectToRecipients = @(), [Parameter()] [System.String[]] $RegionBlockList = @(), [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $SpamAction = 'MoveToJmf', [Parameter()] [ValidateSet('None', 'AddXHeader', 'BccMessage')] [System.String] $TestModeAction = 'None', [Parameter()] [System.String[]] $TestModeBccToRecipients = @(), [Parameter()] [System.Boolean] $PhishZapEnabled = $true, [Parameter()] [System.Boolean] $SpamZapEnabled = $true, [Parameter()] [ValidateSet('Present', 'Absent')] [System.String] $Ensure = 'Present', [Parameter()] [System.Management.Automation.PSCredential] $GlobalAdminAccount, [Parameter()] [System.String] $ApplicationId, [Parameter()] [System.String] $TenantId, [Parameter()] [System.String] $CertificateThumbprint, [Parameter()] [System.String] $CertificatePath, [Parameter()] [System.Management.Automation.PSCredential] $CertificatePassword ) Write-Verbose -Message "Getting configuration of HostedContentFilterPolicy for $Identity" #region Telemetry $ResourceName = $MyInvocation.MyCommand.ModuleName.Replace("MSFT_", "") $data = [System.Collections.Generic.Dictionary[[String], [String]]]::new() $data.Add("Resource", $ResourceName) $data.Add("Method", $MyInvocation.MyCommand) $data.Add("Principal", $GlobalAdminAccount.UserName) $data.Add("TenantId", $TenantId) Add-M365DSCTelemetryEvent -Data $data #endregion if ($Global:CurrentModeIsExport) { $ConnectionMode = New-M365DSCConnection -Platform 'ExchangeOnline' ` -InboundParameters $PSBoundParameters ` -SkipModuleReload $true } else { $ConnectionMode = New-M365DSCConnection -Platform 'ExchangeOnline' ` -InboundParameters $PSBoundParameters } $nullReturn = $PSBoundParameters $nullReturn.Ensure = 'Absent' try { $HostedContentFilterPolicies = Get-HostedContentFilterPolicy -ErrorAction Stop $HostedContentFilterPolicy = $HostedContentFilterPolicies | Where-Object -FilterScript { $_.Identity -eq $Identity } if ($null -eq $HostedContentFilterPolicy) { Write-Verbose -Message "HostedContentFilterPolicy $($Identity) does not exist." return $nullReturn } else { $result = @{ Ensure = 'Present' Identity = $Identity AddXHeaderValue = $HostedContentFilterPolicy.AddXHeaderValue AdminDisplayName = $HostedContentFilterPolicy.AdminDisplayName AllowedSenderDomains = $HostedContentFilterPolicy.AllowedSenderDomains AllowedSenders = $HostedContentFilterPolicy.AllowedSenders BlockedSenderDomains = $HostedContentFilterPolicy.BlockedSenderDomains BlockedSenders = $HostedContentFilterPolicy.BlockedSenders BulkSpamAction = $HostedContentFilterPolicy.BulkSpamAction BulkThreshold = $HostedContentFilterPolicy.BulkThreshold DownloadLink = $HostedContentFilterPolicy.DownloadLink EnableEndUserSpamNotifications = $HostedContentFilterPolicy.EnableEndUserSpamNotifications EnableLanguageBlockList = $HostedContentFilterPolicy.EnableLanguageBlockList EnableRegionBlockList = $HostedContentFilterPolicy.EnableRegionBlockList EndUserSpamNotificationCustomSubject = $HostedContentFilterPolicy.EndUserSpamNotificationCustomSubject EndUserSpamNotificationFrequency = $HostedContentFilterPolicy.EndUserSpamNotificationFrequency EndUserSpamNotificationLanguage = $HostedContentFilterPolicy.EndUserSpamNotificationLanguage HighConfidenceSpamAction = $HostedContentFilterPolicy.HighConfidenceSpamAction InlineSafetyTipsEnabled = $HostedContentFilterPolicy.InlineSafetyTipsEnabled IncreaseScoreWithBizOrInfoUrls = $HostedContentFilterPolicy.IncreaseScoreWithBizOrInfoUrls IncreaseScoreWithImageLinks = $HostedContentFilterPolicy.IncreaseScoreWithImageLinks IncreaseScoreWithNumericIps = $HostedContentFilterPolicy.IncreaseScoreWithNumericIps IncreaseScoreWithRedirectToOtherPort = $HostedContentFilterPolicy.IncreaseScoreWithRedirectToOtherPort LanguageBlockList = $HostedContentFilterPolicy.LanguageBlockList MakeDefault = $false MarkAsSpamBulkMail = $HostedContentFilterPolicy.MarkAsSpamBulkMail MarkAsSpamEmbedTagsInHtml = $HostedContentFilterPolicy.MarkAsSpamEmbedTagsInHtml MarkAsSpamEmptyMessages = $HostedContentFilterPolicy.MarkAsSpamEmptyMessages MarkAsSpamFormTagsInHtml = $HostedContentFilterPolicy.MarkAsSpamFormTagsInHtml MarkAsSpamFramesInHtml = $HostedContentFilterPolicy.MarkAsSpamFramesInHtml MarkAsSpamFromAddressAuthFail = $HostedContentFilterPolicy.MarkAsSpamFromAddressAuthFail MarkAsSpamJavaScriptInHtml = $HostedContentFilterPolicy.MarkAsSpamJavaScriptInHtml MarkAsSpamNdrBackscatter = $HostedContentFilterPolicy.MarkAsSpamNdrBackscatter MarkAsSpamObjectTagsInHtml = $HostedContentFilterPolicy.MarkAsSpamObjectTagsInHtml MarkAsSpamSensitiveWordList = $HostedContentFilterPolicy.MarkAsSpamSensitiveWordList MarkAsSpamSpfRecordHardFail = $HostedContentFilterPolicy.MarkAsSpamSpfRecordHardFail MarkAsSpamWebBugsInHtml = $HostedContentFilterPolicy.MarkAsSpamWebBugsInHtml ModifySubjectValue = $HostedContentFilterPolicy.ModifySubjectValue PhishSpamAction = $HostedContentFilterPolicy.PhishSpamAction QuarantineRetentionPeriod = $HostedContentFilterPolicy.QuarantineRetentionPeriod RedirectToRecipients = $HostedContentFilterPolicy.RedirectToRecipients RegionBlockList = $HostedContentFilterPolicy.RegionBlockList SpamAction = $HostedContentFilterPolicy.SpamAction TestModeAction = $HostedContentFilterPolicy.TestModeAction TestModeBccToRecipients = $HostedContentFilterPolicy.TestModeBccToRecipients PhishZapEnabled = $HostedContentFilterPolicy.PhishZapEnabled SpamZapEnabled = $HostedContentFilterPolicy.SpamZapEnabled GlobalAdminAccount = $GlobalAdminAccount ApplicationId = $ApplicationId CertificateThumbprint = $CertificateThumbprint CertificatePath = $CertificatePath CertificatePassword = $CertificatePassword TenantId = $TenantId } if ($HostedContentFilterPolicy.IsDefault) { $result.MakeDefault = $true } Write-Verbose -Message "Found HostedContentFilterPolicy $($Identity)" Write-Verbose -Message "Get-TargetResource Result: `n $(Convert-M365DscHashtableToString -Hashtable $result)" return $result } } catch { try { Write-Verbose -Message $_ $tenantIdValue = "" if (-not [System.String]::IsNullOrEmpty($TenantId)) { $tenantIdValue = $TenantId } elseif ($null -ne $GlobalAdminAccount) { $tenantIdValue = $GlobalAdminAccount.UserName.Split('@')[1] } Add-M365DSCEvent -Message $_ -EntryType 'Error' ` -EventID 1 -Source $($MyInvocation.MyCommand.Source) ` -TenantId $tenantIdValue } catch { Write-Verbose -Message $_ } return $nullReturn } } function Set-TargetResource { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [System.String] $Identity, [Parameter()] [System.String] $AddXHeaderValue, [Parameter()] [System.String] $AdminDisplayName, [Parameter()] [System.String[]] $AllowedSenderDomains = @(), [Parameter()] [System.String[]] $AllowedSenders = @(), [Parameter()] [System.String[]] $BlockedSenderDomains = @(), [Parameter()] [System.String[]] $BlockedSenders = @(), [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $BulkSpamAction = 'MoveToJmf', [Parameter()] [ValidateRange(1, 9)] [uint32] $BulkThreshold = 7, [Parameter()] [System.Boolean] $DownloadLink = $false, [Parameter()] [System.Boolean] $EnableEndUserSpamNotifications = $false, [Parameter()] [System.Boolean] $EnableLanguageBlockList = $false, [Parameter()] [System.Boolean] $EnableRegionBlockList = $false, [Parameter()] [ValidatePattern("^$|^[a-zA-Z0-9.!£#$%&'^_`{}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$")] [System.String] $EndUserSpamNotificationCustomFromAddress, [Parameter()] [System.String] $EndUserSpamNotificationCustomFromName, [Parameter()] [System.String] $EndUserSpamNotificationCustomSubject, [Parameter()] [ValidateRange(1, 15)] [uint32] $EndUserSpamNotificationFrequency = 3, [Parameter()] [ValidateSet('Default', 'English', 'French', 'German', 'Italian', 'Japanese', 'Spanish', 'Korean', 'Portuguese', 'Russian', 'ChineseSimplified', 'ChineseTraditional', 'Amharic', 'Arabic', 'Bulgarian', 'BengaliIndia', 'Catalan', 'Czech', 'Cyrillic', 'Danish', 'Greek', 'Estonian', 'Basque', 'Farsi', 'Finnish', 'Filipino', 'Galician', 'Gujarati', 'Hebrew', 'Hindi', 'Croatian', 'Hungarian', 'Indonesian', 'Icelandic', 'Kazakh', 'Kannada', 'Lithuanian', 'Latvian', 'Malayalam', 'Marathi', 'Malay', 'Dutch', 'NorwegianNynorsk', 'Norwegian', 'Oriya', 'Polish', 'PortuguesePortugal', 'Romanian', 'Slovak', 'Slovenian', 'SerbianCyrillic', 'Serbian', 'Swedish', 'Swahili', 'Tamil', 'Telugu', 'Thai', 'Turkish', 'Ukrainian', 'Urdu', 'Vietnamese')] [System.String] $EndUserSpamNotificationLanguage = 'Default', [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $HighConfidenceSpamAction = 'MoveToJmf', [Parameter()] [System.Boolean] $InlineSafetyTipsEnabled = $true, [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithBizOrInfoUrls = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithImageLinks = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithNumericIps = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithRedirectToOtherPort = 'Off', [Parameter()] [System.String[]] $LanguageBlockList = @(), [Parameter()] [System.Boolean] $MakeDefault = $false, [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamBulkMail = 'On', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamEmbedTagsInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamEmptyMessages = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamFormTagsInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamFramesInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamFromAddressAuthFail = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamJavaScriptInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamNdrBackscatter = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamObjectTagsInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamSensitiveWordList = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamSpfRecordHardFail = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamWebBugsInHtml = 'Off', [Parameter()] [System.String] $ModifySubjectValue, [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $PhishSpamAction = 'MoveToJmf', [Parameter()] [ValidateRange(1, 30)] [uint32] $QuarantineRetentionPeriod = 15, [Parameter()] [System.String[]] $RedirectToRecipients = @(), [Parameter()] [System.String[]] $RegionBlockList = @(), [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $SpamAction = 'MoveToJmf', [Parameter()] [ValidateSet('None', 'AddXHeader', 'BccMessage')] [System.String] $TestModeAction = 'None', [Parameter()] [System.String[]] $TestModeBccToRecipients = @(), [Parameter()] [System.Boolean] $PhishZapEnabled = $true, [Parameter()] [System.Boolean] $SpamZapEnabled = $true, [Parameter()] [ValidateSet('Present', 'Absent')] [System.String] $Ensure = 'Present', [Parameter()] [System.Management.Automation.PSCredential] $GlobalAdminAccount, [Parameter()] [System.String] $ApplicationId, [Parameter()] [System.String] $TenantId, [Parameter()] [System.String] $CertificateThumbprint, [Parameter()] [System.String] $CertificatePath, [Parameter()] [System.Management.Automation.PSCredential] $CertificatePassword ) Write-Verbose -Message "Setting configuration of HostedContentFilterPolicy for $Identity" #region Telemetry $ResourceName = $MyInvocation.MyCommand.ModuleName.Replace("MSFT_", "") $data = [System.Collections.Generic.Dictionary[[String], [String]]]::new() $data.Add("Resource", $ResourceName) $data.Add("Method", $MyInvocation.MyCommand) $data.Add("Principal", $GlobalAdminAccount.UserName) $data.Add("TenantId", $TenantId) Add-M365DSCTelemetryEvent -Data $data #endregion $ConnectionMode = New-M365DSCConnection -Platform 'ExchangeOnline' ` -InboundParameters $PSBoundParameters $HostedContentFilterPolicies = Get-HostedContentFilterPolicy $HostedContentFilterPolicy = $HostedContentFilterPolicies | Where-Object -FilterScript { $_.Identity -eq $Identity } $HostedContentFilterPolicyParams = $PSBoundParameters $HostedContentFilterPolicyParams.Remove('Ensure') | Out-Null $HostedContentFilterPolicyParams.Remove('GlobalAdminAccount') | Out-Null $HostedContentFilterPolicyParams.Remove('MakeDefault') | Out-Null if ($HostedContentFilterPolicyParams.Contains('EndUserSpamNotificationCustomFromAddress')) { $HostedContentFilterPolicyParams.Remove('EndUserSpamNotificationCustomFromAddress') | Out-Null Write-Verbose -Message "The EndUserSpamNotificationCustomFromAddress parameter is no longer available and will be depricated." } if ($HostedContentFilterPolicyParams.Contains('EndUserSpamNotificationCustomFromName')) { $HostedContentFilterPolicyParams.Remove('EndUserSpamNotificationCustomFromName') | Out-Null Write-Verbose -Message "The EndUserSpamNotificationCustomFromName parameter is no longer available and will be depricated." } if (('Present' -eq $Ensure ) -and ($null -eq $HostedContentFilterPolicy)) { $HostedContentFilterPolicyParams += @{ Name = $HostedContentFilterPolicyParams.Identity } $HostedContentFilterPolicyParams.Remove('Identity') | Out-Null Write-Verbose -Message "Creating HostedContentFilterPolicy $($Identity)." New-HostedContentFilterPolicy @HostedContentFilterPolicyParams } elseif (('Present' -eq $Ensure ) -and ($null -ne $HostedContentFilterPolicy)) { Write-Verbose -Message "Setting HostedContentFilterPolicy $($Identity) with values: $(Convert-M365DscHashtableToString -Hashtable $HostedContentFilterPolicyParams)." if ($PSBoundParameters.MakeDefault) { Set-HostedContentFilterPolicy @HostedContentFilterPolicyParams -MakeDefault -Confirm:$false } else { Set-HostedContentFilterPolicy @HostedContentFilterPolicyParams -Confirm:$false } } elseif (('Absent' -eq $Ensure ) -and ($null -ne $HostedContentFilterPolicy)) { Write-Verbose -Message "Removing HostedContentFilterPolicy $($Identity) " Remove-HostedContentFilterPolicy -Identity $Identity -Confirm:$false } } function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( [Parameter(Mandatory = $true)] [System.String] $Identity, [Parameter()] [System.String] $AddXHeaderValue, [Parameter()] [System.String] $AdminDisplayName, [Parameter()] [System.String[]] $AllowedSenderDomains = @(), [Parameter()] [System.String[]] $AllowedSenders = @(), [Parameter()] [System.String[]] $BlockedSenderDomains = @(), [Parameter()] [System.String[]] $BlockedSenders = @(), [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $BulkSpamAction = 'MoveToJmf', [Parameter()] [ValidateRange(1, 9)] [uint32] $BulkThreshold = 7, [Parameter()] [System.Boolean] $DownloadLink = $false, [Parameter()] [System.Boolean] $EnableEndUserSpamNotifications = $false, [Parameter()] [System.Boolean] $EnableLanguageBlockList = $false, [Parameter()] [System.Boolean] $EnableRegionBlockList = $false, [Parameter()] [ValidatePattern("^$|^[a-zA-Z0-9.!£#$%&'^_`{}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$")] [System.String] $EndUserSpamNotificationCustomFromAddress, [Parameter()] [System.String] $EndUserSpamNotificationCustomFromName, [Parameter()] [System.String] $EndUserSpamNotificationCustomSubject, [Parameter()] [ValidateRange(1, 15)] [uint32] $EndUserSpamNotificationFrequency = 3, [Parameter()] [ValidateSet('Default', 'English', 'French', 'German', 'Italian', 'Japanese', 'Spanish', 'Korean', 'Portuguese', 'Russian', 'ChineseSimplified', 'ChineseTraditional', 'Amharic', 'Arabic', 'Bulgarian', 'BengaliIndia', 'Catalan', 'Czech', 'Cyrillic', 'Danish', 'Greek', 'Estonian', 'Basque', 'Farsi', 'Finnish', 'Filipino', 'Galician', 'Gujarati', 'Hebrew', 'Hindi', 'Croatian', 'Hungarian', 'Indonesian', 'Icelandic', 'Kazakh', 'Kannada', 'Lithuanian', 'Latvian', 'Malayalam', 'Marathi', 'Malay', 'Dutch', 'NorwegianNynorsk', 'Norwegian', 'Oriya', 'Polish', 'PortuguesePortugal', 'Romanian', 'Slovak', 'Slovenian', 'SerbianCyrillic', 'Serbian', 'Swedish', 'Swahili', 'Tamil', 'Telugu', 'Thai', 'Turkish', 'Ukrainian', 'Urdu', 'Vietnamese')] [System.String] $EndUserSpamNotificationLanguage = 'Default', [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $HighConfidenceSpamAction = 'MoveToJmf', [Parameter()] [System.Boolean] $InlineSafetyTipsEnabled = $true, [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithBizOrInfoUrls = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithImageLinks = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithNumericIps = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $IncreaseScoreWithRedirectToOtherPort = 'Off', [Parameter()] [System.String[]] $LanguageBlockList = @(), [Parameter()] [System.Boolean] $MakeDefault = $false, [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamBulkMail = 'On', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamEmbedTagsInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamEmptyMessages = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamFormTagsInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamFramesInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamFromAddressAuthFail = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamJavaScriptInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamNdrBackscatter = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamObjectTagsInHtml = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamSensitiveWordList = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamSpfRecordHardFail = 'Off', [Parameter()] [ValidateSet('Off', 'On', 'Test')] [System.String] $MarkAsSpamWebBugsInHtml = 'Off', [Parameter()] [System.String] $ModifySubjectValue, [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $PhishSpamAction = 'MoveToJmf', [Parameter()] [ValidateRange(1, 30)] [uint32] $QuarantineRetentionPeriod = 15, [Parameter()] [System.String[]] $RedirectToRecipients = @(), [Parameter()] [System.String[]] $RegionBlockList = @(), [Parameter()] [ValidateSet('MoveToJmf', 'AddXHeader', 'ModifySubject', 'Redirect', 'Delete', 'Quarantine', 'NoAction')] [System.String] $SpamAction = 'MoveToJmf', [Parameter()] [ValidateSet('None', 'AddXHeader', 'BccMessage')] [System.String] $TestModeAction = 'None', [Parameter()] [System.String[]] $TestModeBccToRecipients = @(), [Parameter()] [System.Boolean] $PhishZapEnabled = $true, [Parameter()] [System.Boolean] $SpamZapEnabled = $true, [Parameter()] [ValidateSet('Present', 'Absent')] [System.String] $Ensure = 'Present', [Parameter()] [System.Management.Automation.PSCredential] $GlobalAdminAccount, [Parameter()] [System.String] $ApplicationId, [Parameter()] [System.String] $TenantId, [Parameter()] [System.String] $CertificateThumbprint, [Parameter()] [System.String] $CertificatePath, [Parameter()] [System.Management.Automation.PSCredential] $CertificatePassword ) #region Telemetry $ResourceName = $MyInvocation.MyCommand.ModuleName.Replace("MSFT_", "") $data = [System.Collections.Generic.Dictionary[[String], [String]]]::new() $data.Add("Resource", $ResourceName) $data.Add("Method", $MyInvocation.MyCommand) $data.Add("Principal", $GlobalAdminAccount.UserName) $data.Add("TenantId", $TenantId) Add-M365DSCTelemetryEvent -Data $data #endregion Write-Verbose -Message "Testing configuration of HostedContentFilterPolicy for $Identity" $CurrentValues = Get-TargetResource @PSBoundParameters Write-Verbose -Message "Current Values: $(Convert-M365DscHashtableToString -Hashtable $CurrentValues)" Write-Verbose -Message "Target Values: $(Convert-M365DscHashtableToString -Hashtable $PSBoundParameters)" $ValuesToCheck = $PSBoundParameters $ValuesToCheck.Remove('GlobalAdminAccount') | Out-Null $ValuesToCheck.Remove('EndUserSpamNotificationCustomFromAddress') | Out-Null $ValuesToCheck.Remove('EndUserSpamNotificationCustomFromName') | Out-Null $TestResult = Test-M365DSCParameterState -CurrentValues $CurrentValues ` -Source $($MyInvocation.MyCommand.Source) ` -DesiredValues $PSBoundParameters ` -ValuesToCheck $ValuesToCheck.Keys Write-Verbose -Message "Test-TargetResource returned $TestResult" return $TestResult } function Export-TargetResource { [CmdletBinding()] [OutputType([System.String])] param ( [Parameter()] [System.Management.Automation.PSCredential] $GlobalAdminAccount, [Parameter()] [System.String] $ApplicationId, [Parameter()] [System.String] $TenantId, [Parameter()] [System.String] $CertificateThumbprint, [Parameter()] [System.String] $CertificatePath, [Parameter()] [System.Management.Automation.PSCredential] $CertificatePassword ) #region Telemetry $ResourceName = $MyInvocation.MyCommand.ModuleName.Replace("MSFT_", "") $data = [System.Collections.Generic.Dictionary[[String], [String]]]::new() $data.Add("Resource", $ResourceName) $data.Add("Method", $MyInvocation.MyCommand) $data.Add("Principal", $GlobalAdminAccount.UserName) $data.Add("TenantId", $TenantId) Add-M365DSCTelemetryEvent -Data $data #endregion $ConnectionMode = New-M365DSCConnection -Platform 'ExchangeOnline' ` -InboundParameters $PSBoundParameters ` -SkipModuleReload $true try { [array]$HostedContentFilterPolicies = Get-HostedContentFilterPolicy -ErrorAction Stop $dscContent = '' if ($HostedContentFilterPolicies.Length -eq 0) { Write-Host $Global:M365DSCEmojiGreenCheckMark } else { Write-Host "`r`n" -NoNewline } $i = 1 foreach ($HostedContentFilterPolicy in $HostedContentFilterPolicies) { $Params = @{ GlobalAdminAccount = $GlobalAdminAccount Identity = $HostedContentFilterPolicy.Identity ApplicationId = $ApplicationId TenantId = $TenantId CertificateThumbprint = $CertificateThumbprint CertificatePassword = $CertificatePassword CertificatePath = $CertificatePath } Write-Host " |---[$i/$($HostedContentFilterPolicies.Length)] $($HostedContentFilterPolicy.Identity)" -NoNewline $Results = Get-TargetResource @Params $Results = Update-M365DSCExportAuthenticationResults -ConnectionMode $ConnectionMode ` -Results $Results $dscContent += Get-M365DSCExportContentForResource -ResourceName $ResourceName ` -ConnectionMode $ConnectionMode ` -ModulePath $PSScriptRoot ` -Results $Results ` -GlobalAdminAccount $GlobalAdminAccount Write-Host $Global:M365DSCEmojiGreenCheckMark $i++ } return $dscContent } catch { try { Write-Verbose -Message $_ $tenantIdValue = "" if (-not [System.String]::IsNullOrEmpty($TenantId)) { $tenantIdValue = $TenantId } elseif ($null -ne $GlobalAdminAccount) { $tenantIdValue = $GlobalAdminAccount.UserName.Split('@')[1] } Add-M365DSCEvent -Message $_ -EntryType 'Error' ` -EventID 1 -Source $($MyInvocation.MyCommand.Source) ` -TenantId $tenantIdValue } catch { Write-Verbose -Message $_ } return "" } } Export-ModuleMember -Function *-TargetResource |