.. _pshell-proxy-setup-script:

PowerShell proxy server
-----------------------

.. _24.2|EKB-21842:
.. _24.2|EKB-22324:
.. _25.1|VOSS-1434:
.. _25.2|EKB-25252:
.. _25.4|VOSS-1470:

:bdg-primary:`Microsoft`


From release 25.4 onwards, VOSS introduced a new ``voss-powershell`` service.
An instance of this service runs on all application nodes of a core cluster.
It replaces the execution of Powershell scripts on a Windows proxy server
with a local execution. This primarily affects the Microsoft Teams & Exchange drivers.


The service provides a management API for:

* Session Management: List, monitor, and terminate PowerShell listener sessions
* Certificate Management: List, sync, upload, and verify certificates

  Certificates that are installed on core are automatically available to
  the ``voss-powershell`` service - there is no need to upload them separately.
* User Management: Create, list, update, and delete users
* Error Handler Configuration: View and update error handling rules
* Log retrieval: Get logs by execution ID or session ID
* Persistent config: Memory tuning, concurrency limits (global and per-customer),
  session settings (idle reaper, max session age),
  and container memory limit.

For command line management, refer to the PowerShell topic in Platform Guide.

.. rubric:: Related topics 

* See Microsoft Quick Start Step 1 in the Core Feature Guide.

*
  .. raw:: latex

     PowerShell in the Platform Guide

  .. raw:: html
  
     <a href="platform/reference-powershell.html">PowerShell</a>