> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/de/api/about.md).

# Über

Erfahren Sie, wie PowerShell Universal REST-API-Endpunkte PowerShell-Skripte ausführen, Ausführungsumgebungen konfigurieren und die Leistung von API-Prozessen optimieren.

Universal bietet die Möglichkeit, REST-API-Endpunkte mit PowerShell zu definieren. Wenn die Endpunkte von einem kompatiblen HTTP-Client ausgeführt werden, wird das PowerShell-Skript ausgeführt und das Ergebnis an den Endbenutzer zurückgegeben.

{% hint style="info" %}
Diese Funktion dient der Entwicklung benutzerdefinierter APIs, die von Universal ausgeführt werden. Sie ist für die Verwaltung von Universal nicht erforderlich. Universal stellt eine Reihe von Verwaltungs-APIs bereit, die in der Plattform enthalten sind.
{% endhint %}

## Ausführungsumgebung

Die REST-API-Ausführungsumgebung läuft in Ihrer Standard-PowerShell-Version. Im Gegensatz zu Automatisierungsaufträgen, die auch über die Universal-Verwaltungs-API ausgeführt werden können, werden von Ihnen definierte APIs in einem einzigen PowerShell-Prozess ausgeführt. Da der PowerShell-Prozess nicht bei jedem Aufruf des Endpunkts gestartet und gestoppt wird, ist die API viel schneller.

Sie können die [Umgebung ](/powershell-universal/de/config/environments.md)definieren, in der der PowerShell Universal API-Prozess ausgeführt wird, indem Sie `-ApiEnvironment` bei `Set-PSUSetting` angeben. Eine Änderung dieser Einstellung führt zu einem Neustart des API-Prozesses.

```powershell
Set-PSUSetting -ApiEnvironment '7.1'
```

### Umgebung pro Endpunkt

Sie können die verwendete Umgebung auch definieren, indem Sie die Umgebung am Endpunkt selbst angeben.

```powershell
New-PSUEndpoint -Url /environment -Environment Integrated -Endpoint {
    $PSUEnvironment
}
```

### Leistung

Die Leistung ist relativ zur Hardware und den Netzwerkbedingungen, unter denen Sie Universal betreiben. Davon abgesehen können Sie unter idealen Bedingungen erwarten, dass die Universal-APIs etwa 500 Anfragen pro Sekunde bedienen. Dies gilt für einen völlig leeren Endpunkt, sodass jedes Skript, das Sie diesem Endpunkt hinzufügen, den Durchsatz verringert. Die Verringerung des Durchsatzes hängt von den Cmdlets und dem Skript ab, die innerhalb des API-Endpunkts ausgeführt werden. Es gibt keine feste Grenze.

Ausführliche Informationen zu Benchmark-Tests der Universal-APIs finden Sie im [Devolutions Blog](https://devolutions.net/blog/).

### Variablen

Variablen sind auf der [Variablen-Seite](/powershell-universal/de/plattform/variables.md#api) aufgeführt.

## API

* [New-PSUEndpoint](/powershell-universal/de/powershell-befehle/new-psuendpoint.md)
* [Get-PSUEndpoint](/powershell-universal/de/powershell-befehle/get-psuendpoint.md)
* [Remove-PSUEndpoint](/powershell-universal/de/powershell-befehle/remove-psuendpoint.md)
* [Set-PSUSetting](/powershell-universal/de/powershell-befehle/set-psusetting.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/powershell-universal/de/api/about.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.