Optimize-VirtualDisk

2024.6.2

Private/ProcessVirtualDiskPath.ps1

                                $Script:DirectoryIterationMessage = "Checking directory '{0}' for any virtual hard disks (with Filter '{1}')."

function ProcessVirtualDiskPath {

    [CmdletBinding(SupportsShouldProcess)]

    param (

        [Parameter(Mandatory, Position = 0, ParameterSetName = "Path")]

        [ValidateNotNullOrEmpty()]

        [string]

        $Path,

        [Parameter(Mandatory, Position = 0, ParameterSetName = "LiteralPath")]

        [ValidateNotNullOrEmpty()]

        [string]

        $LiteralPath,

        [Parameter()]

        [string]

        $Filter

    )

    $directoryFilter = if (![string]::IsNullOrWhiteSpace($Filter)) { $Filter } else { "*.vhdx" }

    if ($PSBoundParameters.ContainsKey("Path")) {

        # ErrorAction SilentlyContinue is used here to not output multiple errors.

        $resolvedPaths = Resolve-Path -Path $Path -ErrorAction SilentlyContinue -ErrorVariable err

        if ($err) {

            Write-Error "Failed to resolve path $Path via Resolve-Path. The error was: $err"

            return

        } elseif (!$resolvedPaths) {

            Write-Warning "No items found after resolving path $Path via Resolve-Path."

            return

        }

        foreach ($resolvedPath in $resolvedPaths) {

            if (!(TestVHDFileValid $resolvedPath)) {

                continue

            }

            $item = Get-Item -LiteralPath $resolvedPath

            if ($null -eq $item) {

                Write-Verbose "Get-Item returned `$null for resolved path $resolvedPath."

                continue

            }

            if ($item -is [System.IO.FileInfo]) {

                if ($PSCmdlet.ShouldProcess($item.FullName, "Optimize-VirtualDisk")) {

                    OptimizeVirtualDisk -FilePath $item.FullName

                }

            } elseif ($item -is [System.IO.DirectoryInfo]) {

                $splat = @{

                    "LiteralPath" = "$resolvedPath"

                    "Filter" = $directoryFilter

                    "File" = $true

                }

                $directoryFiles = Get-ChildItem @splat

                if (!$directoryFiles) {

                    Write-Warning "No files found in resolved path '$resolvedPath' matching filter '$directoryFilter'."

                    continue

                }

                Write-Verbose ($Script:DirectoryIterationMessage -f $resolvedPath,$directoryFilter)

                foreach ($directoryFile in $directoryFiles) {

                    if (!(TestVHDFileValid $directoryFile.FullName)) {

                        continue

                    }

                    if ($PSCmdlet.ShouldProcess($directoryFile.FullName, "Optimize-VirtualDisk")) {

                        OptimizeVirtualDisk -FilePath $directoryFile.FullName

                    }

                }

            } else {

                $convertedResult = "$item"

                Write-Warning "Get-Item returned an unhandled type $($item.GetType()) from the path $resolvedPath. Treating it as a string and hoping for the best (it evaluated to '$convertedResult' as a string)."

                if ($PSCmdlet.ShouldProcess($convertedResult, "Optimize-VirtualDisk")) {

                    OptimizeVirtualDisk -FilePath $convertedResult

                }

            }

        }

    } elseif ($PSBoundParameters.ContainsKey("LiteralPath")) {

        if (!(TestVHDFileValid $LiteralPath)) {

            return

        }

        if (!(Test-Path -LiteralPath $LiteralPath)) {

            Write-Error "Failed to find file from literal path $LiteralPath (Test-Path evaluated to false)."

            return

        }

        $item = Get-Item -LiteralPath $LiteralPath

        if ($null -eq $item) {

            Write-Verbose "Get-Item returned `$null for literal path $LiteralPath."

            return

        }

        if ($item -is [System.IO.FileInfo]) {

            if ($PSCmdlet.ShouldProcess($item.FullName, "Optimize-VirtualDisk")) {

                OptimizeVirtualDisk -FilePath $item.FullName

            }

        } elseif ($item -is [System.IO.DirectoryInfo]) {

            $splat = @{

                "LiteralPath" = $LiteralPath

                "Filter" = $directoryFilter

                "File" = $true

            }

            $directoryFiles = Get-ChildItem @splat

            if (!$directoryFiles) {

                Write-Warning "No files found in literal path '$LiteralPath' matching filter '$directoryFilter'."

                continue

            }

            Write-Verbose ($Script:DirectoryIterationMessage -f $LiteralPath,$directoryFilter)

            foreach ($directoryFile in $directoryFiles) {

                if (!(TestVHDFileValid $directoryFile.FullName)) {

                    continue

                }

                if ($PSCmdlet.ShouldProcess($directoryFile.FullName, "Optimize-VirtualDisk")) {

                    OptimizeVirtualDisk -FilePath $directoryFile.FullName

                }

            }

        } else {

            $convertedResult = "$item"

            Write-Warning "Get-Item returned an unhandled type $($item.GetType()) from the literal path $providedLiteralPath. Treating it as a string and hoping for the best (it evaluated to '$convertedResult' as a string)."

            if ($PSCmdlet.ShouldProcess($convertedResult, "Optimize-VirtualDisk")) {

                OptimizeVirtualDisk -FilePath $convertedResult

            }

        }

    } else {

        # Sanity check.

        Write-Error "Missing both Path and LiteralPath parameters in ProcessVirtualDiskPath! Please report this."

    }

}

