Managed Object - HostNetworkSystem(vim.host.NetworkSystem)

A reference to the HostNetworkSystem used to make the method call.

portgrp P

HostPortGroupSpec

Since 2.0

P Required privilege: portgrp

Return Value

Type	Description
None

Faults

Type	Description
AlreadyExists	Thrown if the port group already exists.
HostConfigFault	Thrown for all other configuration failures.
NotFound	Thrown if the virtual switch does not exist.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="AddPortGroup" type="vim25:AddPortGroupRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="AddPortGroupResponse">
                  <complexType/>
               </element>

AddServiceConsoleVirtualNic(addServiceConsoleVirtualNic)

Adds a virtual service console network adapter. Returns the device of the VirtualNic.

IP configuration is required although it does not have to be enabled if the host is an ESX Server system. The dynamic privilege check will ensure that users have Host.Config.Network privilege on the host, and Network.Assign privilege on the connecting DVPortGroup, or DVS if connecting to a standalone DVPort. Network.Assign privilege is not required for operations on standard network or for operations performed directly on the host
See usesServiceConsoleNic

Required Privileges: None

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

portgroup P

xsd:string

See usesServiceConsoleNic

Since 2.0

nic P

See usesServiceConsoleNic

Since 2.0

PRequired privilege - see tooltip for details

Return Value

Type	Description
xsd:string

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures. See usesServiceConsoleNic
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="AddServiceConsoleVirtualNic" type="vim25:AddServiceConsoleVirtualNicRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="AddServiceConsoleVirtualNicResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="xsd:string"/>
                     </sequence>
                  </complexType>
               </element>

AddVirtualNic(addVirtualNic)

Adds a virtual host/VMkernel network adapter. Returns the device of the virtual network adapter.

Required Privileges: None

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

portgroup P

xsd:string

Note: Must be the empty string in case nic.distributedVirtualPort is set.

Since 2.0

nic P

Since 2.0

PRequired privilege - see tooltip for details

Return Value

Type	Description
xsd:string

Faults

Type	Description
AlreadyExists	Thrown if the portgroup already has a virtual network adapter.
HostConfigFault	Thrown for all other configuration failures.
InvalidState	Thrown if the an ipv6 address is specified in an ipv4 only system
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="AddVirtualNic" type="vim25:AddVirtualNicRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="AddVirtualNicResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="xsd:string"/>
                     </sequence>
                  </complexType>
               </element>

AddVirtualSwitch(addVirtualSwitch)

Adds a new virtual switch to the system with the given name. The name must be unique with respect to other virtual switches on the host and is limited to 32 characters.
See UpdateVirtualSwitch

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

vswitchName P

xsd:string

See UpdateVirtualSwitch

Since 2.0

spec* P

HostVirtualSwitchSpec

See UpdateVirtualSwitch

Since 2.0

*Need not be set PRequired privilege - see tooltip for details

Return Value

Type	Description
None

Faults

Type	Description
AlreadyExists	Thrown if the virtual switch already exists. See UpdateVirtualSwitch
HostConfigFault	Thrown for all other configuration failures. See UpdateVirtualSwitch
ResourceInUse	Thrown if the physical network adapter being bridged is already in use. See UpdateVirtualSwitch
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="AddVirtualSwitch" type="vim25:AddVirtualSwitchRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="AddVirtualSwitchResponse">
                  <complexType/>
               </element>

QueryNetworkHint(queryNetworkHint)

Requests network hint information for a physical network adapter. A network hint is some information about the network to which the physical network adapter is attached. The method receives in a list of physical network adapter devices and returns an equal number of hints if some devices are provided. If the list of devices is empty, then the method accesses hints for all physical network adapters.
See supportsNetworkHints
See device

Required Privileges: System.Read

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

device* P

xsd:string[]

See supportsNetworkHints
See device

Since 2.0

*Need not be set P Required privilege: device

Return Value

