Data Object Description

DVPortgroupConfigSpec

DistributedVirtualPortgroup

ReconfigureDVPortgroup_Task

Properties

Name	Type	Description
autoExpand*	xsd:boolean	If set to true, this property ignores the limit on the number of ports in the portgroup. When a Virtual Machine/Host tries to connect to the portgroup and there are no free ports available in the portgroup, new ports will be automatically added to the portgroup. The flag is currently supported only for static portgroups. Setting this property to true makes the portgroup a potential candidate for auto-shrink. Once the portgroup has auto-expanded then its disconnected ports are likely to be deleted automatically, as a part of auto-shrink step, if there are more than certain number of free ports. If the portgroup never auto-expanded, then it will never lose any free ports. *Since* vSphere API 5.0
configVersion*	xsd:string	Version string of the configuration that this spec is trying to change. This property is required in reconfiguring a portgroup and should be set to the same value as the configVersion. This property is ignored in creating a portgroup if set.
defaultPortConfig*	DVPortSetting	Default network setting for all the ports in the portgroup.
description*	xsd:string	Description of the portgroup.
name*	xsd:string	Name of the portgroup.
numPorts*	xsd:int	Number of ports in the portgroup. Setting this number larger than the number of existing ports in the portgroup causes new ports to be added to the portgroup to meet the number. Setting this property smaller than the number of existing ports deletes the free ports from the portgroup. If the number cannot be met by deleting free ports, a fault is raised. If new ports are added to the portgroup, they are also added to the switch. For portgroups of type ephemeral this property is ignored.
policy*	DVPortgroupPolicy	Portgroup policy.
portNameFormat*	xsd:string	Format of the name of the ports when ports are created in the portgroup. For details see portNameFormat.
scope*	ManagedObjectReference[] to a ManagedEntity[]	Eligible entities that can connect to the port. See DVPortgroupConfigInfo.scope.
type*	xsd:string	Type of portgroup. See DistributedVirtualPortgroup.DistributedVirtualPortgroupPortgroupType for possible values.
vendorSpecificConfig*	DistributedVirtualSwitchKeyedOpaqueBlob[]	Opaque binary blob that stores vendor specific configuration.
Properties inherited from DynamicData
dynamicProperty, dynamicType

Name

Type

Description

autoExpand*

xsd:boolean

If set to true, this property ignores the limit on the number of ports in the portgroup. When a Virtual Machine/Host tries to connect to the portgroup and there are no free ports available in the portgroup, new ports will be automatically added to the portgroup. The flag is currently supported only for static portgroups.

Setting this property to true makes the portgroup a potential candidate for auto-shrink. Once the portgroup has auto-expanded then its disconnected ports are likely to be deleted automatically, as a part of auto-shrink step, if there are more than certain number of free ports. If the portgroup never auto-expanded, then it will never lose any free ports.

Since vSphere API 5.0

configVersion*

xsd:string

Version string of the configuration that this spec is trying to change. This property is required in reconfiguring a portgroup and should be set to the same value as the configVersion. This property is ignored in creating a portgroup if set.

defaultPortConfig*

DVPortSetting

Default network setting for all the ports in the portgroup.

description*

xsd:string

Description of the portgroup.

name*

xsd:string

Name of the portgroup.

numPorts*

xsd:int

Number of ports in the portgroup. Setting this number larger than the number of existing ports in the portgroup causes new ports to be added to the portgroup to meet the number. Setting this property smaller than the number of existing ports deletes the free ports from the portgroup. If the number cannot be met by deleting free ports, a fault is raised. If new ports are added to the portgroup, they are also added to the switch. For portgroups of type ephemeral this property is ignored.

policy*

DVPortgroupPolicy

Portgroup policy.

portNameFormat*

xsd:string

Format of the name of the ports when ports are created in the portgroup. For details see portNameFormat.

scope*

ManagedObjectReference[]
to a ManagedEntity[]

Eligible entities that can connect to the port. See DVPortgroupConfigInfo.scope.

type*

xsd:string

Type of portgroup. See DistributedVirtualPortgroup.DistributedVirtualPortgroupPortgroupType for possible values.

vendorSpecificConfig*

DistributedVirtualSwitchKeyedOpaqueBlob[]

Opaque binary blob that stores vendor specific configuration.

Properties inherited from DynamicData

dynamicProperty, dynamicType

Need not be set

Show WSDL type definition

         <complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="DVPortgroupConfigSpec">
            <complexContent>
               <extension base="vim25:DynamicData">
                  <sequence>
                     <element name="configVersion" type="xsd:string" minOccurs="0"/>
                     <element name="name" type="xsd:string" minOccurs="0"/>
                     <element name="numPorts" type="xsd:int" minOccurs="0"/>
                     <element name="portNameFormat" type="xsd:string" minOccurs="0"/>
                     <element name="defaultPortConfig" type="vim25:DVPortSetting" minOccurs="0"/>
                     <element name="description" type="xsd:string" minOccurs="0"/>
                     <element name="type" type="xsd:string" minOccurs="0"/>
                     <element name="scope" type="vim25:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="policy" type="vim25:DVPortgroupPolicy" minOccurs="0"/>
                     <element name="vendorSpecificConfig" type="vim25:DistributedVirtualSwitchKeyedOpaqueBlob" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="autoExpand" type="xsd:boolean" minOccurs="0"/>
                  </sequence>
               </extension>
            </complexContent>
         </complexType>

Data Object - DVPortgroupConfigSpec

Data Object Description