Versions Compared

Version Old Version 3 New Version Current
Changes made by

Former user

wiki

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Activities


Image Added 

 Add new virtual switch

This activity adds a new virtual switch. 

Activity Parameters

The Add new virtual switch activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image Added

Parameters:

  • Allow Promiscuous (combo box control) (type: string): specify whether all the traffic to be seen on the port or not. 
  • Forged Transmits (combo box control) (type: string): specify whether the virtual network adapter should be allowed to send network traffic with a different MAC address than that of the virtual network adapter or not. 
  • Host ID (text box editor type) (type: string): the the ID of the host. If you enter a value for this parameter, the 'Host IP' parameter is ignored. E.g "host-20".
    The value can also be obtained from activity: Get Host using the following steps:
    • use a Get Host activity to extract the HostID:
      Image Added

    • bind the obtained HostID (stored in variable) to the HostID field from Add new virtual switch activity:   
       Image Added                     

    • Host IP (text box editor type) (type: string): the Host IP.
    • Mac Changes (combo box control) (type: string): specify whether the MAC address can be changed or not.
    • MTU (text box editor type) (type: string): specify the maximum transmission unit of the virtual switch in bytes. 
    • NumPorts (text box editor type) (type: string): specify the number of ports that this virtual switch is configured to use. Changing this setting does not take effect until the next reboot. The maximum value is 1024, although other constraints, such as memory limits, may establish a lower effective limit. 
    • Port Group Name (text box editor type) (type: string): the name for the virtual switch port group. 
    • VSwitch Name (text box editor type) (type: string): the name for the virtual switch to be added. 

The Read Only Output variable are the possible output values that the activity will provide:

  • Status(type: string): outputs the result status.


Execution: The example below is an execution where a new virtual switch is added:

Image Added

Edit virtual switch

This activity edits a specified virtual switch. 

Activity Parameters

The Edit Virtual switch activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image Added

Parameters:

  • Allow Promiscuous (combo box control) (type: string): specify whether all the traffic to be seen on the port or not. 
  • Forged Transmits (combo box control) (type: string): specify whether the virtual network adapter should be allowed to send network traffic with a different MAC address than that of the virtual network adapter or not. 
  • Host ID (text box editor type) (type: string): the the ID of the host. If you enter a value for this parameter, the 'Host IP' parameter is ignored. E.g "host-20".
    The value can also be obtained from activity: Get Host using the following steps:
    • use a Get Host activity to extract the HostID:
      Image Added

    • bind the obtained HostID (stored in variable) to the HostID field from Edit Virtual Switch activity:   

    •  Image Added                   

    • Host IP (text box editor type) (type: string): the Host IP.
    • Mac Changes (combo box control) (type: string): specify whether the MAC address can be changed or not.
    • MTU (text box editor type) (type: string): specify the maximum transmission unit of the virtual switch in bytes. 
    • NumPorts (text box editor type) (type: string): specify the number of ports that this virtual switch is configured to use. Changing this setting does not take effect until the next reboot. The maximum value is 1024, although other constraints, such as memory limits, may establish a lower effective limit. 
    • Port Group Name (text box editor type) (type: string): the name for the virtual switch port group. 
    • VSwitch Name (text box editor type) (type: string): the name for the virtual switch. 

The Read Only Output variable are the possible output values that the activity will provide:

  • Status(type: string): outputs the result status.


Execution: The example below is an execution where the virtual swicth with name Demo_vSwitch is edited:

Image Added

Get Network Adapter Properties

This activity retrieves the properties of the specified network adapter for the selected virtual machine.

Activity Parameters

The Get Network Adapter Properties activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image RemovedImage Added