# Copyright (c) 2024 AJ Tek Corporation. All Rights Reserved.

# SIG # Begin signature block

# MIIVmwYJKoZIhvcNAQcCoIIVjDCCFYgCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUBlZ64wkYzJb8BnGxj4M6apFb

# m1CgghH7MIIFbzCCBFegAwIBAgIQSPyTtGBVlI02p8mKidaUFjANBgkqhkiG9w0B

# AQwFADB7MQswCQYDVQQGEwJHQjEbMBkGA1UECAwSR3JlYXRlciBNYW5jaGVzdGVy

# MRAwDgYDVQQHDAdTYWxmb3JkMRowGAYDVQQKDBFDb21vZG8gQ0EgTGltaXRlZDEh

# MB8GA1UEAwwYQUFBIENlcnRpZmljYXRlIFNlcnZpY2VzMB4XDTIxMDUyNTAwMDAw

# MFoXDTI4MTIzMTIzNTk1OVowVjELMAkGA1UEBhMCR0IxGDAWBgNVBAoTD1NlY3Rp

# Z28gTGltaXRlZDEtMCsGA1UEAxMkU2VjdGlnbyBQdWJsaWMgQ29kZSBTaWduaW5n

# IFJvb3QgUjQ2MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAjeeUEiIE

# JHQu/xYjApKKtq42haxH1CORKz7cfeIxoFFvrISR41KKteKW3tCHYySJiv/vEpM7

# fbu2ir29BX8nm2tl06UMabG8STma8W1uquSggyfamg0rUOlLW7O4ZDakfko9qXGr

# YbNzszwLDO/bM1flvjQ345cbXf0fEj2CA3bm+z9m0pQxafptszSswXp43JJQ8mTH

# qi0Eq8Nq6uAvp6fcbtfo/9ohq0C/ue4NnsbZnpnvxt4fqQx2sycgoda6/YDnAdLv

# 64IplXCN/7sVz/7RDzaiLk8ykHRGa0c1E3cFM09jLrgt4b9lpwRrGNhx+swI8m2J

# mRCxrds+LOSqGLDGBwF1Z95t6WNjHjZ/aYm+qkU+blpfj6Fby50whjDoA7NAxg0P

# OM1nqFOI+rgwZfpvx+cdsYN0aT6sxGg7seZnM5q2COCABUhA7vaCZEao9XOwBpXy

# bGWfv1VbHJxXGsd4RnxwqpQbghesh+m2yQ6BHEDWFhcp/FycGCvqRfXvvdVnTyhe

# Be6QTHrnxvTQ/PrNPjJGEyA2igTqt6oHRpwNkzoJZplYXCmjuQymMDg80EY2NXyc

# uu7D1fkKdvp+BRtAypI16dV60bV/AK6pkKrFfwGcELEW/MxuGNxvYv6mUKe4e7id

# FT/+IAx1yCJaE5UZkADpGtXChvHjjuxf9OUCAwEAAaOCARIwggEOMB8GA1UdIwQY

# MBaAFKARCiM+lvEH7OKvKe+CpX/QMKS0MB0GA1UdDgQWBBQy65Ka/zWWSC8oQEJw

# IDaRXBeF5jAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zATBgNVHSUE

# DDAKBggrBgEFBQcDAzAbBgNVHSAEFDASMAYGBFUdIAAwCAYGZ4EMAQQBMEMGA1Ud

# HwQ8MDowOKA2oDSGMmh0dHA6Ly9jcmwuY29tb2RvY2EuY29tL0FBQUNlcnRpZmlj

