WilliamLam.com

  • About
    • About
    • Privacy
  • VMware Cloud Foundation
  • VKS
  • Homelab
    • Resources
    • Nested Virtualization
  • VMware Nostalgia
  • Apple
You are here: Home / Automation / Quick Tip - Locating SRM Placeholder VMs using the vSphere API

Quick Tip - Locating SRM Placeholder VMs using the vSphere API

07.26.2017 by William Lam // 5 Comments

I had received a question the other day from a reader where they were trying to distinguish between the running VM and its placeholder VM due to their use of VMware Site Recovery Manager (SRM). Since the VM name is exactly the same in both vCenter Servers, it was not clear how to identify between the two. As mentioned in my reply to the reader, there are a couple of ways. You could use the SRM API in-conjunction with the vSphere API (in his case, he was using PowerCLI) to be able to check whether the VM in question was the placeholder VM or not.

Another option is to simply use the vSphere API and querying for the managedBy property which is populated when SRM and/or other solutions are associated with managing a set of VMs. In the case of SRM, you will see an extensionKey with value of "com.vmware.vcDR" and type with value of "placeholderVm" which tells you that the VM is an SRM Placeholder VM, pretty easy, right!? 🙂

Since I did not have an SRM environment handy, the next best thing was to check out VMware Hands-On-Lab environment which anyone can access for free. Lab HOL-1705-SDC-1 was exactly what I needed and here is a quick screenshot of the vSphere MOB showing you what the managedBy property looks like in the vSphere API.

To demonstrate the use of this vSphere API, I wrote a quick PowerCLI function called PlaceholderVMs.ps1 and below is an example of running the Get-PlaceholderVM command:

More from my site

  • Retrieving vCenter Server certificate (Machine, VMCA Root, STS & Trusted Root) details using the vSphere API 
  • Automating VMware Site Recovery (DRaaS) with VMC
  • Automating Customer Experience Improvement Program (CEIP) configuration using vSphere API and PowerCLI
  • Instant Clone Microsoft Windows & VM Keystroke VMworld demo and code posted
  • Retrieving detailed per-VM space utilization on VSAN

Categories // Automation, PowerCLI, SRM Tags // placeholder VM, PowerCLI, site recovery manager, srm, vSphere API

Comments

  1. *protectedHywel Burris says

    07/26/2017 at 9:48 am

    That's interesting is there anyway to get this information into vROp's.

    Reply
  2. *protectedJason says

    07/26/2017 at 11:07 am

    I love using the labs for things like these, saves me from having to spin up a whole test environment to try something like this... shhh don't tell VMware!

    Reply
  3. *protectedBen Meadowcroft (@BenMeadowcroft) says

    07/26/2017 at 12:55 pm

    Another item to consider is that the extension key will be updated from "placeholderVm" to "testVm" when running a recovery plan test so if they want to differentiate between the protected VM and the placeholder and test VMs that is useful to know.

    I have a few examples of finding placeholder VMs, test VMs, and replicated VMs in my SRM cmdlets on GitHub here -> https://github.com/benmeadowcroft/SRM-Cmdlets/blob/f661cff5833b5a5598e6efb8922a4c77f75206e5/Meadowcroft.Srm.psm1#L123

    Reply
    • *protectedBen Meadowcroft (@BenMeadowcroft) says

      07/26/2017 at 12:57 pm

      To be clear it is the type value associated with the extension key, not the extension key name itself that is updated during testing.

      Reply
  4. *protectedNick Maludy says

    05/08/2020 at 8:30 am

    This is the only way i was able to determine if a VM is a placeholder in an SRM config. Using the SRM API i was not able to get the MOIDs for the VMs on both sides of the replication, SRM API only returns the MOID of the "active" VM. I'm sure SRM has this mapping information internally somewhere, but unfortunately i couldn't find it exposed in the API.

    Thank you for this!

    Reply

Thanks for the comment!Cancel reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Search

Thank Author

Author

William is Distinguished Platform Engineering Architect in the VMware Cloud Foundation (VCF) Division at Broadcom. His primary focus is helping customers and partners build, run and operate a modern Private Cloud using the VMware Cloud Foundation (VCF) platform.

Connect

  • Bluesky
  • Email
  • GitHub
  • LinkedIn
  • Mastodon
  • Reddit
  • RSS
  • Twitter
  • Vimeo

Recent

  • Programmatically accessing the Broadcom Compatibility Guide (BCG) 05/06/2025
  • Quick Tip - Validating Broadcom Download Token  05/01/2025
  • Supported chipsets for the USB Network Native Driver for ESXi Fling 04/23/2025
  • vCenter Identity Federation with Authelia 04/16/2025
  • vCenter Server Identity Federation with Kanidm 04/10/2025

Advertisment

Privacy & Cookies: This site uses cookies. By continuing to use this website, you agree to their use.
To find out more, including how to control cookies, see here: Cookie Policy

Copyright WilliamLam.com © 2025

 

Loading Comments...