# Data Object - DVSSummary(vim.DistributedVirtualSwitch.Summary)

Property of
  DistributedVirtualSwitch
Extends
  DynamicData
See also
  DistributedVirtualSwitchProductSpec, DVSContactInfo, HostSystem, VirtualMachine
Since
  vSphere API 4.0

## Data Object Description

Summary of the distributed switch configuration.

Properties

Name | Type | Description
--- | --- | ---
contact* | DVSContactInfo | The human operator contact information.
description* | xsd:string | A description string of the switch.
host* | ManagedObjectReference[] to a HostSystem[] | The hosts with Virtual NICs that connect to the switch.
hostMember* | ManagedObjectReference[] to a HostSystem[] | The names of the hosts that join the switch.
name | xsd:string | The name of the switch.
numHosts* | xsd:int | The number of hosts in the switch. The value of this property is not affected by the privileges granted to the current user. Since vSphere API 5.5
numPorts | xsd:int | Current number of ports, not including conflict ports.
portgroupName* | xsd:string[] | The names of the portgroups that are defined on the switch.
productInfo* | DistributedVirtualSwitchProductSpec | The product information for the implementation of the switch.
uuid | xsd:string | The generated UUID of the switch.
vm* | ManagedObjectReference[] to a VirtualMachine[] | The Virtual Machines with Virtual NICs that connect to the switch. In releases after vSphere API 5.0, vSphere Servers might not generate property collector update notifications for this property. To obtain the latest value of the property, you can use PropertyCollector methods RetrievePropertiesEx or WaitForUpdatesEx. If you use the PropertyCollector.WaitForUpdatesEx method, specify an empty string for the version parameter. Since this property is on a DataObject, an update returned by WaitForUpdatesEx may contain values for this property when some other property on the DataObject changes. If this update is a result of a call to WaitForUpdatesEx with a non-empty version parameter, the value for this property may not be current.
Properties inherited from DynamicData
None

*Need not be set
Show WSDL type definition
<complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="DVSSummary"> <complexContent> <extension base="vim25:DynamicData"> <sequence> <element name="name" type="xsd:string"/> <element name="uuid" type="xsd:string"/> <element name="numPorts" type="xsd:int"/> <element name="productInfo" type="vim25:DistributedVirtualSwitchProductSpec" minOccurs="0"/> <element name="hostMember" type="vim25:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/> <element name="vm" type="vim25:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/> <element name="host" type="vim25:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/> <element name="portgroupName" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/> <element name="description" type="xsd:string" minOccurs="0"/> <element name="contact" type="vim25:DVSContactInfo" minOccurs="0"/> <element name="numHosts" type="xsd:int" minOccurs="0"/> </sequence> </extension> </complexContent> </complexType>