Reference Guide › AutoShell › AutoShell Loadable Modules' Command Reference › CA Microsoft Hyper-V AutoShell Commands › dpmhv-showVMNICs (Funclet) Command--Show all Network Interface Cards

dpmhv-showVMNICs (Funclet) Command--Show all Network Interface Cards

The dpmhv-showVMNICs command displays all Network Interface Cards (NIC) in the VM on a Hyper-V host.

This command has the following format:

dpmhv-showVMNICs 
-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 NICs.

Return Value

The dpmhv-showVMNICs command returns the objects.

The following properties are returned in regular mode:

• Address
• ElementName
• StaticMacAddress

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
• StaticMacAddress
• VirtualQuantity
• VirtualSystemIdentifiers
• Weight

Example: Show VM NIC Information

This example shows the information of the NICs of the VM, "TestVM" on the host "hvserver."

dpmhv-showVMNICs -host hvserver -vm TestVM
//Find virtual network the first adapter of a VM is connected To 
anic  = dpmhv-showVMNICs -host hvserver -vm TestVM -detail -silent -retval
lines = anic[0].Connection.split(",");
    for each(line in lines)
    {
      if(line.startsWith("SystemName="))
      {
        nsw = line.substr(11);
        nsw = nsw.trim('"');
        break;
      }
    }
    // Get switches
    asw = dpmhv-getHostSwitches -host hvserver -silent -retval
    // Find match
    for each(sw in asw)
    {
      if(sw.Name == nsw)
      {
        ?? "NIC",anic[0].ElementName
        ? " is connected to switch", sw.ElementName
      }
    }