# YXRlU2VydmljZXMuY3JsMDQGCCsGAQUFBwEBBCgwJjAkBggrBgEFBQcwAYYYaHR0

# cDovL29jc3AuY29tb2RvY2EuY29tMA0GCSqGSIb3DQEBDAUAA4IBAQASv6Hvi3Sa

# mES4aUa1qyQKDKSKZ7g6gb9Fin1SB6iNH04hhTmja14tIIa/ELiueTtTzbT72ES+

# BtlcY2fUQBaHRIZyKtYyFfUSg8L54V0RQGf2QidyxSPiAjgaTCDi2wH3zUZPJqJ8

# ZsBRNraJAlTH/Fj7bADu/pimLpWhDFMpH2/YGaZPnvesCepdgsaLr4CnvYFIUoQx

# 2jLsFeSmTD1sOXPUC4U5IOCFGmjhp0g4qdE2JXfBjRkWxYhMZn0vY86Y6GnfrDyo

# XZ3JHFuu2PMvdM+4fvbXg50RlmKarkUT2n/cR/vfw1Kf5gZV6Z2M8jpiUbzsJA8p

# 1FiAhORFe1rYMIIGGjCCBAKgAwIBAgIQYh1tDFIBnjuQeRUgiSEcCjANBgkqhkiG

# 9w0BAQwFADBWMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVk

# MS0wKwYDVQQDEyRTZWN0aWdvIFB1YmxpYyBDb2RlIFNpZ25pbmcgUm9vdCBSNDYw

# HhcNMjEwMzIyMDAwMDAwWhcNMzYwMzIxMjM1OTU5WjBUMQswCQYDVQQGEwJHQjEY

# MBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSswKQYDVQQDEyJTZWN0aWdvIFB1Ymxp

# YyBDb2RlIFNpZ25pbmcgQ0EgUjM2MIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIB

# igKCAYEAmyudU/o1P45gBkNqwM/1f/bIU1MYyM7TbH78WAeVF3llMwsRHgBGRmxD

# eEDIArCS2VCoVk4Y/8j6stIkmYV5Gej4NgNjVQ4BYoDjGMwdjioXan1hlaGFt4Wk

# 9vT0k2oWJMJjL9G//N523hAm4jF4UjrW2pvv9+hdPX8tbbAfI3v0VdJiJPFy/7Xw

# iunD7mBxNtecM6ytIdUlh08T2z7mJEXZD9OWcJkZk5wDuf2q52PN43jc4T9OkoXZ

# 0arWZVeffvMr/iiIROSCzKoDmWABDRzV/UiQ5vqsaeFaqQdzFf4ed8peNWh1OaZX

# nYvZQgWx/SXiJDRSAolRzZEZquE6cbcH747FHncs/Kzcn0Ccv2jrOW+LPmnOyB+t

# AfiWu01TPhCr9VrkxsHC5qFNxaThTG5j4/Kc+ODD2dX/fmBECELcvzUHf9shoFvr

# n35XGf2RPaNTO2uSZ6n9otv7jElspkfK9qEATHZcodp+R4q2OIypxR//YEb3fkDn

# 3UayWW9bAgMBAAGjggFkMIIBYDAfBgNVHSMEGDAWgBQy65Ka/zWWSC8oQEJwIDaR

# XBeF5jAdBgNVHQ4EFgQUDyrLIIcouOxvSK4rVKYpqhekzQwwDgYDVR0PAQH/BAQD

# AgGGMBIGA1UdEwEB/wQIMAYBAf8CAQAwEwYDVR0lBAwwCgYIKwYBBQUHAwMwGwYD

# VR0gBBQwEjAGBgRVHSAAMAgGBmeBDAEEATBLBgNVHR8ERDBCMECgPqA8hjpodHRw

# Oi8vY3JsLnNlY3RpZ28uY29tL1NlY3RpZ29QdWJsaWNDb2RlU2lnbmluZ1Jvb3RS

# NDYuY3JsMHsGCCsGAQUFBwEBBG8wbTBGBggrBgEFBQcwAoY6aHR0cDovL2NydC5z

# ZWN0aWdvLmNvbS9TZWN0aWdvUHVibGljQ29kZVNpZ25pbmdSb290UjQ2LnA3YzAj

# BggrBgEFBQcwAYYXaHR0cDovL29jc3Auc2VjdGlnby5jb20wDQYJKoZIhvcNAQEM

# BQADggIBAAb/guF3YzZue6EVIJsT/wT+mHVEYcNWlXHRkT+FoetAQLHI1uBy/YXK

