Skip to main content

Power Shell

PowerShellW10.png

The “PowerShell” plugin allows you to run any PowerShell scripts, either locally on the server or on remote clients.

The invocation of the PowerShell plugin can be configured in various ways. This makes it possible to integrate the plugin multiple times, with different configurations and permissions. Each configuration can include the invocation of any script. To display script collections, e.g., for specific user groups, each configuration can point to any script directory. Any number of subdirectories is possible. This enables granular permission assignment to specific AD groups. Additionally, the plugin supports the {COMPUTERNAME} placeholder within function parameters for executing individual scripts. Some configuration examples are shown below.

A sample configuration can be found under PowerShell API.

Parameter

When using a function, the following parameters must be specified:

  • -Type = Local or Remote

  • -Script = ScriptName.ps1

  • Optional: Any additional parameters required by the script can be specified.

The scripts to be executed should be stored in the WebService directory under PS1\{domain}\Custom\Local or Remote.

Default Plugin Integration
  • Assembly: PowerShellPlugin
  • Name: RUN_POWERSHELL_SCRIPT (gets translated)
  • Icon: scroll_run.png
  • SelectedComputer: UserDefined
Supported Functions
  • EXECUTE: Only a message indicating success or failure is displayed.
  • GET_RESULT: The script result is displayed in a text box.
  • GET_DATATABLE: An attempt is made to display the script result in a table.
  • SHOW_MESSAGE: The script result is displayed as a dialog.
  • SHOW_SELECTABLE_MESSAGE: The script result is displayed as a dialog. However, the text content is selectable.

Back to top