The vRealize Automation custom properties for networking specify configuration for a specific network device on a machine.

Note:

This information does not apply to Amazon Web Services.

Network assignments are performed during machine allocation. vRealize Automation retrieves network information from the blueprint. If you want to assign more than one network, use the VirtualMachine.NetworkN.Name custom property on your machine blueprint. If you do not provide custom properties, allocation only assigns one network, which is picked using a round robin method in conjunction with the selected reservation.

By default, a machine has one network device configured with the VirtualMachine.Network0.Name property. You can configure additional network devices by using the VirtualMachine.NetworkN.Name custom property.

The numbering of network properties must be sequential, starting with 0. For example, if you specify custom properties for only VirtualMachine.Network0 and VirtualMachine.Network2, the properties for VirtualMachine.Network2 are ignored, because the preceding network, VirtualMachine.Network1, was not specified.

Table 1. Custom Properties for Networking Configuration

Custom Property

Description

VirtualMachine.NetworkN.Address

Specifies the IP address of network device N in a machine provisioned with a static IP address.

VirtualMachine.NetworkN.MacAddressType

Indicates whether the MAC address of network device N is generated or user-defined (static). This property is available for cloning.

The default value is generated. If the value is static, you must also use VirtualMachine.NetworkN.MacAddress to specify the MAC address.

VirtualMachine.NetworkN custom properties are designed to be specific to individual blueprints and machines. When a machine is requested, network and IP address allocation is performed before the machine is assigned to a reservation. Because blueprints are not guaranteed to be allocated to a specific reservation, do not use this property on a reservation.

VirtualMachine.NetworkN.MacAddress

Specifies the MAC address of a network device N. This property is available for cloning.

If the value of VirtualMachine.NetworkN.MacAddressType is generated, this property contains the generated address.

If the value of VirtualMachine.Network.N.MacAddressType is static, this property specifies the MAC address. For virtual machines provisioned on ESX server hosts, the address must be in the range specified by VMware. For details, see vSphere documentation.

VirtualMachine.NetworkN custom properties are designed to be specific to individual blueprints and machines. When a machine is requested, network and IP address allocation is performed before the machine is assigned to a reservation. Because blueprints are not guaranteed to be allocated to a specific reservation, do not use this property on a reservation.

VirtualMachine.NetworkN.Name

Specifies the name of the network to connect to, for example the network device N to which a machine is attached.

By default, a network is assigned from the network paths available on the reservation on which the machine is provisioned.

You can ensure that a network device is connected to a specific network by setting the value of this property to the name of a network on an available reservation.

VirtualMachine.NetworkN custom properties are designed to be specific to individual blueprints and machines. When a machine is requested, network and IP address allocation is performed before the machine is assigned to a reservation. Because blueprints are not guaranteed to be allocated to a specific reservation, do not use this property on a reservation.

You can add this property to a vApp (vCloud) blueprint or a vApp (vCloud) Component blueprint.

VirtualMachine.NetworkN.PortID

Specifies the port ID to use for network device N when using a dvPort group with a vSphere distributed switch.

VirtualMachine.NetworkN custom properties are designed to be specific to individual blueprints and machines. When a machine is requested, network and IP address allocation is performed before the machine is assigned to a reservation. Because blueprints are not guaranteed to be allocated to a specific reservation, do not use this property on a reservation.

VirtualMachine.NetworkN.ProfileName

Specifies the name of a network profile from which to assign a static IP address to network device Nor from which to obtain the range of static IP addresses that can be assigned to network device N of a cloned machine, where N=0 for the first device, 1 for the second, and so on.

If a network profile is specified in the network path in the reservation on which the machine is provisioned, a static IP address is assigned from that network profile. You can ensure that a static IP address is assigned from a specific profile by setting the value of this property to the name of a network profile.

  • VirtualMachine.NetworkN.SubnetMask

  • VirtualMachine.NetworkN.Gateway

  • VirtualMachine.NetworkN.PrimaryDns

  • VirtualMachine.NetworkN.SecondaryDns

  • VirtualMachine.NetworkN.PrimaryWins

  • VirtualMachine.NetworkN.SecondaryWins

  • VirtualMachine.NetworkN.DnsSuffix

  • VirtualMachine.NetworkN.DnsSearchSuffixes

Appending a name allows you to create multiple versions of a custom property. For example, the following properties might list load balancing pools set up for general use and machines with high, moderate, and low performance requirements:

  • VCNS.LoadBalancerEdgePool.Names

  • VCNS.LoadBalancerEdgePool.Names.moderate

  • VCNS.LoadBalancerEdgePool.Names.high

  • VCNS.LoadBalancerEdgePool.Names.low

Note:

In a multi-machine service, this custom property is supported only for VM components with Routed Virtual Wire. It is also not supported for pre-defined static IP addresses for VM components in the context of a multi-machine blueprint.

Configures attributes of the network profile specified in VirtualMachine.NetworkN.ProfileName.

VCNS.LoadBalancerEdgePool.Names.name

Specifies the vCloud Networking and Security load balancing pools to which the virtual machine is assigned during provisioning. The virtual machine is assigned to all service ports of all specified pools. The value is an edge/pool name or a list of edge/pool names separated by commas. Names are case-sensitive.

Appending a name allows you to create multiple versions of a custom property. For example, the following properties might list load balancing pools set up for general use and machines with high, moderate, and low performance requirements:

  • VCNS.LoadBalancerEdgePool.Names

  • VCNS.LoadBalancerEdgePool.Names.moderate

  • VCNS.LoadBalancerEdgePool.Names.high

  • VCNS.LoadBalancerEdgePool.Names.low

Note:

In a multi-machine service, this custom property is supported only for VM components with Routed Virtual Wire. It is also not supported for pre-defined static IP addresses for VM components in the context of a multi-machine blueprint.

VCNS.SecurityGroup.Names.name

Specifies the vCloud Networking and Security security group or groups to which the virtual machine is assigned during provisioning. The value is a security group name or a list of names separated by commas. Names are case-sensitive.

Appending a name allows you to create multiple versions of the property, which can be used separately or in combination. For example, the following properties can list security groups intended for general use, for the sales force, and for support:

  • VCNS.SecurityGroup.Names

  • VCNS.SecurityGroup.Names.sales

  • VCNS.SecurityGroup.Names.support

VCNS.SecurityTag.Names.name

Specifies the vCloud Networking and Security security tag or tags to which the virtual machine is associated during provisioning. The value is a security tag name or a list of names separated by commas. Names are case-sensitive.

Appending a name allows you to create multiple versions of the property, which can be used separately or in combination. For example, the following properties can list security tags intended for general use, for the sales force, and for support:

  • VCNS.SecurityTag.Names

  • VCNS.SecurityTag.Names.sales

  • VCNS.SecurityTag.Names.support