Veeam.Diagrammer

0.6.14

Src/Private/Get-VbrRequiredModule.ps1

function Get-VbrRequiredModule {
    <#
    .SYNOPSIS
        Function to check if the required version of Veeam.Backup.PowerShell is installed
    .DESCRIPTION
        Build a diagram of the configuration of Veeam VBR in PDF/PNG/SVG formats using Psgraph.
    .NOTES
        Version: 0.6.1
        Author: Jonathan Colon
        Twitter: @jcolonfzenpr
        Github: rebelinux
    .LINK
        https://github.com/rebelinux/Veeam.Diagrammer
    #>
    [CmdletBinding()]

    Param
    (
        [Parameter(Mandatory = $true, ValueFromPipeline = $false)]
        [ValidateNotNullOrEmpty()]
        [String]
        $Name,

        [Parameter(Mandatory = $true, ValueFromPipeline = $false)]
        [ValidateNotNullOrEmpty()]
        [String]
        $Version
    )
    process {
        #region: Start Load VEEAM Snapin / Module
        # Loading Module or PSSnapin
        # Make sure PSModulePath includes Veeam Console
        #Code taken from @vMarkus_K
        $MyModulePath = "C:\Program Files\Veeam\Backup and Replication\Console\"
        $env:PSModulePath = $env:PSModulePath + "$([System.IO.Path]::PathSeparator)$MyModulePath"
        if ($Modules = Get-Module -ListAvailable -Name Veeam.Backup.PowerShell) {
            try {
                Write-Verbose -Message "Trying to import Veeam B&R modules."
                $Modules | Import-Module -WarningAction SilentlyContinue -Verbose:$false
            } catch {
                Write-Verbose -Message "Failed to load Veeam Modules"
            }
        } else {
            try {
                Write-Verbose -Message "No Veeam Modules found, Fallback to SnapIn."
                Add-PSSnapin -Name VeeamPSSnapIn -PassThru -ErrorAction Stop | Out-Null
            } catch {
                Write-Verbose -Message "Failed to load VeeamPSSnapIn and no Modules found"
            }
        }
        if ($Module = Get-Module -ListAvailable -Name Veeam.Backup.PowerShell) {
            try {
                Write-Verbose -Message "Identifying Veeam Powershell module version."
                switch ([string]::IsNullOrEmpty($Module.Version.ToString())) {
                    $false { $VbrVersion = $Module.Version.ToString() }
                    $true { $VbrVersion = "Unable to get Module version" }
                    Default { $VbrVersion = "Unknown" }
                }
                Write-Verbose -Message "Using Veeam Powershell module version $($VbrVersion)."
            } catch {
                Write-Verbose -Message "Failed to get Version from Module"
            }
        } else {
            try {
                Write-Verbose -Message "No Veeam Modules found, Fallback to SnapIn."
                [int]$VbrVersion = (Get-PSSnapin VeeamPSSnapin -ErrorAction SilentlyContinue).PSVersion.ToString()
            } catch {
                Write-Verbose -Message "Failed to get Version from Module or SnapIn"
            }
        }
        # Check if the required version of VMware PowerCLI is installed
        $RequiredModule = Get-Module -ListAvailable -Name $Name | Sort-Object -Property Version -Descending | Select-Object -First 1
        $ModuleVersion = "$($RequiredModule.Version.Major)" + "." + "$($RequiredModule.Version.Minor)"
        if ($ModuleVersion -eq ".") {
            throw "$Name $Version or higher is required to run the Veeam VBR As Built Report. Install the Veeam Backup & Replication console that provide the required modules."
        }
        if ($ModuleVersion -lt $Version) {
            throw "$Name $Version or higher is required to run the Veeam VBR As Built Report. Update the Veeam Backup & Replication console that provide the required modules."
        }
    }
    end {}
}