Type	Description
PhysicalNicHintInfo[]

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures. See supportsNetworkHints See device
NotFound	Thrown if a specified physical network adapter does not exist. See supportsNetworkHints See device
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryNetworkHint" type="vim25:QueryNetworkHintRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryNetworkHintResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:PhysicalNicHintInfo" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

RefreshNetworkSystem(refresh)

Refresh the network information and settings to pick up any changes that might have occurred.

Required Privileges: Host.Config.Network

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostNetworkSystem used to make the method call.

Return Value

Type	Description
None

Faults

Type	Description
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RefreshNetworkSystem" type="vim25:RefreshNetworkSystemRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RefreshNetworkSystemResponse">
                  <complexType/>
               </element>

RemovePortGroup(removePortGroup)

Removes port group from the virtual switch.

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

pgName P

xsd:string

Since 2.0

P Required privilege: pgName

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures.
NotFound	Thrown if the port group or virtual switch does not exist.
ResourceInUse	Thrown if the port group can not be removed because there are virtual network adapters associated with it.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RemovePortGroup" type="vim25:RemovePortGroupRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RemovePortGroupResponse">
                  <complexType/>
               </element>

RemoveServiceConsoleVirtualNic(removeServiceConsoleVirtualNic)

Removes a virtual service console network adapter.
See usesServiceConsoleNic

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

device P

xsd:string

See usesServiceConsoleNic

Since 2.0

P Required privilege: device

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures. See usesServiceConsoleNic
NotFound	Thrown if the virtual network adapter cannot be found. See usesServiceConsoleNic
ResourceInUse	Thrown if the network adapter is currently used by DHCP DNS. See usesServiceConsoleNic
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RemoveServiceConsoleVirtualNic" type="vim25:RemoveServiceConsoleVirtualNicRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RemoveServiceConsoleVirtualNicResponse">
                  <complexType/>
               </element>

RemoveVirtualNic(removeVirtualNic)

Removes a virtual host/VMkernel network adapter.

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

device P

xsd:string

Since 2.0

P Required privilege: device

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures.
NotFound	Thrown if the virtual network adapter cannot be found.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RemoveVirtualNic" type="vim25:RemoveVirtualNicRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RemoveVirtualNicResponse">
                  <complexType/>
               </element>

RemoveVirtualSwitch(removeVirtualSwitch)

Removes an existing virtual switch from the system.

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

vswitchName P

xsd:string

Since 2.0

P Required privilege: vswitchName

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures.
NotFound	Thrown if the virtual switch does not exist.
ResourceInUse	Thrown if there are virtual network adapters associated with the virtual switch.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RemoveVirtualSwitch" type="vim25:RemoveVirtualSwitchRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RemoveVirtualSwitchResponse">
                  <complexType/>
               </element>

RestartServiceConsoleVirtualNic(restartServiceConsoleVirtualNic)

Restart the service console virtual network adapter interface. If the service console virtual network adapter uses DHCP, restarting the interface may result it with a different IP configuration, or even fail to be brought up depending on the host system network configuration.
See usesServiceConsoleNic

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

device P

xsd:string

See usesServiceConsoleNic

Since 2.0

P Required privilege: device

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures. See usesServiceConsoleNic
NotFound	Thrown if the virtual network adapter cannot be found. See usesServiceConsoleNic
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RestartServiceConsoleVirtualNic" type="vim25:RestartServiceConsoleVirtualNicRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RestartServiceConsoleVirtualNicResponse">
                  <complexType/>
               </element>

UpdateConsoleIpRouteConfig(updateConsoleIpRouteConfig)

Applies the IP route configuration for the service console.

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

config P

HostIpRouteConfig

Since 2.0

P Required privilege: config

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateConsoleIpRouteConfig" type="vim25:UpdateConsoleIpRouteConfigRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateConsoleIpRouteConfigResponse">
                  <complexType/>
               </element>

UpdateDnsConfig(updateDnsConfig)

Deprecated. As of vSphere API 5.5, which is moved to each NetStackInstance. This API only works on the default NetStackInstance.

Applies the client-side DNS configuration.

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

config P

HostDnsConfig

Since 2.0