# ZDk8+Y1LoNqHrp22AKMGxQtgCivnDHFyAQ9GXTmlk7MjcgQbDCx6mn7yIawsppWk

# vfPkKaAQsiqaT9DnMWBHVNIabGqgQSGTrQWo43MOfsPynhbz2Hyxf5XWKZpRvr3d

# MapandPfYgoZ8iDL2OR3sYztgJrbG6VZ9DoTXFm1g0Rf97Aaen1l4c+w3DC+IkwF

# kvjFV3jS49ZSc4lShKK6BrPTJYs4NG1DGzmpToTnwoqZ8fAmi2XlZnuchC4NPSZa

# PATHvNIzt+z1PHo35D/f7j2pO1S8BCysQDHCbM5Mnomnq5aYcKCsdbh0czchOm8b

# kinLrYrKpii+Tk7pwL7TjRKLXkomm5D1Umds++pip8wH2cQpf93at3VDcOK4N7Ew

# oIJB0kak6pSzEu4I64U6gZs7tS/dGNSljf2OSSnRr7KWzq03zl8l75jy+hOds9TW

# SenLbjBQUGR96cFr6lEUfAIEHVC1L68Y1GGxx4/eRI82ut83axHMViw1+sVpbPxg

# 51Tbnio1lB93079WPFnYaOvfGAA0e0zcfF/M9gXr+korwQTh2Prqooq2bYNMvUoU

# KD85gnJ+t0smrWrb8dee2CvYZXD5laGtaAxOfy/VKNmwuWuAh9kcMIIGZjCCBM6g

# AwIBAgIRAMyLU7NDPs1zQXTEeYo/k2YwDQYJKoZIhvcNAQEMBQAwVDELMAkGA1UE

# BhMCR0IxGDAWBgNVBAoTD1NlY3RpZ28gTGltaXRlZDErMCkGA1UEAxMiU2VjdGln

# byBQdWJsaWMgQ29kZSBTaWduaW5nIENBIFIzNjAeFw0yMjA2MzAwMDAwMDBaFw0y

# NTA2MjkyMzU5NTlaMFkxCzAJBgNVBAYTAkNBMRAwDgYDVQQIDAdPbnRhcmlvMRsw

# GQYDVQQKDBJBSiBUZWsgQ29ycG9yYXRpb24xGzAZBgNVBAMMEkFKIFRlayBDb3Jw

# b3JhdGlvbjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAOLV0fXklSI7

# zs4Awbc5rzQGG/XJaEgZLEXFVvzqKWlApLYSdXMLTzW14/IEoVMmi+qunmgIF98c

# 3gUFm6dTSkf+ccSIWgHwjD/pPMX4leIO1Qen+OBup4p33XRNqHsWLzBqlWmKRcLW

# 5cyRDRXedgZDvZozhxTqLhk0tFdTcBoGULA13Z/TfotbwNCx05W304VgluUogNX2

# 4yv80QYmHa6667ewXuAPNiPWQgFE4fyXOvFsRUFEtllRZmUpOPqZtGURw2ZYd+cZ

# UFn4QrC9DzlESFEjQzMMF5iUjrKCI25jq53MkTZHnOjO9KGH5SvcLo5CbgNptpzr

# d1P7AsoHFedvErNbp6YOhKrkv7F0ksVgqBh1v2Yc1ShpzZBEJ6pL+QsdnWzl6Wzb

# B8xEYEdbNF0A0/kyFHm2tYSxxCsVO4caoL2CcsA3q/1h73MBWEcNT2fV6o25L+LY

# sNUkFRc6ZRqOQ/ub9na8jCOwuhxi8MXTGo22Crinp5bbzYA/liNm97G77mJe59za

# aaoulTWzk5y06k7VgLDYtR7IgZ47Aytnj/jr7S5/P/1F2K3lbRUdGyKdifubSgjk

# m1gubK0cm3Y6L7Ar2X1nBm+PpAZqA54jQBs9cV03MVDjZb3AvjooCi9uOCJ4998U

# TV9Sn2873/GUXE6dRB+w0fD/FcUxX2pjAgMBAAGjggGsMIIBqDAfBgNVHSMEGDAW

# gBQPKssghyi47G9IritUpimqF6TNDDAdBgNVHQ4EFgQU0JE9KqcvG1A1pTeA+vcd

# t1flqK0wDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwEwYDVR0lBAwwCgYI

# KwYBBQUHAwMwSgYDVR0gBEMwQTA1BgwrBgEEAbIxAQIBAwIwJTAjBggrBgEFBQcC

