VMware

Author: Matt Dawson

description

Runs all VMware modules to collect VMware VM config files, logs and Virtual Hard Disks

includes (3)

paths

8 pathsfrom 3 targets
paths use Windows environment syntax

collection commands

# PowerShell Artifact Collection Script
# Target: VMware
# Run as Administrator

#Requires -RunAsAdministrator

$ErrorActionPreference = "Continue"
$SourceRoot = "C:"
$DestBase   = "D:\Evidence"
$Summary = @{ Copied = 0; Missed = 0; Errors = 0 }

function Collect-Artifact {
    param(
        [Parameter(Mandatory)][string]$SourceDir,
        [Parameter(Mandatory)][string]$FolderName,
        [string]$FileMask = "*"
    )
    # Expand wildcards in any path segment (e.g. 'Program Files*',
    # 'ScreenConnect Client*'). robocopy itself does not glob the source.
    $sources = @(Get-Item -Path $SourceDir -ErrorAction SilentlyContinue |
        Where-Object { $_.PSIsContainer })
    if ($sources.Count -eq 0) {
        $Summary.Missed++
        return
    }
    $FullDest = Join-Path -Path $DestBase -ChildPath $FolderName
    $null = New-Item -ItemType Directory -Force -Path $FullDest -ErrorAction SilentlyContinue
    foreach ($src in $sources) {
        robocopy $src.FullName "$FullDest" "$FileMask" /E /COPY:DAT /R:0 /W:0 /NP /NFL /NDL /NJH /NJS 2>$null | Out-Null
        if ($LASTEXITCODE -le 7) { $Summary.Copied++ } else { $Summary.Errors++ }
    }
}

# 1. VMware (Fusion/Workstation/Server/Player)
Collect-Artifact -SourceDir "C:" -FileMask "*.vmem" -FolderName "VMware_Fusion_Workstation_Server_Player"

# 2. VMware (Fusion/Workstation/Server/Player)
Collect-Artifact -SourceDir "C:" -FileMask "*.vmss" -FolderName "VMware_Fusion_Workstation_Server_Player"

# 3. VMware (Fusion/Workstation/Server/Player)
Collect-Artifact -SourceDir "C:" -FileMask "*.vmsn" -FolderName "VMware_Fusion_Workstation_Server_Player"

# 4. VHD
Collect-Artifact -SourceDir "C:" -FileMask "*.VHD" -FolderName "VHD"

# 5. VHDX
Collect-Artifact -SourceDir "C:" -FileMask "*.VHDX" -FolderName "VHDX"

# 6. VDI
Collect-Artifact -SourceDir "C:" -FileMask "*.VDI" -FolderName "VDI"

# 7. VMDK
Collect-Artifact -SourceDir "C:" -FileMask "*.VMDK" -FolderName "VMDK"

# Iterate every user profile under the source drive
Get-ChildItem "$SourceRoot\Users" -Directory -ErrorAction SilentlyContinue |
    Where-Object { $_.Name -notin @('All Users', 'Default', 'Default User', 'Public') } |
    ForEach-Object {
        $UserName = $_.Name
        # VMware - Virtual Machine Inventory
        $UserPath = "$($_.FullName)\AppData\Roaming\VMware"
        Collect-Artifact -SourceDir $UserPath -FolderName "VMware_Virtual_Machine_Inventory_$UserName"
    }

Write-Host ("Collection complete. Copied: {0}  Missed: {1}  Errors: {2}" -f $Summary.Copied, $Summary.Missed, $Summary.Errors) -ForegroundColor Green

Save as .ps1 and run as Administrator. Use: powershell -ExecutionPolicy Bypass -File script.ps1

Note: This is a compound target that references 3 other targets. The KAPE command resolves them natively; the PowerShell/Batch/WSL scripts flatten every referenced path into explicit copy commands.