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()] [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 Office 365 Shared Mailbox $DisplayName" #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 $nullReturn = @{ DisplayName = $DisplayName PrimarySMTPAddress = $null GlobalAdminAccount = $null Ensure = "Absent" } if ($Global:CurrentModeIsExport) { $ConnectionMode = New-M365DSCConnection -Platform 'ExchangeOnline' ` -InboundParameters $PSBoundParameters ` -SkipModuleReload $true } else { $ConnectionMode = New-M365DSCConnection -Platform 'ExchangeOnline' ` -InboundParameters $PSBoundParameters } $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()] [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 Office 365 Shared Mailbox $DisplayName" #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 $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 $ConnectionMode = New-M365DSCConnection -Platform 'ExchangeOnline' ` -InboundParameters $PSBoundParameters # 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()] [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 "Testing configuration of Office 365 Shared Mailbox $DisplayName" $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()] [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 [array]$mailboxes = Get-Mailbox $mailboxes = $mailboxes | Where-Object -FilterScript { $_.RecipientTypeDetails -eq "SharedMailbox" } $dscContent = '' $i = 1 if ($mailboxes.Length -eq 0) { Write-Host $Global:M365DSCEmojiGreenCheckMark } else { Write-Host "`r`n" -NoNewLine } foreach ($mailbox in $mailboxes) { Write-Host " |---[$i/$($mailboxes.Length)] $($mailbox.Name)" -NoNewLine $mailboxName = $mailbox.Name if ($mailboxName) { $params = @{ GlobalAdminAccount = $GlobalAdminAccount DisplayName = $mailboxName ApplicationId = $ApplicationId TenantId = $TenantId CertificateThumbprint = $CertificateThumbprint CertificatePassword = $CertificatePassword CertificatePath = $CertificatePath } $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 } Export-ModuleMember -Function *-TargetResource |