On the Connection Server are two utilities that you can use for the maintenance of instant-clone VMs in vCenter Server and the clusters that the VMs are in.

The utilities are IcMaint.cmd and IcUnprotect.cmd and are located in C:\Program Files\VMware\VMware View\Server\tools\bin.

IcMaint.cmd

This command deletes the master images, which are the parent VMs in vCenter Server from the ESXi host so that the host can be put into maintenance mode. The host is not automatically put into maintenance mode. To perform maintenance on the host, the vCenter server administrator must manually put the host into maintenance mode.

Syntax:

IcMaint.cmd -vc hostname_or_IP_address -uid user_ID -password password -hostName ESXi_hostname -maintenance ON|OFF

Parameters:

  • -vc host name or IP address of vCenter Server

  • -uid vCenter Server user ID

  • -password vCenter Server user password

  • -hostname ESXi host name

  • -maintenance ON|OFF

    This parameter specifies whether the host is available for hosting the master image VM.

    After the command is run on the host, the InstantClone.Maintenance annotation value is set to 1 and the master image VMs are deleted. After the master image VMs are deleted, the InstantClone.Maintenance annotation value is set to 2 and no more master image VMs are created on the host. When you run this command again with -maintenanceOFF, the InstantClone.Maintenance annotation value is cleared for the host to become available for hosting master image VMs.

All the parameters are required.

IcUnprotect.cmd

After ClonePrep creates folders and VMs, you can use this utility to unprotect folders and VMs, delete VMs, and detect VMs whose master image or snapshot is deleted. ClonePrep is the mechanism that customizes instant clones during the creation process.

Syntax:

IcUnprotect.cmd -vc hostname_or_IP_address -uid user_ID -password password[-includeFolders][-skipCertVeri]

Parameters:

  • -action

    You can use the following options for this parameter:

    • unprotect. Unprotect internal VMs.

    • delete. Delete internal VMs.

    • detect. Detect and list internal VMs whose master image or snapshot is deleted.

    If you don't specify the -action parameter, the internal VMs are unprotected by default.

  • -vc host name or IP address of vCenter Server

  • -uid vCenter Server user ID

  • -password vCenter Server user password

  • -clientId instant-clone client ID (Optional)

    If clientId is not specified, protection is removed from all ClonePrep VMs in all data centers.

  • -domain domain name (Optional)

    You can use multiple domain names separated by comma and no space.

  • -host host name (Optional)

    You can use multiple host names separated by comma and no space.

  • -datastore datastore name (Optional)

    You can use multiple datastore names separated by comma and no space.

  • -vmName VM name (Optional)

    You can use multiple VM names separated by comma and no space.

  • -vmType internal VM type (Optional)

    You can use multiple VM types separated by comma and no space. You can use template, replica, parent as options for this parameter.

  • -includeFolders include folders

    This parameter unprotects the folders in addition to the VMs.

  • -skipCertVeri skip certification verification

    IcUnprotect.cmd enforces host name verification. You must enter the correct host name of the vCenter Server instead of its IP address when you specify the command parameters. To disable host name verification and use the IP address of vCenter Server instead, use -skipCertVeri.

Specify the following parameters to delete all parent VMs in vCenter Server:

IcUnprotect -action delete -vc <IP address of vCenter Server> -uid <vCenter Server user ID> -password <vCenter Server password> -clientId <instant clone client ID> -host <hostname 1>,<hostname 2> -vmType parent

Specify the following parameters to delete specific parent VMs in vCenter Server:

IcUnprotect -action delete -vc <IP address of vCenter Server> -uid <vCenter Server user ID> -password <vCenter Server password> -clientId <instant clone client ID> -host <hostname 1>,<hostname 2> (-vmType parent) -vmName <parent VM name 1,parent VM name 2)