Parameters:

  • VM (text box editor type) (type: string): the virtual machine you want to have returned the network adapter properties( Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the Get Network Adapter Properties activity:

...

  • .
    The value can also be obtained from activity: Get VM using the following steps:
    • use a Get VM activity to extract the VM ID:
      Image Added
    • bind the obtained VM ID (stored in variable) to the VirtualMachine ID field from Get Network Adapter Properties activity:
      Image Added

The Read Only Output variable are the possible output values that the activity will provide:

  • OutputOutput  (type: collection<collection<string>>): outputs a collection of Properties and their corresponding values.To use the elements of the collection, use Get Element From Collection activity where the Input Collection parameter should be bind with this parameter.
  • Output Address Type  (type: string): outputs the value of the AddressType property.
  • Output Connected  (type: string): outputs the value of the Connected property.
  • Output Controller key  (type: string): outputs the value of the ControllerKey property.
  • Output Device Name  (type: string): outputs the value of the DeviceName property.
  • Output ID  (type: string): outputs the value of the ID property.
  • Output Key  (type: string): outputs the value of the Key property.
  • Output Label  (type: string): outputs the value of the Label property.
  • Output MAC Address  (type: string): outputs the value of the Mac Address property.
  • Output Network ID  (type: string): outputs the value of the NetworkID property.
  • Output Port Group Key  (type: string): outputs the value of the PortGroupKey property.
  • Output Summary  (type: string): outputs the value of the Summary property.
  • Output Wake On LAN Enabled  (type: string): outputs the value of the WakeOnLanEnabled property.


...

In order to extract the values from the NetworkAdapterProperties collection, 

...

For Each and Get Element From Collection activities should be used:

Image Added


Execution: The example below is an execution where all properties are returned for the specified network adapter of the VM:

Image Added

 

Get Network Connections

This activity retrieves the available network connections for the selected host.

Activity Parameters

The Get Network Connections activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image RemovedImage Added

Parameters:

  • Cluster (text box editor type) (type: string): the name of the Cluster (only necessary if 'Host' parameter is empty).
  • Datacenter Name (text box editor type) (type: string): the Datacenter name.
  • Datastore Name (text box editor type) (type: string): the Datastore name (optional).
  • Host (text box editor type) (type: string): the Host (ip address).

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the Get Network Connections activity:

Image Removed

The Read Only Output variable are the possible output values that the activity will provide:

  • Output dvSwitchesdvSwitches  (type: collection<collection<string>>): outputs a collection of distributed virtual switch properties and their corresponding values.To use the elements of the collection, use Get Element From Collection activity where the Input Collection parameter should be bind with this parameter.
  • Output NetworksNetworks  (type:  collection<collection<string>>): outputs a collection of collections containing the Name and ID for each network. To use the elements of the collection, use Get Element From Collection activity where the Input Collection parameter should be bind with this parameter.
  • Output Port Group KeysKeys  (type: collection<string>): outputs a collection of Port Group Keys. To use the elements of the collection, use Get Element From Collection activity where the Input Collection parameter should be bind with this parameter.
  • Output Port GroupsGroups  (type:  collection<collection<string>>): outputs a collection of Properties and their corresponding values.To use the elements of the collection, use Get Element From Collection activity where the Input Collection parameter should be bind with this parameter.
Image Removed 


 

In order to extract the values from the NetworksCollection collection, For Each and Get Element From Collection activities should be used:

Image Added


Execution: The example below is an execution where all network connections for host with IP 10.201.0.51:

Image Added


Get Virtual Network Adapters 

This activity gets all the virtual network adapters for the specified host. 

Activity Parameters

The Get Virtual Network Adapters activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image Added

Parameters:

  • Host ID (text box editor type) (type: string): the the ID of the host. If you enter a value for this parameter, the 'Host IP' parameter is ignored. E.g "host-20".
    The value can also be obtained from activity: Get Host using the following steps:
    • use a Get Host activity to extract the HostID:
      Image Added

    • bind the obtained HostID (stored in variable) to the HostID field from Get Virtual Network Adapters activity:   
      Image Added                       

    • Host IP (text box editor type) (type: string): the Host IP.

The Read Only Output variable are the possible output values that the activity will provide:

  • Output  (type: collection<dictionary<string,string>>): outputs a collection of dictionaries containing all the Virtual Adapters found with their details.

In order to extract the values from the NetworkAdapters collection, For Each and Get KeyValuePair activities should be used:

Image AddedImage Added

Execution: The example below is an execution where all virtual network adapters are returned for host with IP: 10.201.0.51:

Image Added



Remove virtual switch

This activity removes a specified virtual switch. 

Activity Parameters

The Remove Virtual switch activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image Added

Parameters:

  • Device Name (text box editor type) (type: string): the name for the network adapter associated with this virtual switch.
  • Host ID (text box editor type) (type: string): the the ID of the host. If you enter a value for this parameter, the 'Host IP' parameter is ignored. E.g "host-20".
    The value can also be obtained from activity: Get Host using the following steps:
    • use a Get Host activity to extract the HostID:
      Image Added

    • bind the obtained HostID (stored in variable) to the HostID field from Remove Virtual Switch activity:   

      Image Added                   

    • Host IP (text box editor type) (type: string): the Host IP.
    • VSwitch Name (text box editor type) (type: string): the name for the virtual switch. 

The Read Only Output variable are the possible output values that the activity will provide:

  • Status(type: string): outputs the result status.