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

dpmhv-getVMInfo (Funclet) Command--Show all VMs

The dpmhv-getVMInfo command retrieves the information and settings of a virtual machine.

This command has the following format:

dpmhv-getVMInfo 
-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.

Return Value

The dpmhv-getVMInfo command returns objects with information of virtual machine.

The following properties are returned in regular mode:

• vm
• Caption
• ElementName
• Name
• OperationalStatus
• StatusDescriptions
• vminfo
• MemoryUsage
• ProcessorLoad
• ProcessorLoadHistory
• vmsettings
• AutoActivate
• AutomaticRecoveryAction
• AutomaticShutdownAction
• AutomaticStartupAction
• AutomaticStartupActionDelay
• Description
• ElementName
• ExternalDataRoot
• SnapshotDataRoot
• SystemName
• vmcursettings
• BaseBoardSerialNumber
• BIOSGUID
• BIOSSerialNumber
• ChassisAssetTag
• ChassisSerialNumber
• SystemName

The following properties are returned in detail mode:

• vm
• AssignedNumaNodeList
• Caption
• CreationClassName
• Dedicated
• Description
• ElementName
• HealthState
• IdentifyingDescriptions
• InstallDate
• Name
• NameFormat
• OnTimeInMilliseconds
• OperationalStatus
• OtherDedicatedDescriptions
• OtherEnabledState
• OtherIdentifyingInfo
• PowerManagementCapabilities
• PrimaryOwnerContact
• PrimaryOwnerName
• ProcessID
• RequestedState
• ResetCapability
• Roles
• Status
• StatusDescriptions
• TimeOfLastConfigurationChange
• TimeOfLastStateChange
• vminfo
• AsynchronousTasks
• CreationTime
• ElementName
• EnabledState
• GuestOperatingSystem
• HealthState
• Heartbeat
• MemoryUsage
• Name
• Notes
• NumberOfProcessors
• OperationalStatus
• Path
• ProcessorLoad
• ProcessorLoadHistory
• Snapshots
• StatusDescriptions
• ThumbnailImage
• UpTime
• vmsettings
• AdditionalRecoveryInformation
• AllowFullSCSICommandSet
• AutoActivate
• AutomaticRecoveryAction
• AutomaticShutdownAction
• AutomaticStartupAction
• AutomaticStartupActionDelay
• Caption
• CreationTime
• DebugChannelId
• Description
• ElementName
• ExternalDataRoot
• InstanceID
• OtherVirtualSystemType
• Path
• ScopeOfResidence
• SettingType
• SnapshotDataRoot
• SystemName
• Version
• VirtualSystemType
• vmcursettings
• BIOSGUID
• BIOSSerialNumber
• BaseBoardSerialNumber
• ChassisAssetTag
• ChassisSerialNumber
• SystemName

Example: Show all VMs

This example displays the information of a virtual machine.

dpmhv-getVMINfo -host hvserver -vm TestVM