Connect-MS365

1.3.9

Connect-MS365.psm1

#.ExternalHelp Connect-MS365-help.xml
<#
.SYNOPSIS
Connects to a given online service of Microsoft.
 
.DESCRIPTION
Connects to a given online service of Microsoft.
One or multiple service names can be chosen. Supports connection handling for
- Microsoft Online (MSOL) - aka AzureAD v1
- Exchange Online (EOL)
- Teams
- SharePoint Online (SPO)
- Security and Compliance Center (SCC)
- Azure ActiveDirectory (AAD) v2
- Azure Platform (AZ)
- Skype for Business Online service (S4B)
 
.PARAMETER Service
Specifies the service to connect to. May be a list of multiple services to use.
 
.PARAMETER SPOOrgName
Parameter that specifices the organization name for SharePointOnline. Used to create SPO Admin URL.
 
.PARAMETER ReInitConfig
Forces to initialize config file in $env:LOCALAPPDATA\Connect-MS365\Connect-MS365.Config.psd1 although file exist.
 
.INPUTS
None. You cannot pipe objects to Connect-MS365.
 
.EXAMPLE
Description: Connect to Microsoft Online
Connect-MS365 -Service MSOL
 
.EXAMPLE
Description: Connect to Microsoft Online and Exchange Online
Connect-MS365 -Service MSOL,EOL
 
.EXAMPLE
Description: Connect to SharePoint Online to connect to MyName-admin.sharepoint.com
Connect-MS365 -Service SPO -SPOOrgName MyName
 
.EXAMPLE
Description: Connect to Security and Compliance Center
Connect-MS365 -Service SCC
 
.EXAMPLE
Description: Connect to Azure ActiveDirectory
Connect-MS365 -Service AAD
 
.EXAMPLE
Description: Connect to Microsoft Azure platform
Connect-MS365 -Service AZ
 
.EXAMPLE
Description: Connect to Microsoft Skype for Business Online service
Connect-MS365 -Service S4B
 
.LINK
https://github.com/blindzero/Connect-MS365
 
#>

#Requires -Version 5.1
function Connect-MS365 {

    [CmdletBinding(DefaultParameterSetName)]
    [OutputType()]
    
    param (
        #service parameter to define to which services to connect to
        #are validated against available / implemented services
        [Parameter(Mandatory = $true, Position = 1)]
        [ValidateSet('MSOL','EOL','Teams','SPO','SCC','AAD','AZ','S4B')]
        [string[]]
        $Service,
        #spoorg parameter for connection to SPO service
        #needed by connect cmdlet to assemble admin Url
        [Parameter(Mandatory = $false, Position = 2)]
        [string]
        [Alias('SPOOrg')]
        $SPOOrgName,
        #Credential parameter to receive previously created PSCredential object.
        #Primarily needed for testing calls
        [Parameter(Mandatory = $false, Position = 3, ParameterSetName = 'Credential')]
        [PSCredential]
        $Credential,
        # re-initialize configuration file
        [Parameter(Mandatory = $false, Position = 4, ParameterSetName = 'ReInitConfig')]
        [switch]
        $ReInitConfig = $false
    )

    # TODO #10: changing to settings array containing module names making switch unnecessary

    # we initialize our config, all checks if exists or not / overwriting is done in function
    Initialize-Config -Force:$ReInitConfig

    # reading config data
    $Config = Read-Config

    # iterating through each service listed in service parameter
    ForEach ($ServiceItem in $Service) {
        Write-Verbose "Create session to Service $ServiceItem"
        Switch($ServiceItem) {
            # Microsoft Online service
            MSOL {
                $ServiceName = "Microsoft Online / AzureAD v1"
                $ModuleName = "MSOnline"
                $ModuleFindString = $ModuleName

                Connect-MSOL
                continue
            }
            # Exchange Online service
            EOL {
                $ServiceName = "Exchange Online"
                $ModuleName = "ExchangeOnlineManagement"
                $ModuleFindString = $ModuleName

                Connect-EOL
                continue
            }
            # Teams service
            Teams {
                $ServiceName = "Microsoft Teams"
                $ModuleName = "MicrosoftTeams"
                $ModuleFindString = $ModuleName

                Connect-Teams
                continue
            }
            # Security and Compliance Center
            SCC {
                $ServiceName = "Security & Compliance Center"
                $ModuleName = "ExchangeOnlineManagement"
                $ModuleFindString = $ModuleName

                Connect-SCC
                continue
            }
            # AzureAD
            AAD {
                $ServiceName = "AzureAD v2"
                $ModuleName = "AzureAD"
                $ModuleFindString = $ModuleName

                Connect-AAD
                continue
            }
            # Azure
            AZ {
                $ServiceName = "Azure"
                $ModuleName = "Az"
                $ModuleFindString = "Az.*"

                Connect-AZ
                continue
            }
            # SPO service
            SPO {
                $ServiceName = "SharePoint Online"
                $ModuleName = "Microsoft.Online.SharePoint.PowerShell"
                $ModuleFindString = $ModuleName

                If (!($SPOOrgName)) {
                    Write-Error 'To connect to SharePoint Online you have to provide the -SPOOrgName parameter.'
                    continue
                }
                Else {
                    Write-Verbose "Assembling SPOOrgUrl from $SPOOrgName"
                    $SPOOrgUrl = "https://$($SPOOrgName)-admin.sharepoint.com"
                    Write-Verbose "Created $SPOOrgUrl"
                }
                
                Write-Verbose "Connecting to SharePoint Online at $SPOOrgUrl"
                Connect-SPO -SPOOrgUrl $SPOOrgUrl
                continue
            }
            # S4B Service
            S4B {
                $ServiceName = "Microsoft Skype4Business"
                $ModuleName = "SkypeOnlineConnector"
                $ModuleFindString = $ModuleName

                Connect-S4B
                continue
            }

        }
        Write-Verbose "Create session to Service $ServiceItem done."
    }

    Write-Verbose "Connect-MS365 done."
}

