The company I work for uses the vSphere API for all kinds of purposes. Usually this works great however one of our programs returned some errors after we moved a large number of VMs from one datastore to another.

It turns out that from vSphere API 5.0 onwards the VirtualMachineStorageInfo object is not always updated properly. The vSphere Web Services API documentation shows the following information about this issue.

Storage space used by the virtual machine, split by datastore. Can be explicitly refreshed by the RefreshStorageInfo operation. In releases after vSphere API 5.0, vSphere Servers might not generate property collector update notifications for this property. To obtain the latest value of the property, you can use PropertyCollector methods RetrievePropertiesEx or WaitForUpdatesEx. If you use the PropertyCollector.WaitForUpdatesEx method, specify an empty string for the version parameter. Any other version value will not produce any property values as no updates are generated.

To trigger the the RefreshStorageInfo operation that supposedly fixes the issue I wrote a simple PowerCLI function.

function Update-VMStorageInfo {
  [cmdletbinding()] #This provides the function with the -Verbose and -Debug parameters
      [parameter(Mandatory=$true, ValueFromPipeline=$true)]$Age
  # Get current date and time
  $StartDate = (Get-Date)
  # Collect VM inventory
  $VMs = get-view -ViewType "VirtualMachine" -Property @("name", "storage")
  foreach ($VM in $VMs) {
    $StorageInfoAge = (New-TimeSpan -Start $StartDate -End $
    if ($StorageInfoAge -lt (-$Age)) {
      write-host "VirtualMachineStorageInfo on" $ "needs to be updated"

After you added this function to a PowerCLI session you can run it with an ‘Age’ parameter. This parameter determines the maximum age of the StorageInfo timestamp in hours. If the StorageInfo of a VM is older than the number of hours specified in the Age parameter it will be updated.

Rudolf Kleijwegt

I am an experienced IT professional with over 20 years of hands-on experience designing, deploying, and maintaining IT infrastructure in both enterprise and service provider environments. My skills span across Linux and Windows and a multitude of server applications, allowing me to excel in a wide range of IT roles. Currently, my primary focus is on Software Defined DataCenter and DevOps. I am passionate about staying up to date with the latest trends in the industry to achieve superior outcomes.


Leave a Reply

Avatar placeholder

Your email address will not be published. Required fields are marked *