DSCResources/MSFT_EXOSharedMailbox/MSFT_EXOSharedMailbox.psm1
|
function Get-TargetResource { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( [Parameter(Mandatory = $true)] [System.String] $DisplayName, [Parameter()] [System.String] $PrimarySMTPAddress, [Parameter()] [System.String[]] $Aliases, [Parameter()] [ValidateSet("Present", "Absent")] [System.String] $Ensure = "Present", [Parameter(Mandatory = $true)] [System.Management.Automation.PSCredential] $GlobalAdminAccount ) Write-Verbose -Message "Getting configuration of Office 365 Shared Mailbox $DisplayName" #region Telemetry $data = [System.Collections.Generic.Dictionary[[String], [String]]]::new() $data.Add("Resource", $MyInvocation.MyCommand.ModuleName) $data.Add("Method", $MyInvocation.MyCommand) Add-M365DSCTelemetryEvent -Data $data #endregion $nullReturn = @{ DisplayName = $DisplayName PrimarySMTPAddress = $null GlobalAdminAccount = $null Ensure = "Absent" } Test-MSCloudLogin -CloudCredential $GlobalAdminAccount ` -Platform ExchangeOnline $mailboxes = Get-Mailbox $mailbox = $mailboxes | Where-Object -FilterScript { $_.RecipientTypeDetails -eq "SharedMailbox" -and ` $_.Identity -eq $DisplayName } if ($null -eq $mailbox) { Write-Verbose -Message "The specified Shared Mailbox doesn't already exist." return $nullReturn } #region Email Aliases $CurrentAliases = @() foreach ($email in $mailbox.EmailAddresses) { $emailValue = $email.Split(":")[1] if ($emailValue -and $emailValue -ne $mailbox.PrimarySMTPAddress) { $CurrentAliases += $emailValue } } #endregion $result = @{ DisplayName = $DisplayName PrimarySMTPAddress = $mailbox.PrimarySMTPAddress.ToString() Aliases = $CurrentAliases Ensure = "Present" GlobalAdminAccount = $GlobalAdminAccount } Write-Verbose -Message "Found an existing instance of Shared Mailbox '$($DisplayName)'" return $result } function Set-TargetResource { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [System.String] $DisplayName, [Parameter()] [System.String] $PrimarySMTPAddress, [Parameter()] [System.String[]] $Aliases, [Parameter()] [ValidateSet("Present", "Absent")] [System.String] $Ensure = "Present", [Parameter(Mandatory = $true)] [System.Management.Automation.PSCredential] $GlobalAdminAccount ) Write-Verbose -Message "Setting configuration of Office 365 Shared Mailbox $DisplayName" #region Telemetry $data = [System.Collections.Generic.Dictionary[[String], [String]]]::new() $data.Add("Resource", $MyInvocation.MyCommand.ModuleName) $data.Add("Method", $MyInvocation.MyCommand) Add-M365DSCTelemetryEvent -Data $data #endregion $currentMailbox = Get-TargetResource @PSBoundParameters #region Validation foreach ($alias in $Aliases) { if ($alias.ToLower() -eq $PrimarySMTPAddress.ToLower()) { throw "You cannot have the Aliases list contain the PrimarySMTPAddress" } } #endregion $CurrentParameters = $PSBoundParameters Test-MSCloudLogin -CloudCredential $GlobalAdminAccount ` -Platform ExchangeOnline # CASE: Mailbox doesn't exist but should; if ($Ensure -eq "Present" -and $currentMailbox.Ensure -eq "Absent") { Write-Verbose -Message "Shared Mailbox '$($DisplayName)' does not exist but it should. Creating it." $emails = "" foreach ($alias in $Aliases) { $emails += $alias + "," } $emails += $PrimarySMTPAddress $proxyAddresses = $emails -Split ',' $CurrentParameters.Aliases = $proxyAddresses New-MailBox -Name $DisplayName -PrimarySMTPAddress $PrimarySMTPAddress -Shared:$true Set-Mailbox -Identity $DisplayName -EmailAddresses @{add = $Aliases } } # CASE: Mailbox exists but it shouldn't; elseif ($Ensure -eq "Absent" -and $currentMailbox.Ensure -eq "Present") { Write-Verbose -Message "Shared Mailbox '$($DisplayName)' exists but it shouldn't. Deleting it." Remove-Mailbox -Identity $DisplayName -Confirm:$false } # CASE: Mailbox exists and it should, but has different values than the desired ones elseif ($Ensure -eq "Present" -and $currentMailbox.Ensure -eq "Present") { # CASE: Email Aliases need to be updated Write-Verbose -Message "Shared Mailbox '$($DisplayName)' already exists, but needs updating." $current = $currentMailbox.Aliases $desired = $Aliases $diff = Compare-Object -ReferenceObject $current -DifferenceObject $desired if ($diff) { Write-Verbose -Message "Updating the list of Aliases for the Shared Mailbox '$($DisplayName)'" $emails = "" foreach ($alias in $Aliases) { $emails += $alias + "," } $emails += $PrimarySMTPAddress $proxyAddresses = $emails -Split ',' $CurrentParameters.Aliases = $proxyAddresses Write-Verbose -Message "Adding the following email aliases: $($emails)" Set-Mailbox -Identity $DisplayName -EmailAddresses @{add = $Aliases } } } } function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( [Parameter(Mandatory = $true)] [System.String] $DisplayName, [Parameter()] [System.String] $PrimarySMTPAddress, [Parameter()] [System.String[]] $Aliases, [Parameter()] [ValidateSet("Present", "Absent")] [System.String] $Ensure = "Present", [Parameter(Mandatory = $true)] [System.Management.Automation.PSCredential] $GlobalAdminAccount ) Write-Verbose -Message "Testing configuration of Office 365 Shared Mailbox $DisplayName" #region Telemetry $data = [System.Collections.Generic.Dictionary[[String], [String]]]::new() $data.Add("Resource", $MyInvocation.MyCommand.ModuleName) $data.Add("Method", $MyInvocation.MyCommand) Add-M365DSCTelemetryEvent -Data $data #endregion $CurrentValues = Get-TargetResource @PSBoundParameters Write-Verbose -Message "Current Values: $(Convert-M365DscHashtableToString -Hashtable $CurrentValues)" Write-Verbose -Message "Target Values: $(Convert-M365DscHashtableToString -Hashtable $PSBoundParameters)" $TestResult = Test-Microsoft365DSCParameterState -CurrentValues $CurrentValues ` -Source $($MyInvocation.MyCommand.Source) ` -DesiredValues $PSBoundParameters ` -ValuesToCheck @("Ensure", ` "DisplayName", ` "PrimarySMTPAddress", "Aliases") Write-Verbose -Message "Test-TargetResource returned $TestResult" return $TestResult } function Export-TargetResource { [CmdletBinding()] [OutputType([System.String])] param ( [Parameter(Mandatory = $true)] [System.Management.Automation.PSCredential] $GlobalAdminAccount ) $InformationPreference = 'Continue' #region Telemetry $data = [System.Collections.Generic.Dictionary[[String], [String]]]::new() $data.Add("Resource", $MyInvocation.MyCommand.ModuleName) $data.Add("Method", $MyInvocation.MyCommand) Add-M365DSCTelemetryEvent -Data $data #endregion Test-MSCloudLogin -CloudCredential $GlobalAdminAccount ` -Platform ExchangeOnline ` -ErrorAction SilentlyContinue $organization = "" if ($GlobalAdminAccount.UserName.Contains("@")) { $organization = $GlobalAdminAccount.UserName.Split("@")[1] } $mailboxes = Get-Mailbox $mailboxes = $mailboxes | Where-Object -FilterScript { $_.RecipientTypeDetails -eq "SharedMailbox" } $content = '' $i = 1 $total = $mailboxes.Length if ($null -eq $total -and $null -ne $mailboxes) { $total = 1 } foreach ($mailbox in $mailboxes) { Write-Information " [$i/$total] $($mailbox.Name)" $mailboxName = $mailbox.Name if ($mailboxName) { $params = @{ GlobalAdminAccount = $GlobalAdminAccount DisplayName = $mailboxName } $result = Get-TargetResource @params $result.GlobalAdminAccount = Resolve-Credentials -UserName "globaladmin" $modulePath = $PSScriptRoot + "\MSFT_EXOSharedMailbox.psm1" $content += " EXOSharedMailbox " + (New-GUID).ToString() + "`r`n" $content += " {`r`n" $partialContent = Get-DSCBlock -Params $result -ModulePath $modulePath $partialContent = Convert-DSCStringParamToVariable -DSCBlock $partialContent -ParameterName "GlobalAdminAccount" if ($partialContent.ToLower().IndexOf("@" + $organization.ToLower()) -gt 0) { $partialContent = $partialContent -ireplace [regex]::Escape("@" + $organization), "@`$OrganizationName" } $content += $partialContent $content += " }`r`n" } $i++ } return $content } Export-ModuleMember -Function *-TargetResource |