VMware

Parallel Namespace

The Parallel namespace provides commands for configuring the virtual parallel ports of a virtual machine.

List of commands:



List Command

dcli com vmware vcenter vm hardware parallel list

Description

Returns commonly used information about the virtual parallel ports belonging to the virtual machine.

Options

Option Name Type Required Description
vm string Yes Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

Example

dcli com vmware vcenter vm hardware parallel list --vm testId


Get Command

dcli com vmware vcenter vm hardware parallel get

Description

Returns information about a virtual parallel port.

Options

Option Name Type Required Description
vm string Yes Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.
port string Yes Virtual parallel port identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.ParallelPort.

Example

dcli com vmware vcenter vm hardware parallel get --vm testId --port testId


Create Command

dcli com vmware vcenter vm hardware parallel create

Description

Adds a virtual parallel port to the virtual machine.

Options

Option Name Type Required Description
vm string Yes Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.
backing‑type string No Backing type for the virtual parallel port. Valid values are: {FILE, HOST_DEVICE}
backing‑file string No Path of the file that should be used as the virtual parallel port backing. This option is optional and it is only relevant when the value of type is FILE.
backing‑host‑device string No Name of the device that should be used as the virtual parallel port backing. If unset, the virtual parallel port will be configured to automatically detect a suitable host device.
start‑connected bool No Flag indicating whether the virtual device should be connected whenever the virtual machine is powered on. Defaults to false if unset.
allow‑guest‑control bool No Flag indicating whether the guest can connect and disconnect the device. Defaults to false if unset.

Example

dcli com vmware vcenter vm hardware parallel create --vm testId


Update Command

dcli com vmware vcenter vm hardware parallel update

Description

Updates the configuration of a virtual parallel port.

Options

Option Name Type Required Description
vm string Yes Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.
port string Yes Virtual parallel port identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.ParallelPort.
backing‑type string No Backing type for the virtual parallel port. Valid values are: {FILE, HOST_DEVICE}
backing‑file string No Path of the file that should be used as the virtual parallel port backing. This option is optional and it is only relevant when the value of type is FILE.
backing‑host‑device string No Name of the device that should be used as the virtual parallel port backing. If unset, the virtual parallel port will be configured to automatically detect a suitable host device.
start‑connected bool No Flag indicating whether the virtual device should be connected whenever the virtual machine is powered on. If unset, the value is unchanged.
allow‑guest‑control bool No Flag indicating whether the guest can connect and disconnect the device. If unset, the value is unchanged.

Example

dcli com vmware vcenter vm hardware parallel update --vm testId --port testId


Delete Command

dcli com vmware vcenter vm hardware parallel delete

Description

Removes a virtual parallel port from the virtual machine.

Options

Option Name Type Required Description
vm string Yes Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.
port string Yes Virtual parallel port identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.ParallelPort.

Example

dcli com vmware vcenter vm hardware parallel delete --vm testId --port testId


Connect Command

dcli com vmware vcenter vm hardware parallel connect

Description

Connects a virtual parallel port of a powered-on virtual machine to its backing. Connecting the virtual device makes the backing accessible from the perspective of the guest operating system. For a powered-off virtual machine, the Parallel.update command may be used to configure the virtual parallel port to start in the connected state when the virtual machine is powered on.

Options

Option Name Type Required Description
vm string Yes Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.
port string Yes Virtual parallel port identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.ParallelPort.

Example

dcli com vmware vcenter vm hardware parallel connect --vm testId --port testId


Disconnect Command

dcli com vmware vcenter vm hardware parallel disconnect

Description

Disconnects a virtual parallel port of a powered-on virtual machine from its backing. The virtual device is still present and its backing configuration is unchanged, but from the perspective of the guest operating system, the parallel port is not connected to its backing. For a powered-off virtual machine, the Parallel.update command may be used to configure the virtual parallel port to start in the disconnected state when the virtual machine is powered on.

Options

Option Name Type Required Description
vm string Yes Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.
port string Yes Virtual parallel port identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.ParallelPort.

Example

dcli com vmware vcenter vm hardware parallel disconnect --vm testId --port testId