> 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

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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.