Apps/Get-VMwareTools.ps1

function Get-VMwareTools {
    <#
        .SYNOPSIS
            Get the current version and download URL for the VMware Tools.

        .NOTES
            Author: Bronson Magnan
            Twitter: @cit_bronson
    #>

    [OutputType([System.Management.Automation.PSObject])]
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="Product name is a plural")]
    [CmdletBinding(SupportsShouldProcess = $False)]
    param (
        [Parameter(Mandatory = $False, Position = 0)]
        [ValidateNotNull()]
        [System.Management.Automation.PSObject]
        $res = (Get-FunctionResource -AppName ("$($MyInvocation.MyCommand)".Split("-"))[1])
    )

    # Read the VMware version-mapping file
    $params = @{
        Uri         = $res.Get.Update.Uri
        ContentType = $res.Get.Update.ContentType
        Raw         = $true
    }
    $Content = Invoke-EvergreenWebRequest @params

    if ($null -ne $Content) {
        # Format the results returns and convert into an array that we can sort and use
        Write-Verbose -Message "$($MyInvocation.MyCommand): Filtering version table with $($Content.Count) lines."
        $Lines = $Content | Where-Object { $_ -notmatch "^#" }
        Write-Verbose -Message "$($MyInvocation.MyCommand): Filtered to $($Lines.Count) lines."

        Write-Verbose -Message "$($MyInvocation.MyCommand): Selecting first 20 lines."
        $Lines = $Lines | Select-Object -First 20

        Write-Verbose -Message "$($MyInvocation.MyCommand): Convert to table."
        try {
            # Lines with ESXi server version 'esx/0.0' are missing column 3: ESXi server build number, so set this to '0' to not break table creation.
            # The ESXi server build number, even if set to 0, will not be used further in the process.
            $Lines = $Lines | ForEach-Object { $_ -replace 'esx/0.0', 'esx/0.0 0' }
            $Lines = $Lines | ForEach-Object { $_ -replace '\s+', ',' }
            $VersionTable = $Lines | ConvertFrom-Csv -Delimiter "," -Header $res.Get.Update.CsvHeaders | `
                Sort-Object -Property @{ Expression = { [System.Version]$_.Version }; Descending = $true }
        }
        catch {
            Write-Error -Message "$($MyInvocation.MyCommand): Failed to convert version source to a table."
        }

        $LatestVersion = $VersionTable | Select-Object -First 1
        Write-Verbose -Message "$($MyInvocation.MyCommand): Found version: $($LatestVersion.Version)-$($LatestVersion.ClientBuild)"

        # Build the output object for each platform and architecture
        foreach ($architecture in $res.Get.Download.Architecture.GetEnumerator()) {

            # Build the output object
            $PSObject = [PSCustomObject] @{
                Version      = $LatestVersion.Version
                Architecture = $architecture.Key
                URI          = $res.Get.Download.Uri -replace "#architecture", $architecture.Key `
                    -replace "#version", $LatestVersion.Version `
                    -replace "#build", $LatestVersion.ClientBuild `
                    -replace "#processor", $res.Get.Download.Architecture[$architecture.Key]
            }
            Write-Output -InputObject $PSObject
        }
    }
}