function Connect-AAD {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false,Position=1)]
        [PSCredential]
        $Credential
    )

    <#
    .SYNOPSIS
    Connects to Microsoft Azure ActiveDirectory (AzureAD / AAD) service.
 
    .DESCRIPTION
    Connects to Microsoft Azure ActiveDirectory (AzureAD / AAD) service.
 
    .PARAMETER Credential
    PSCredential object containing user credentials.
 
    .INPUTS
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
    // <OBJECTTYPE>. TBD.
 
    .EXAMPLE
    PS> Connect-AAD -Credential $Credential
 
    .LINK
    http://github.com/blindzero/Connect-MS365
 
    #>

    # testing if module is available
    while (!(Test-MS365Module -Module $ModuleName)) {
        # and install if not available
        Install-MS365Module -Module $ModuleName
    }
    try {
        $null = Connect-AzureAD
    }
    catch {
        $ErrorMessage = $_.Exception.Message
        Write-Error -Message "Could not connect to $ServiceItem.`n$ErrorMessage" -Category ConnectionError
        Break
    }
    # set service name into window title if successfully connected
    Set-WindowTitle -Service $ServiceItem
}
function Connect-AZ {
    [CmdletBinding()]
    param (
    )

    <#
    .SYNOPSIS
    Connects to Microsoft Azure platform.
 
    .DESCRIPTION
    Connects to Microsoft Azure platform.
 
    .INPUTS
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
    // <OBJECTTYPE>. TBD.
 
    .EXAMPLE
    PS> Connect-AZ -Credential $Credential
 
    .LINK
    http://github.com/blindzero/Connect-MS365
 
    #>

    # testing if module is available
    while (!(Test-MS365Module -Module $ModuleName)) {
        # and install if not available
        Install-MS365Module -Module $ModuleName
    }
    try {
        $null = Connect-AzAccount
    }
    catch {
        $ErrorMessage = $_.Exception.Message
        Write-Error -Message "Could not connect to $ServiceItem.`n$ErrorMessage" -Category ConnectionError
        Break
    }
    # set service name into window title if successfully connected
    Set-WindowTitle -Service $ServiceItem
}
function Connect-EOL {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false,Position=1)]
        [PSCredential]
        $Credential
    )

    <#
    .SYNOPSIS
 
    Connects to Microsoft Exchange Online service.
 
    .DESCRIPTION
 
    Connects to Microsoft Exchange Online service.
 
    .PARAMETER Credential
 
    PSCredential object containing user credentials.
 
    .INPUTS
 
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
 
    // <OBJECTTYPE>. TBD.
 
    .EXAMPLE
 
    PS> Connect-EOL -Credential $Credential
 
    .LINK
 
    http://github.com/blindzero/Connect-MS365
 
    #>

    # testing if module is available
    while (!(Test-MS365Module -Module $ModuleName)) {
        # and install if not available
        Install-MS365Module -Module $ModuleName
    }

    $ConfigDefaultUPN = $Config['DefaultUserPrincipalName']

    try {
        if ($ConfigDefaultUPN) {
            Write-Verbose -Message "Connecting to EXO with $ConfigDefaultUPN"
            Connect-ExchangeOnline -UserPrincipalName $ConfigDefaultUPN -ShowProgress $true -ShowBanner:$false
        }
        else {
            Write-Verbose -Message "Connecting to EXO with UPN prompt"
            Connect-ExchangeOnline -ShowProgress $true -ShowBanner:$false
        }
    }
    catch {
        $ErrorMessage = $_.Exception.Message
        Write-Error -Message "Could not connect to $ServiceItem.`n$ErrorMessage" -Category ConnectionError
        Break
    }
    # set service name into window title if successfully connected
    Set-WindowTitle -Service $ServiceItem
}
function Connect-MSOL {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false,Position=1)]
        [PSCredential]
        $Credential
    )

    <#
    .SYNOPSIS
    Connects to Microsoft Online service.
 
    .DESCRIPTION
    Connects to Microsoft Online service / Azure ActiveDirectory v1
 
    .PARAMETER Credential
    PSCredential object containing user credentials.
 
    .INPUTS
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
    // <OBJECTTYPE>. TBD.
 
    .EXAMPLE
    PS> Connect-MSOL -Credential $Credential
 
    .LINK
    http://github.com/blindzero/Connect-MS365
 
    #>

    # testing if module is available
    while (!(Test-MS365Module -Module $ModuleName)) {
        # and install if not available
        Install-MS365Module -Module $ModuleName
    }
    try {
        Connect-MsolService -ErrorAction Stop
    }
    catch {
        $ErrorMessage = $_.Exception.Message
        Write-Error -Message "Could not connect to $ServiceItem.`n$ErrorMessage" -Category ConnectionError
        Break
    }
    # set service name into window title if successfully connected
    Set-WindowTitle -Service $ServiceItem
}
function Connect-S4B {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory = $false, Position = 1)]
        [PSCredential]
        $Credential
    )

    <#
    .SYNOPSIS
    Connects to Microsoft Skype for Business Online service.
 
    .DESCRIPTION
    Connects to Microsoft Skype for Business Online service.
 
    .PARAMETER Credential
    PSCredential object containing user credentials.
 
    .INPUTS
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
    // <OBJECTTYPE>. TBD.
 
    .EXAMPLE
    PS> Connect-S4B -Credential $Credential
 
    .LINK
    http://github.com/blindzero/Connect-MS365
 
    #>

    # testing if module is available
    while (!(Test-MS365Module -Module $ModuleName)) {
        # and install if not available
        #S4B module is not available on https://www.powershellgallery.com - must be installed manually
        Write-Error -Message "SkypeOnlineConnector module is not installed.`nPlease download and install it manually from https://www.microsoft.com/en-us/download/details.aspx?id=39366" -Category NotInstalled
        return
    }

    $ConfigDefaultUPN = $Config['DefaultUserPrincipalName']

    try {
        Import-Module SkypeOnlineConnector
    }
    catch {
        $ErrorMessage = $_.Exception.Message
        Write-Error -Message "Could not import module SkypeOnlineConnector.`n$ErrorMessage" -Category ConnectionError
        Break
    }
    try {
        if ($ConfigDefaultUPN) {
            Write-Verbose -Message "Connecting to S4B with $ConfigDefaultUPN"
            $sfbSession = New-CsOnlineSession $ConfigDefaultUPN
        }
        else {
            Write-Verbose -Message "Connecting to S4B with UPN prompt"
            $sfbSession = New-CsOnlineSession
        }
        Import-PSSession $sfbSession
    }
    catch {
        $ErrorMessage = $_.Exception.Message
        Write-Error -Message "Could not connect to $ServiceItem.`n$ErrorMessage" -Category ConnectionError
        Break
    }
    # set service name into window title if successfully connected
    Set-WindowTitle -Service $ServiceItem
}
function Connect-SCC {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false,Position=1)]
        [PSCredential]
        $Credential
    )

    <#
    .SYNOPSIS
    Connects to Microsoft Security and Comliance Center.
 
    .DESCRIPTION
    Connects to Microsoft Security and Comliance Center.
 
    .PARAMETER Credential
    PSCredential object containing user credentials.
 
    .INPUTS
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
    // <OBJECTTYPE>. TBD.
 
    .EXAMPLE
    PS> Connect-SCC -Credential $Credential
 
    .LINK
    http://github.com/blindzero/Connect-MS365
 
    #>

    # testing if module is available
    while (!(Test-MS365Module -Module $ModuleName)) {
        # and install if not available
        Install-MS365Module -Module $ModuleName
    }

    $ConfigDefaultUPN = $Config['DefaultUserPrincipalName']

    try {
        if ($ConfigDefaultUPN) {
            Write-Verbose -Message "Connecting to SCC with $ConfigDefaultUPN"
            Connect-IPPSSession -UserPrincipalName $ConfigDefaultUPN
        }
        else {
            Write-Verbose -Message "Connecting to SCC with UPN prompt"
            Connect-IPPSSession
        }
    }
    catch {
        $ErrorMessage = $_.Exception.Message
        Write-Error -Message "Could not connect to $ServiceItem.`n$ErrorMessage" -Category ConnectionError
        Break
    }
    # set service name into window title if successfully connected
    Set-WindowTitle -Service $ServiceItem
}
function Connect-SPO {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true,Position = 1)]
        [String]
        $SPOOrgUrl,
        [Parameter(Mandatory=$false,Position = 2)]
        [PSCredential]
        $Credential
    )

    <#
    .SYNOPSIS
    Connects to Microsoft SharePoint Online service.
 
    .DESCRIPTION
    Connects to Microsoft SharePoint Online service.
 
    .PARAMETER SPOOrgUrl
    String object containing the SharePoint Online organization admin Url.
 
    .PARAMETER Credential
    PSCredential object containing user credentials.
 
    .INPUTS
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
    // <OBJECTTYPE>. TBD.
 
    .EXAMPLE
    Description: Connect to SharePoint Online organisation MyName
    PS> Connect-SPO -SPOOrgName https://myname-admin.sharepoint.com
 
    .LINK
    http://github.com/blindzero/Connect-MS365
 
    #>

    # testing if module is available
    while (!(Test-MS365Module -Module $ModuleName)) {
        # and install if not available
        Install-MS365Module -Module $ModuleName
    }

    try {
        $null = Connect-SPOService -Url $SPOOrgUrl -ErrorAction Stop
    }
    catch {
        $ErrorMessage = $_.Exception.Message
        Write-Error -Message "Could not connect to $ServiceItem.`n$ErrorMessage" -Category ConnectionError
        Break
    }
    # set service name into window title if successfully connected
    Set-WindowTitle -Service $ServiceItem
}
function Connect-Teams {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false,Position=1)]
        [PSCredential]
        $Credential
    )

    <#
    .SYNOPSIS
 
    Connects to Microsoft Teams service.
 
    .DESCRIPTION
 
    Connects to Microsoft Teams service.
 
    .PARAMETER Credential
 
    PSCredential object containing user credentials.
 
    .INPUTS
 
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
 
    // <OBJECTTYPE>. TBD.
 
    .EXAMPLE
 
    PS> Connect-Teams -Credential $Credential
 
    .LINK
 
    http://github.com/blindzero/Connect-MS365
 
    #>

    # testing if module is available
    while (!(Test-MS365Module -Module $ModuleName)) {
        # and install if not available
        Install-MS365Module -Module $ModuleName
    }
    try {
        $null = Connect-MicrosoftTeams -ErrorAction Stop
    }
    catch {
        $ErrorMessage = $_.Exception.Message
        Write-Error -Message "Could not connect to $ServiceItem.`n$ErrorMessage" -Category ConnectionError
        Break
    }
    # set service name into window title if successfully connected
    Set-WindowTitle -Service $ServiceItem
}
function Initialize-Config {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$false,Position=1,HelpMessage="Force switch needed if existing config files should be overrided")]
        [switch]$Force = $false
    )

    <#
    .SYNOPSIS
    Initializes Configuration directory and file if not present.
 
    .DESCRIPTION
    Initializes Configuration directory and file if not present.
    Uses default template from modules installation directory and puts it to User scope.
    Can be forced by $Force switch parameter.
 
    .PARAMETER Force
    $Force can be given if the existing files should be overwritten.
 
    .INPUTS
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
    None.
 
    .EXAMPLE
    PS> Initialize-Config
 
    .LINK
    http://github.com/blindzero/Connect-MS365
 
    #>

    # get default config file from module installation path
    $DefaultConfigDir = (Split-Path -Path (Get-Module -Name Connect-MS365).Path -Parent)
    $ConfigFileName = "Connect-MS365.Config.psd1"
    # where the file is within Configuration sub dir
    $DefaultConfigFilePath = "$($DefaultConfigDir)\Configuration\$($ConfigFileName)"
    # destination directory for configfiles
    $ConfigDir = "$($env:LOCALAPPDATA)\Connect-MS365\"
    $ConfigPath = "$($ConfigDir)\$($ConfigFileName)"

    # check if config directory exists
    if (!(Get-Item -Path $ConfigDir -ErrorAction SilentlyContinue)) {
        $null = (New-Item -Path $ConfigDir -ItemType Directory)
        Write-Verbose "Config directory created: $ConfigDir"
    }
    else {
        Write-Verbose "Config directory $ConfigDir already exists. Skipping."
    }

    # if we want to enforce new file OR the file is not existing
    if (($Force) -or (!(Get-Item -Path $ConfigPath -ErrorAction SilentlyContinue))) {
        # we place the default file in our config dir
        Copy-Item -Path $DefaultConfigFilePath -Destination $ConfigPath -Force:$Force
        Write-Verbose "Initialized config file $ConfigPath"
    }
    else {
        # just verbose output that nothing is done
        Write-Verbose "Config file $ConfigPath already exists. Skipping."
    }
}

