I have been able to use it to list VMs, but not for actions that require a name/id parameter.
$ ovirt-shell -f list-down-vms.txt
============================================
>>> connected to oVirt manager 4.0.1.0 <<<
============================================
[oVirt shell ( connected )]# list vms --kwargs "status-state=down" |grep name |sed s/'name *:'//
rh6-dev12c-vm177
rh6-dev12c-vm178
rh6-dev12c-vm179
rh6-dev12c-vm180
rh6-dev12c-vm181
rh6-dev12c-vm182
rh6-dev12c-vm183
rh6-dev12c-vm184
rh6-dev12c-vm185
rh6-dev12c-vm186
rh6-dev12c-vm187
rh6-dev12c-vm188
rh6-dev12c-vm189
=========================================
>>> disconnected from oVirt manager <<<
=========================================
$ ovirt-shell
===========================================
>>> connected to oVirt manager 4.0.1.0 <<<
===========================================
++++++++++++++++++++++++++++++++++++++++++++
Welcome to oVirt shell
++++++++++++++++++++++++++++++++++++++++++++
[oVirt shell (connected)]# action vm rh6-dev12c-vm189 start
========================= ERROR =================
vm rh6-dev12c-vm189 does not exist.
=================================================
[oVirt shell (connected)]#
$ rpm -q --provides ovirt-engine-cli
ovirt-engine-cli = 3.6.8.0-1.el7.centos
Thanks, Paul
--
Paul Dyer,
Mercury Consulting Group, RHCE
504-302-8750