Adding a Network Adapter

To add a new virtual network adapter to a virtual machine, the following steps must be taken:

1. Mark the beginning of the editing operation.
2. Create a device object representing the new adapter.
3. Set the emulation type (host-only, shared, or bridged).
4. If creating a bridged adapter, select the host adapter to bind the new adapter to.
5. Commit the changes.

Example

"""

    Add a network adapter to the virtual machine.

    @param vm: An instance of prlsdkapi.Vm class identifying the

               virtual machine.

    @param networking_type: Host-only/shared/bridged. Use one of the

                            consts.PNA_xxx constants.

    @param bound_default: Used with bridged networking only.

                          Specify True to bound a new adapter to the

                          default physical adapter. If False is passed,

                          the adapter will be bound to a specific physical

                          adapter (in this example, the adapter is

                          chosen randomly).

"""

def add_net_adapter(server, vm, networking_type, bound_default = True):

    # Begin the virtual machine editing operation.

    try:

        vm.begin_edit().wait()

    except prlsdkapi.PrlSDKError, e:

        print "Error: %s" % e

        return

    # Obtain the VmConfig object containing the virtual machine

    # configuration information.

    vm_config = vm.get_config()    

    # Create an instance of the prlsdkapi.VmNet class.

    net_adapter = vm_config.create_vm_dev(consts.PDE_GENERIC_NETWORK_ADAPTER)    

    # Set the emulation type to the specified value.

    net_adapter.set_emulated_type(networking_type)

    # For bridged netowkring mode, we'll have to bind the

    # new adapter to a network adapter on the host machine.

    if networking_type == consts.PNA_BRIDGED_ETHERNET:

        # To use the default adapter, simply set the

        # adapter index to -1.

        if bound_default == True:

            net_adapter.set_bound_adapter_index(-1)

        else:

            # To use a specific adapter, first obtain the

            # list of the adapters from the host machine.

            # Obtain an instance of prlsdkapi.ServerConfig containing

            # the host configuration information.

            try:

                result = server.get_srv_config().wait()

            except prlsdkapi.PrlSDKError, e:

                print "Error: %s" % e

            srv_config = result.get_param()

            # Iterate through the list of the host network adapters.

            # In this example, we are simply selecting the first

            # adapter in the list and binding the virtual adapter to it.

            # The adapter is identified by its name.

            for i in range(srv_config.get_net_adapters_count()):

                hw_net_adapter = srv_config.get_net_adapter(i)

                hw_net_adapter_name = hw_net_adapter.get_name()

                net_adapter.set_bound_adapter_name(hw_net_adapter_name)

                exit

    # Connect and enable the new virtual adapter.

    net_adapter.set_connected(True)

    net_adapter.set_enabled(True)

    # Commit the changes.

    try:

       vm.commit().wait()

    except prlsdkapi.PrlSDKError, e:

        print "Error: %s" % e

        return

    print("Virtual network adapter created successfully")