AsBuiltReport.Veeam.VBR

0.8.24

Src/Private/Report/Get-AbrVbrServerConnection.ps1

function Get-AbrVbrServerConnection {
    <#
    .SYNOPSIS
    Used by As Built Report to establish conection to Veeam B&R Server.
    .DESCRIPTION
        Documents the configuration of Veeam VBR in Word/HTML/Text formats using PScribo.
    .NOTES
        Version: 0.8.24
        Author: Jonathan Colon
        Twitter: @jcolonfzenpr
        Github: rebelinux
        Credits: Iain Brighton (@iainbrighton) - PScribo module
 
    .LINK
        https://github.com/AsBuiltReport/AsBuiltReport.Veeam.VBR
    #>
    [CmdletBinding()]
    param (

    )

    begin {
        Write-PScriboMessage "Establishing initial connection to Backup Server: $($System)."
        switch ($VbrVersion) {
            { $_ -ge 13 } {
                $Port = 443
            }
            default {
                $Port = $Options.BackupServerPort
            }
        }
    }

    process {
        Write-PScriboMessage 'Looking for veeam existing server connection.'
        #Code taken from @vMarkus_K
        $OpenConnection = (Get-VBRServerSession).Server
        if ($OpenConnection -eq $System) {
            Write-PScriboMessage 'Existing veeam server connection found'
        } elseif ($null -eq $OpenConnection) {
            Write-PScriboMessage 'No existing veeam server connection found'
            try {
                Write-PScriboMessage "Connecting to $($System) with $($Credential.USERNAME) credentials"
                if ($VbrVersion -ge 13) {
                    Connect-VBRServer -Server $System -User $Credential.UserName -Password (ConvertFrom-SecureString -SecureString $Credential.Password -AsPlainText) -Port $Port -ForceAcceptTlsCertificate
                } else {
                    Connect-VBRServer -Server $System -Credential $Credential -Port $Port
                }
            } catch {
                Write-PScriboMessage -IsWarning $_.Exception.Message
                throw "Failed to connect to Veeam Backup Server Host $($System):$($Port) with username $($Credential.USERNAME)"
            }
        } else {
            Write-PScriboMessage "Actual veeam server connection not equal to $($System). Disconecting connection."
            Disconnect-VBRServer
            try {
                Write-PScriboMessage "Trying to open a new connection to $($System)"
                if ($VbrVersion -ge 13) {
                    Connect-VBRServer -Server $System -Credential $Credential -Port $Port -ForceAcceptTlsCertificate
                } else {
                    Connect-VBRServer -Server $System -Credential $Credential -Port $Port
                }
            } catch {
                Write-PScriboMessage -IsWarning $_.Exception.Message
                throw "Failed to connect to Veeam Backup Server Host $($System):$($Port) with username $($Credential.USERNAME)"
            }
        }
        Write-PScriboMessage "Validating connection to $($System)"
        $NewConnection = (Get-VBRServerSession).Server
        if ($null -eq $NewConnection) {
            Write-PScriboMessage -IsWarning $_.Exception.Message
            throw "Failed to connect to Veeam Backup Server Host $($System):$($Port) with username $($Credential.USERNAME)"
        } elseif ($NewConnection) {
            Write-PScriboMessage "Successfully connected to $($System):$($Port) Backup Server."
        }
    }
    end {}
}