# ARYXaHR0cHM6Ly9zZWN0aWdvLmNvbS9DUFMwCAYGZ4EMAQQBMEkGA1UdHwRCMEAw

# PqA8oDqGOGh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2VjdGlnb1B1YmxpY0NvZGVT

# aWduaW5nQ0FSMzYuY3JsMHkGCCsGAQUFBwEBBG0wazBEBggrBgEFBQcwAoY4aHR0

# cDovL2NydC5zZWN0aWdvLmNvbS9TZWN0aWdvUHVibGljQ29kZVNpZ25pbmdDQVIz

# Ni5jcnQwIwYIKwYBBQUHMAGGF2h0dHA6Ly9vY3NwLnNlY3RpZ28uY29tMCEGA1Ud

# EQQaMBiBFmFqLmFjY291bnRpbmdAYWp0ZWsuY2EwDQYJKoZIhvcNAQEMBQADggGB

# ACa/QJzMPVDohIgQtL4/Yr7z7DlaybhjLQ2gEx7pU6G/hNQ+kClqLR3hykkJ7fwZ

# 4cYX1TF4JWnkmQ0GZwj5bk5RaSyDatQVVIW8AQNMIEEhUftHJn1REz16CzXxlgzd

# d+GTqYmwommBa6DlFO88fwF0FL3KJgvNguQGSU9sGIGUWyQuxqFUwXRgsXpwQbpR

# 1H6qsViLN1SGPXO+iqUSyejmd9mIbc8b0IxuR6rDtU2PIcU8XzwsJv8M/L1paQut

# 4m7dNw54gsoRVp+KJWawkkEVM6xvszCo8VIk8ZGetRCBT+ZSunIb/LFripb++lR8

# tIBkq8zYEhEp9U8GQZbKNZzfelix4kRt5wUq39rpBU8aHoU4GRXFs571jb/qBz/x

# AVckN5cosppJxe+AW/TR9qKrL8uKOJ9cCLRXjPdLGSmHA5XMN6ecgRE+yfLMOauX

# pUo33dCGh36TZuSi7P4uz2trEEUfmaQlr/TEp0xtbgUxTopdUYh9xagN4bbkRmoB

# izGCAwowggMGAgEBMGkwVDELMAkGA1UEBhMCR0IxGDAWBgNVBAoTD1NlY3RpZ28g

# TGltaXRlZDErMCkGA1UEAxMiU2VjdGlnbyBQdWJsaWMgQ29kZSBTaWduaW5nIENB

# IFIzNgIRAMyLU7NDPs1zQXTEeYo/k2YwCQYFKw4DAhoFAKB4MBgGCisGAQQBgjcC

# AQwxCjAIoAKAAKECgAAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYB

# BAGCNwIBCzEOMAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkEMRYEFIyeaWFiK3lb

# 1bblEukUis1sTfxQMA0GCSqGSIb3DQEBAQUABIICAFPxVUuM3zrzsYzh0sLbAP5b

# qfPSCjXYI8hkWF0kDNlYB0bm78IGMQVEplC2Wj3mT0+dA64cz9Pkyh3dibv6yxzh

# xO/AzYmMtd5Y2N0JD0XK/jVqGknZ18IQD+RBJIVnqfEd94tTqStT142112TuiI4J

# xjgVRvfFkeCzuQVYn+1B+sNDqeItScmkBLVG6fdUjoIqCSuaj7k7/XKvECaeuA5H

# PT60BjlVXSAPaCBuwYmTnEyMihKHfKgB1vpD+3Rjpubst6QY7N5hZR550iTNGy2M

# 4dGKSN4By6/KKn11hAk55rV1CjFHomgH/avX511SFT4uHY7cwLIQrdCmr6YKDnyZ

# IEmBuQrRnLl+YkMBrb77oNPjoMFpuzlNSxuw+Y2mQCLH9aWNW2sdnhxF816eTv1L

# wzdXzKxZNkX1G9CT3Ytdwuq96GcZfvpCa8eEpSLfLX9Q2Oks24kqhu2YM9udJ2pl

# 18MBl/AxJHWyqsj4xNxbNdG+oGIgX8XJp0EnC3zHDG/A8qAfJ9FsJXnI6NPRi+cx

# Tb9/LFKmGw89yXIlgqoElrZ3+OSf/0ellik4ydGQTbrOy7OyN1if0sJabTP0VEQ0

# 792KuEp0SkzWWYE5RrSnag+zjyuIKdhffYeNLjAIRQaRoQbOPigREXEtn2qgzUNu

# W66OJgAG9DguwyZFAGhW

# SIG # End signature block