P Required privilege: config

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures.
HostInDomain	Thrown if an attempt is made to change the host or domain name while the host is part of a Windows domain.
NotFound	when the DHCP virtual network adapter specified does not exist.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateDnsConfig" type="vim25:UpdateDnsConfigRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateDnsConfigResponse">
                  <complexType/>
               </element>

UpdateIpRouteConfig(updateIpRouteConfig)

Deprecated. As of vSphere API 5.5, which is moved to each NetStackInstance. This API only works on the default NetStackInstance.

Applies the IP route configuration.

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

config P

HostIpRouteConfig

Since 2.0

P Required privilege: config

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures.
InvalidState	Thrown if the an ipv6 address is specified in an ipv4 only system
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateIpRouteConfig" type="vim25:UpdateIpRouteConfigRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateIpRouteConfigResponse">
                  <complexType/>
               </element>

UpdateIpRouteTableConfig(updateIpRouteTableConfig)

Deprecated. As of vSphere API 5.5, which is moved to each NetStackInstance. This API only works on the default NetStackInstance.

Applies the IP route table configuration.

Required Privileges: Host.Config.Network
Since: vSphere API 4.0

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

config P

HostIpRouteTableConfig

Since vSphere API 4.0

P Required privilege: config

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateIpRouteTableConfig" type="vim25:UpdateIpRouteTableConfigRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateIpRouteTableConfigResponse">
                  <complexType/>
               </element>

UpdateNetworkConfig(updateNetworkConfig)

Applies the network configuration. This method operates primarily in two modes: replace or modify mode.

replace
When called in replace mode, this method applies the fully specified networking configuration to the networking system.

Upon successful completion of the call, the state of networking will match the configuration specified in config. In general, objects are created or destroyed to match the elements in the array of configurations. The identifier field in each element in an array of configurations is used to match an existing network entity. The state of existing network entities is patched to match that of the configuration.

An exception to this approach applies to the array of PhysicalNic.Config objects. The cardinality of physical network adapters cannot be changed through this operation. Thus, the identifier of every element in the array must match an existing PhysicalNic. If there are fewer elements in the array than there are existing PhysicalNics, then no change is made on the unreferenced PhysicalNic objects.

If the call fails, the networking error is returned as an exception and the state of networking reverts to the state prior to the start of the call.

modify When called in modify mode, only changes that are specified are made. For singleton entities like DnsConfig, the state is changed only if the data object is set. For array elements, there is an Operation field that indicates if the element should be added, removed, or edited. In the case of editing or removal, the entity must exist or an exception is thrown. In the case of adding, a specification needs to be provided.

It returns device names of vmkernel and service console virtual network adapter added to the system.

Currently, the only mode that is implemented is incremental mode. Only add operations are supported for instances. Singleton configuration is not supported. The dynamic privilege check will ensure that users have Host.Config.Network privilege on the host, and Network.Assign privilege on the connecting DVPortGroup, or DVS if connecting to a standalone DVPort. Network.Assign privilege is not required for operations on standard network or for operations performed directly on the host
See HostConfigChangeMode

Required Privileges: None

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

config P

HostNetworkConfig

See HostConfigChangeMode

Since 2.0

changeMode P

xsd:string

See HostConfigChangeMode

Since 2.0

PRequired privilege - see tooltip for details

Return Value

Type	Description
HostNetworkConfigResult

Faults

Type	Description
AlreadyExists	when a network entity specified in the configuration already exists. See HostConfigChangeMode
HostConfigFault	Thrown for all other configuration failures. See HostConfigChangeMode
NotFound	when a network entity specified in the configuration already exists. See HostConfigChangeMode
ResourceInUse	See HostConfigChangeMode
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateNetworkConfig" type="vim25:UpdateNetworkConfigRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateNetworkConfigResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:HostNetworkConfigResult"/>
                     </sequence>
                  </complexType>
               </element>

UpdatePhysicalNicLinkSpeed(updatePhysicalNicLinkSpeed)

Configures link speed and duplexity. If linkSpeed is not specified, physical network adapter will be set to autonegotiate.
See canSetPhysicalNicLinkSpeed

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

