.. _action-windows-run:

Windows Run
===========

This section provides a detailed overview of executing commands on Windows devices.
All the actions can be run using either :class:`~.RDPRobot` or :class:`~.DesktopRobot` instances.
At the action's call, the user can also specify a type of executor to use (for details see :class:`~.WinRunExecutionHandler`).
:class:`~.DesktopRobot` runs actions as a subprocess call by default, while :class:`~.RDPRobot` runs all the actions
strictly via Windows Run window.


.. figure:: ../../images/run_window.png

    Calling :class:`~.WinRunRemoveFile` via Windows Run window, in order to delete file on the provided path.


It is possible to run any of these actions as a ``.ps1`` script, if the argument ``script_name`` is provided at the
action call, which will result in invoking the script with the action content, rather than calling the action
directly via run window (useful, for example, if the script exceeds the character limit for the run window)

Actions
-------

.. automodule:: aiviro.actions.windows_run.commands
    :members:
    :exclude-members: command


Executors
---------

.. automodule:: aiviro.actions.windows_run.execution_handlers
    :members:


Configuration
-------------

.. automodule:: aiviro.actions.windows_run.base
    :members: ConfigWinRunActions