function Install-MS365Module {
    [CmdletBinding()]
    param (
        # service module to be installed, must be known service
        [Parameter(Mandatory=$true,Position=1)]
        [String]
        $Module
    )

    <#
    .SYNOPSIS
    Installs modules to connect for a given service.
 
    .DESCRIPTION
    Installs modules to connect for a given service.
    ModuleName name needs to be passed.
 
    .PARAMETER Module
    Name of powershell module to install.
 
    .INPUTS
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
    // <OBJECTTYPE>. TBD.
 
    .EXAMPLE
    Install-MS365Module -Module MSOnline
 
    .LINK
    http://github.com/blindzero/Connect-MS365
 
    #>
    
    $InstallChoice = Read-Host -Prompt "Module $Module is not present or update was triggered. Perform Install? (Y/n)"
    If (($InstallChoice.Length -eq 0) -or ($InstallChoice.ToLower() -eq "y")) {
        try {
            Install-Module -Name $Module -Scope CurrentUser -Force -ErrorAction Stop
        }
        catch {
            $ErrorMessage = $_.Exception.Message
            Write-Error -Message "Could not install Module $ModuleName.`n$ErrorMessage" -Category ConnectionError
            Break
        }
        continue
    }
}

function Read-Config {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$False,Position=1,HelpMessage="path and filename to configfile to read")]
        [string]$ConfigFile = "$($env:LOCALAPPDATA)\Connect-MS365\Connect-MS365.Config.psd1"
    )

    <#
    .SYNOPSIS
    Reads Configuration variables from given configfile.
 
    .DESCRIPTION
    Reads Configuration variables from given configfile.
    Uses default config dir place, if no other configfile path is passed.
 
    .PARAMETER ConfigFile
    String parameter for configuration path and file to read configuration from.
 
    .INPUTS
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
    None.
 
    .EXAMPLE
    PS> Read-Config
 
    .LINK
    http://github.com/blindzero/Connect-MS365
 
    #>

    # test if given config file is available
    if (Test-Path -Path $ConfigFile) {
        # Import all from given config file
        try {
            $Config = Import-PowerShellDataFile -Path $ConfigFile
            Write-Verbose -Message "Config successfully read from $ConfigFile to `$Config"
            if ($VerbosePreference -eq "Continue") {
                foreach ($ConfEntry in $Config.GetEnumerator()) {
                    Write-Verbose -Message "Config $($ConfEntry.Key) = $($ConfEntry.Value)"
                }
            }
            return $Config 
        }
        catch {
            $ErrorMessage = $_.Exception.Message
            Write-Error -Message "Could not read configfile $ConfigFile.`n$ErrorMessage" -Category OpenError
            throw
        }
    }
    else {
        Write-Error -Message "No config file found at $($ConfigFile). It should be initialized automatically if not existing?!" -Category ObjectNotFound
        throw
    }
}

