Unprotect-InstantClone.ps1

Unprotects Horizon Instant Clone VMs so they can be moved/migrated/deleted when they are abandoned by Horizon

. NOTES
    Author: Mark McGill, VMware
    Last Edit: 10-7-2020
    Version 1.0
. SYNOPSIS
    Unprotect Instant Clone VMs in order to delete those that are abandoned by Horizon
. DESCRIPTION
    Uses vCenter API to enable methods needed to unprotect Instant Clone VMs
    Enabled methods match those enabled by the Horizon icCleanup tool to unprotect Instant Clones
. EXAMPLE
    #load function in order to call
    . .\Unprotect-InstantClone.ps1
. EXAMPLE
    #Required parameters are vm and vCenter
    Unprotect-InstantClone -vm <vmName> -vCenter <vcenterFQDN>
. EXAMPLE
    #Accepts pipeline input in the form of an array of VM Names, or VM Objects from Get-VM
    $vms = Get-VM ic-Template*
    $vms | Unprotect-InstantClone -vCenter <vcenterFQDN> -user administrator@vsphere.local
. EXAMPLE
    #Username and password can be passed as parameters as well as a Credential object.  You will be prompted if none are provided
    $credentials = Get-Credential
    Unprotect-InstantClone -vm <vmName> -vCenter vCenter.corp.local -Credentials $credentials
. EXAMPLE
    #You will be prompted to confirm unprotecting VMs unless you pass the '-Confirm $false' parameter
    Unprotect-InstantClone -vm <vmName> -vCenter <vcenterFQDN> -user administrator@vsphere.local -Confirm $false
. EXAMPLE
    #Use the '-Verbose' option to show additional output during processing
    Unprotect-InstantClone -VM <vmName> -vCenter <vcenterFQDN>  -Verbose

Sign in to be able to add comments.

Comments 0