device P

xsd:string

See canSetPhysicalNicLinkSpeed

Since 2.0

linkSpeed* P

PhysicalNicLinkInfo

See canSetPhysicalNicLinkSpeed

Since 2.0

*Need not be set PRequired privilege - see tooltip for details

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures. See canSetPhysicalNicLinkSpeed
NotFound	Thrown if the physical network adapter does not exist. See canSetPhysicalNicLinkSpeed
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdatePhysicalNicLinkSpeed" type="vim25:UpdatePhysicalNicLinkSpeedRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdatePhysicalNicLinkSpeedResponse">
                  <complexType/>
               </element>

UpdatePortGroup(updatePortGroup)

Reconfigures a port group on the virtual switch.

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

pgName P

xsd:string

Since 2.0

portgrp P

HostPortGroupSpec

Since 2.0

PRequired privilege - see tooltip for details

Return Value

Type	Description
None

Faults

Type	Description
AlreadyExists	Thrown if the update causes the port group to conflict with an existing port group.
HostConfigFault	Thrown for all other configuration failures.
NotFound	Thrown if the port group or virtual switch does not exist.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdatePortGroup" type="vim25:UpdatePortGroupRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdatePortGroupResponse">
                  <complexType/>
               </element>

UpdateServiceConsoleVirtualNic(updateServiceConsoleVirtualNic)

Configures the IP configuration for a virtual service console network adapter.

IP configuration is required although it does not have to be enabled if the host is an ESX Server system. The dynamic privilege check will check that the users have Network.Assign privilege on the DVPortGroup or the DVS if the port resides on a DVPortGroup or is a stand-alone DVS port.
See usesServiceConsoleNic

Required Privileges: None

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

device P

xsd:string

See usesServiceConsoleNic

Since 2.0

nic P

See usesServiceConsoleNic

Since 2.0

PRequired privilege - see tooltip for details

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures. See usesServiceConsoleNic
NotFound	Thrown if the virtual network adapter cannot be found. See usesServiceConsoleNic
ResourceInUse	Thrown if tries to turn of DHCP while the network adapter is currently used by DHCP DNS. See usesServiceConsoleNic
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateServiceConsoleVirtualNic" type="vim25:UpdateServiceConsoleVirtualNicRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateServiceConsoleVirtualNicResponse">
                  <complexType/>
               </element>

UpdateVirtualNic(updateVirtualNic)

Configures virtual host/VMkernel network adapter.

Required Privileges: None

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

device P

xsd:string

Since 2.0

nic P

Since 2.0

PRequired privilege - see tooltip for details

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures.
InvalidState	Thrown if the an ipv6 address is specified in an ipv4 only system
NotFound	Thrown if the virtual network adapter cannot be found.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateVirtualNic" type="vim25:UpdateVirtualNicRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateVirtualNicResponse">
                  <complexType/>
               </element>

UpdateVirtualSwitch(updateVirtualSwitch)

Updates the properties of the virtual switch.

If the bridge is NULL, the configuration will be unset.

If a network adapter is listed in the active or standby list, then changing the set of network adapters to which the physical network adapter is associated may have a side effect of changing the network adapter order policy. If a network adapter is removed from the bridge configuration, then the network adapter is removed from the network adapter teaming order.

The BondBridge configuration is the only valid bridge configuration for an ESX Server system.
See HostNicOrderPolicy

Required Privileges: Host.Config.Network

Parameters

Name

Type

Description

_this

A reference to the HostNetworkSystem used to make the method call.

vswitchName P

xsd:string

See HostNicOrderPolicy

Since 2.0

spec P

HostVirtualSwitchSpec

See HostNicOrderPolicy

Since 2.0

PRequired privilege - see tooltip for details

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown for all other configuration failures. See HostNicOrderPolicy
NotFound	Thrown if the virtual switch does not exist. See HostNicOrderPolicy
ResourceInUse	Thrown if the physical network adapter being bridged is already in use. See HostNicOrderPolicy
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None