Reference Guide › AutoShell › AutoShell Loadable Modules' Command Reference › CA Microsoft Hyper-V AutoShell Commands › dpmhv-ShowVMDisks (Funclet) Command--Show all Virtual Disks

dpmhv-ShowVMDisks (Funclet) Command--Show all Virtual Disks

The dpmhv-ShowVMDisks command displays all virtual disks in a VM on a Hyper-V host server.

This command has the following format:

dpmhv-showVMDisks 
-vm vmname|-vmid vmguid 
-host hostname 
[-retval] 
[-silent] 
[-detail]

-vm vmname

Specifies the name of the VM.

-vmid vmguid

Specifies the unique ID of the VM.

-host hostname

Specifies the name of the Hyper-V server host.

-retval

Returns a value for further processing.

-silent

Specifies not to direct the output to the screen.

-detail

(Optional) Displays the details of the list of virtual disks.

Return Value

The dpmhv-ShowVMDisks command returns an array of objects which represents the disks attached to a VM.

The following properties are returned in regular mode:

• Caption
• Connection
• ElementName
• HostResource
• ResourceSubType

The following properties are returned in detail mode:

• Address
• AllocationUnits
• AutomaticAllocation
• AutomaticDeallocation
• Caption
• Connection
• ConsumerVisibility
• Description
• ElementName
• HostResource
• InstanceID
• Limit
• MappingBehavior
• OtherResourceType
• Parent
• Path
• PoolID
• Reservation
• ResourceSubType
• ResourceType
• VirtualQuantity
• VirtualSystemIdentifiers
• Weight

Example: Show all Virtual Disks of a VM

This example returns the list of virtual disks attached to the VM.

dpmhv-showVMDisks 
-host hvserver 
-vm TestVM

Example: Show all Disks and Virtual Hard Drive Image Files

This example returns the list of disk and virtual hard drive image files attached to the VM.

dd = dpmhv-showVMDisks -host hvserver -vm TestVM -detail -retval -silent
for each(d in dd)
{
  if(d.ResourceSubType=="Microsoft Virtual Hard Disk")
  {
  ? d.Connection
  }
}