RealmJoin.RunbookHelper

0.8.0-rc2

ConnectionExchangeOnline.ps1

function Connect-RjRbExchangeOnline {
    [CmdletBinding()]
    param (
        [string] $AutomationConnectionName = "AzureRunAsConnection"
    )

    # see RealmJoin.RunbookHelper.psm1
    $Global:VerbosePreference = "SilentlyContinue"

    $connectParams = @{ ShowBanner = $false }
    if (checkIfManagedIdentityShouldBeUsed 'EXO' $false) {
        $connectParams += @{ ManagedIdentity = $true }
    }
    else {
        $autoCon = getAutomationConnectionOrFromLocalCertificate $AutomationConnectionName
        $connectParams += @{ 
            Organization          = $autoCon.TenantId
            AppId                 = $autoCon.ApplicationId
            CertificateThumbprint = $autoCon.CertificateThumbprint
        }
    }


    if ($connectParams['Organization'] -inotlike "*.onmicrosoft.com") {
        Write-RjRbLog "Trying to determine initial domain name (*.onmicrosoft.com) using Graph"
        Connect-RjRbGraph
        $connectParams.Organization = Invoke-RjRbRestMethodGraph /organization | Select-Object -ExpandProperty verifiedDomains | `
            Where-Object { $_.isInitial } | Select-Object -First 1 -ExpandProperty name
    }

    Write-RjRbLog "Connecting with ExchangeOnline module" $connectParams
    if ($connectParams['ManagedIdentity']) {
        $exoVersion = (Import-Module -Name 'ExchangeOnlineManagement' -Global -PassThru).Version
        if ($exoVersion -lt '3.0.0') {
            throw "Connecting to Exchange Online with a Managed Identity requires at least version 3.0.0 of 'ExchangeOnlineManagement', but only version $exoVersion was found."
        }
    }
    Connect-ExchangeOnline @connectParams
}