> 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/portal/portal-widgets.md).

# Portal-Widgets

Entdecken Sie die integrierten Portal-Widgets in PowerShell Universal, darunter Skriptformulare, Tabellen und Diagramme, sowie die Erstellung benutzerdefinierter Widgets mit PSBlazor.

Widgets sind Benutzeroberflächen-Blöcke, die mit PowerShell und Blazor erstellt werden. Sie können robuste webbasierte Benutzeroberflächen mit minimaler Webentwicklungserfahrung erstellen.

## Integrierte Widgets

PowerShell Universal bietet integrierte Widgets, die sich mit anderen Funktionen der Plattform verbinden lassen, um UI-Elemente anzuzeigen.

### Skriptformular

Stellen Sie Endbenutzern ein Formular zum Ausführen von Skripten bereit. Der Portalzugriff wird in drei separaten Phasen ausgewertet:

1. **Auflisten des Skripts:** Der Benutzer muss entweder über eine übereinstimmende Rolle unter **Script Properties > Portal** verfügen oder über eine Rolle, die einem zugehörigen **Display in Portal**-Tag zugewiesen ist.
2. **Öffnen des Skriptformulars:** Der Benutzer muss über eine übereinstimmende Rolle unter **Script Properties > Portal** verfügen. Ein allein über ein Tag gewährter Zugriff reicht nicht aus.
3. **Ausführen des Skripts:** Der Benutzer muss über die entsprechende Berechtigung **Automation Scripts > Execute** verfügen.

**Wichtig:** Portalrollen, Tag-Rollen und Execute-Berechtigungen ersetzen einander nicht. Ein Skript kann aufgelistet werden, beim Öffnen jedoch **Unauthorized** zurückgeben, oder es kann sich öffnen lassen, aber nicht ausgeführt werden, wenn der Benutzer nicht alle geltenden Anforderungen erfüllt.

Tags bestimmen auch, wo ein Skript aufgelistet wird:

| Konfiguration                                                                                             | Portal-Ergebnis                                                            |
| --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Übereinstimmende Skript-Portalrolle und keine Tags                                                        | Im Portal-Stammverzeichnis aufgelistet                                     |
| Autorisiertes **Display in Portal**-Tag                                                                   | Unter dem Tag aufgelistet                                                  |
| Autorisiertes Tag, aber keine übereinstimmende Skript-Portalrolle                                         | Unter dem Tag aufgelistet, gibt beim Öffnen jedoch **Unauthorized** zurück |
| Übereinstimmende Skript-Portalrolle, aber keine Execute-Berechtigung                                      | Kann aufgelistet und geöffnet, aber nicht ausgeführt werden                |
| Nur Tags ohne **Display in Portal**                                                                       | Nicht aufgelistet, selbst mit einer übereinstimmenden Skript-Portalrolle   |
| Übereinstimmende Skript-Portalrolle, Execute-Berechtigung und ein autorisiertes **Display in Portal**-Tag | Unter dem Tag aufgelistet und kann geöffnet und ausgeführt werden          |

Ein Tag ist autorisiert, wenn **Display in Portal** aktiviert ist und das Tag eine dem Benutzer zugewiesene Rolle enthält. Wenn ein Skript Tags hat, wird es nicht im Portal-Stammverzeichnis aufgelistet. Mindestens ein autorisiertes **Display in Portal**-Tag ist erforderlich, damit es auffindbar ist.

### Skripttabelle

Das Skripttabellen-Widget zeigt eine Tabelle basierend auf der letzten Ausgabe eines Skripts an. Dabei wird der neueste Auftrag ausgewählt und die Tabelle anhand der Eigenschaften der zurückgegebenen Objekte generiert. Führen Sie beispielsweise ein Skript aus, das die Prozesse auf dem aktuellen Computer zurückgibt.

```powershell
Get-Process | Select-Object Name, Id
```

### Skript-Kreisdiagramm

Das Skript-Kreisdiagramm-Widget zeigt ein Diagramm basierend auf den Daten der letzten Ausführung eines Skripts an. Das Skript muss Daten in einem bestimmten Format ausgeben, um die Segmente des Diagramms zu definieren. Nachfolgend finden Sie ein Beispiel dafür, wie Sie Daten für ein Kreisdiagramm generieren.

```powershell
1..5 | ForEach-Object {
    [PSCustomObject]@{ 
        type = "Category $_"
        value = Get-Random -Min 5 -Max 60
    }
}
```

Legen Sie in den Eigenschaften des Kreisdiagramm-Widgets die Category Property auf `type` und die Value Property auf `value` fest.

### Skript-Liniendiagramm

Das Skript-Liniendiagramm-Widget zeigt ein Diagramm basierend auf den Daten der letzten Ausführung eines Skripts an. Das Skript muss Daten in einem bestimmten Format ausgeben, um die Linien des Diagramms zu definieren. Nachfolgend finden Sie ein Beispiel dafür, wie Sie Daten für ein Liniendiagramm generieren.

```powershell
1..5 | ForEach-Object {
    [PSCustomObject]@{ 
        type = "Category $_"
        value = Get-Random -Min 5 -Max 60
    }
}
```

Legen Sie in den Eigenschaften des Liniendiagramm-Widgets die XProperty auf `type` und die YProperty auf `value` fest.

## Vorgefertigte Widgets

Von Ironman Software und Community-Mitgliedern erstellte Widgets finden Sie in der[ PowerShell Universal Gallery](/powershell-universal/de/plattform/library.md).

## Benutzerdefinierte Widgets

Sie können Ihre eigenen benutzerdefinierten Widgets mit PSBlazor entwickeln. PSBlazor verwendet eine Razor-ähnliche Syntax in Kombination mit PowerShell, um die Erstellung vollständig interaktiver und anpassbarer Komponenten zu ermöglichen.


---

# 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/portal/portal-widgets.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.