function Set-WindowTitle {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true,Position=1)]
        [String]
        $Service
    )

    <#
    .SYNOPSIS
 
    Sets Window Title if connection was successful.
 
    .DESCRIPTION
 
    Sets Window Title if connection was successful.
    Adds prefix if not already set.
 
    .PARAMETER Service
    Name of service to put in Window title.
 
    .INPUTS
 
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
 
    // <OBJECTTYPE>. TBD.
 
    .EXAMPLE
 
    Set-WindowTitle -Service MSOL
 
    .LINK
 
    http://github.com/blindzero/Connect-MS365
 
    #>
    If (($host.ui.RawUI.WindowTitle) -notlike "*$ServiceItem*" ) {
        If (($host.ui.RawUI.WindowTitle) -notlike "*Connected To:*") {
                $host.ui.RawUI.WindowTitle += " -- Connected To: $ServiceItem"
        }
        Else {
            $host.ui.RawUI.WindowTitle += " || $ServiceItem"
        }
    }
}
function Test-MS365Module {
    [CmdletBinding()]
    param (
        # service module to be tested, must be known service
        [Parameter(Mandatory=$true,Position=1)]
        [String]
        $Module
    )

    <#
    .SYNOPSIS
    Checks if a module of a given service to connect is installed.
 
    .DESCRIPTION
    Checks if a module of a given service to connect is installed.
    Service name needs to be passed.
 
    .PARAMETER Module
    Name of module to check installation.
 
    .INPUTS
    None. You cannot pipe objects to Add-Extension.
 
    .OUTPUTS
    // <OBJECTTYPE>. TBD.
 
    .EXAMPLE
    Test-MS365Module -Module MSOnline
 
    .LINK
    http://github.com/blindzero/Connect-MS365
 
    #>

    # Set Splatting argument list for Get-Module used to determine if module is existing
    $GetModulesSplat = @{
        ListAvailable = $true
        Verbose          = $false
    }

    # Finding installed module, will be $null if not available on system
    $ModuleInstalled = (Get-Module @GetModulesSplat -Name $ModuleFindString)
    # Extracting Version of installed module
    if ($ModuleInstalled) {
        $ModuleInstalledVer = $ModuleInstalled.Version.ToString()
    }
    # Finding available module online
    $ModuleAvailable = (Find-Module -Name $ModuleFindString -ErrorAction SilentlyContinue)
    # Extracting Version of available module online
    if ($ModuleAvailable) {
        $ModuleAvailableVer = $ModuleAvailable.Version.ToString()
    }

    # initialize $TestResult
    $TestResult = $Null

    # return $false if module is not installed
    If ($null -eq $ModuleInstalled) {
        Write-Verbose "$ModuleName was not found."
        $TestResult = $false
    }
    Else {
        # otherwise compare installed and available version
        If ($ModuleInstalledVer -lt $ModuleAvailableVer) {
            # if newer version is available online prompt for update
            do {
                $confirm = Read-Host -Prompt "New $ModuleName version $ModuleAvailableVer is available (installed: $ModuleInstalledVer). Update? [Y/n]"
                if ($confirm.Length -eq 0) {
                    $confirm = "y"
                }
            } while (($confirm.ToLower() -ne "n") -and ($confirm.ToLower() -ne "y"))
            # if confirmed ...
            If (($confirm.Length -eq 0) -or ($confirm.toLower() -eq "y")) {
                Write-Verbose "Updating Module $ModuleName from $ModuleInstalledVer to $ModuleAvailableVer"
                # return $false to be catched and update triggered
                $TestResult = $false
            }
            # if not confimed only do verbose logging and return true as update is optional
            Else {
                Write-Verbose "Skipping update of $ModuleName"
                $TestResult = $true
            }
        }
        Else {
            Write-Verbose "$ModuleName is latest available version $ModuleAvailableVer"
            $TestResult = $true
        }
    }

    return [Bool]$TestResult
}

# Export only the functions using PowerShell standard verb-noun naming.
# Be sure to list each exported functions in the FunctionsToExport field of the module manifest file.
# This improves performance of command discovery in PowerShell.
Export-ModuleMember -Function Connect-MS365