Ok, I understand this one is done “to death” already, but anyway, here is my take on it. I had a need for something a bit more optimized than the Get-Snapshot command, so I had to use Get-View. I also needed the possibility of either getting all snapshots, or filter on VM name.
So here it is:
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
function Get-VMWareSnapshot { | |
[CmdletBinding()] | |
param ( | |
# vSphere server(s) to connect to | |
[Parameter()] | |
[string[]] $VIServer, | |
# Filter snapshots on VM Name | |
[Parameter()] | |
[string[]] $VMName | |
) | |
try { | |
# Check if VMWare snapin is loaded, and load it if it's not | |
if ((Get-PSSnapin –Name 'VMWare.VimAutomation.Core' –ErrorAction 'SilentlyContinue') -eq $null) { | |
Add-PSSnapin –Name 'VMWare.VimAutomation.Core' | |
Write-Verbose 'VMWare.VimAutomation.Core snapin loaded' | |
} | |
if ($PSBoundParameters['VIServer']) { | |
# Connect to VIserver(s) | |
Connect-VIServer –Server $VIServer –WarningAction 'SilentlyContinue' | Out-Null | |
Write-Verbose 'Connected to VIServer(s)' | |
} | |
if ($PSBoundParameters['VMName']) { | |
# if more than one name is given, generate correct regex for the filtering | |
if ($VMName.Length -gt 1) { | |
$regexString = ($VMName | ForEach-Object {"($($_)`$)"}) -Join '|' | |
$snapshots = Get-View –ViewType 'VirtualMachine' –Property Name,Snapshot –Filter @{"Name"=$regexString;"Snapshot"="VMware.Vim.VirtualMachineSnapshotinfo"} | |
} | |
# if only one name is given, the filter is easier | |
else { | |
$snapshots = Get-View –ViewType 'VirtualMachine' –Property Name,Snapshot –Filter @{"Name"="$($VMName)`$";"Snapshot"="VMware.Vim.VirtualMachineSnapshotinfo"} | |
} | |
Write-Verbose 'Got data from vSphere' | |
} | |
# if the name parameter is not used, no filtering is done | |
else { | |
$snapshots = Get-View –ViewType 'VirtualMachine' –Property Name,Snapshot –Filter @{"Snapshot"="VMware.Vim.VirtualMachineSnapshotinfo"} | |
Write-Verbose 'Got data from vSphere' | |
} | |
if ($snapshots) { | |
foreach ($snapshot in $snapshots){ | |
Write-Output (,([PSCustomObject] [Ordered] @{ | |
VMName = $snapshot.Name | |
Name = (($snapshot.snapshot.rootsnapshotlist | Select-Object Name).Name) | |
Description = (($snapshot.snapshot.rootsnapshotlist | Select-Object Description).Description) | |
CreateTime = (($snapshot.snapshot.rootsnapshotlist | Select-Object CreateTime).CreateTime) | |
State = (($snapshot.snapshot.rootsnapshotlist | Select-Object State).State) | |
ChildSnapshots = $snapshot.snapshot.rootsnapshotlist.childsnapshotlist | |
})) | |
} | |
} | |
} | |
catch { | |
Write-Warning $_.Exception.Message | |
} | |
} |