Added Get-PDCImage function

Author: sanderstad

PSDatabaseClone.psd1

@@ -71,7 +71,8 @@
     'Remove-PDCClone',
 	'Remove-PDCImage',
     'Set-PDCConfiguration',
-    'Get-PDCClone'
+    'Get-PDCClone',
+    'Get-PDCImage'
 
     # Cmdlets to export from this module
     CmdletsToExport   = ''

functions/Get-PDCImage.ps1

@@ -0,0 +1,122 @@
+function Get-PDCImage {
+    <#
+.SYNOPSIS
+    Get-PDCImage get on or more clones
+
+.DESCRIPTION
+    Get-PDCImage will retrieve the clones and apply filters if needed.
+    By default all the clones are returned
+
+.PARAMETER ImageID
+    Filter based on the image id
+
+.PARAMETER ImageName
+    Filter based on the image name
+
+.PARAMETER ImageLocation
+    Filter based on the image location
+
+.PARAMETER Database
+    Filter based on the database
+
+.NOTES
+    Author: Sander Stad (@sqlstad, sqlstad.nl)
+
+    Website: https://psdatabaseclone.io
+    Copyright: (C) Sander Stad, sander@sqlstad.nl
+    License: MIT https://opensource.org/licenses/MIT
+
+.LINK
+    https://psdatabaseclone.io/
+
+.EXAMPLE
+    Get-PDCImage -ImageName DB1_20180704220944, DB2_20180704221144
+
+    Retrieve the images for DB1_20180704220944, DB2_20180704221144
+
+.EXAMPLE
+    Get-PDCImage -ImageLocation "\\fileserver1\psdatabaseclone\images\DB1_20180704220944.vhdx"
+
+    Get all the images that are the same as the image location
+
+.EXAMPLE
+    Get-PDCImage -Database DB1, DB2
+
+    Get all the images that were made for databases DB1 and DB2
+#>
+
+    [CmdLetBinding()]
+
+    param(
+        [int[]]$ImageID,
+        [string[]]$ImageName,
+        [string[]]$ImageLocation,
+        [string[]]$Database
+    )
+
+    begin {
+        # Test the module database setup
+        try {
+            Test-PDCConfiguration -EnableException
+        }
+        catch {
+            Stop-PSFFunction -Message "Something is wrong in the module configuration" -ErrorRecord $_ -Continue
+        }
+
+        $pdcSqlInstance = Get-PSFConfigValue -FullName psdatabaseclone.database.server
+        $pdcDatabase = Get-PSFConfigValue -FullName psdatabaseclone.database.name
+    }
+
+    process {
+        # Test if there are any errors
+        if (Test-PSFFunctionInterrupt) { return }
+
+        $query = "
+            SELECT ImageID,
+                ImageName,
+                ImageLocation,
+                SizeMB,
+                DatabaseName,
+                DatabaseTimestamp,
+                CreatedOn
+            FROM dbo.Image;
+        "
+
+        try {
+            $results = Invoke-DbaSqlQuery -SqlInstance $pdcSqlInstance -Database $pdcDatabase -Query $query -As PSObject
+        }
+        catch {
+            Stop-PSFFunction -Message "Could not execute query" -ErrorRecord $_ -Target $query
+        }
+
+        # Filter image id
+        if ($ImageID) {
+            $results = $results | Where-Object {$_.ImageID -in $ImageID}
+        }
+
+        # Filter image name
+        if ($ImageName) {
+            $results = $results | Where-Object {$_.ImageName -in $ImageName}
+        }
+
+        # Filter image location
+        if ($ImageLocation) {
+            $results = $results | Where-Object {$_.ImageLocation -in $ImageLocation}
+        }
+
+        # Filter database
+        if ($Database) {
+            $results = $results | Where-Object {$_.DatabaseName -in $Database}
+        }
+
+
+        return $results
+    }
+
+    end {
+        # Test if there are any errors
+        if (Test-PSFFunctionInterrupt) { return }
+
+        Write-PSFMessage -Message "Finished retrieving image(s)" -Level Verbose
+    }
+}