> 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/powershell-befehle/new-psudashboard.md).

# New-PSUDashboard

New-PSUDashboard erstellt eine neue App in PowerShell Universal aus einem Dateipfad, Skriptinhalt oder Modul und verwendet dabei den Namen des veralteten Dashboard-Cmdlets.

## SYNOPSIS

Erstellt eine neue App in PowerShell Universal.

## SYNTAX

```powershell
New-PSUDashboard -Name <String> [-FilePath <String>] [<AppOptions>] [<ConnectionOptions>] [<CommonParameters>]
New-PSUDashboard -Name <String> -Content <ScriptBlock> [<AppOptions>] [<ConnectionOptions>] [<CommonParameters>]
New-PSUDashboard -Name <String> [-Module <String>] [-Command <String>] [<AppOptions>] [<ConnectionOptions>] [<CommonParameters>]
```

`<AppOptions>`: `[-BaseUrl <String>] [-Environment <String>] [-GrantAppToken] [-Maintenance] [-Authenticated] [-Role <String[]>] [-DisableAutoStart] [-Component <DashboardComponent[]>] [-SessionTimeout <Int32>] [-IdleTimeout <Int32>] [-AutoDeploy] [-Description <String>] [-Credential <String>] [-DisableErrorToast] [-DisableStartupLog] [-VerboseErrorMessages] [-Tag <Tag[]>] [-DisableInteractiveHost] [-FavIcon <String>] [-OnSessionTimeout <ScriptBlock>] [-ComputerGroup <String[]>] [-AvailableInBranch <String[]>] [-Critical]`.

`<ConnectionOptions>`: `[-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]`. Hier ist `-Credential` der Name der Ausführungsanmeldeinformation der App und nicht die Basic-Anmeldeinformationen der Verwaltungs-API.

## BESCHREIBUNG

Dieser ältere Cmdlet-Name ist ein Alias von `New-PSUApp`. Erstellen Sie die App aus einer Datei im Repository, aus Inline-Inhalt oder aus einem Modulbefehl. `-FilePath` ist im Standardparametersatz optional. `-Component` wird aus Kompatibilitätsgründen beibehalten, aber nicht verwendet. `-Critical` bewirkt, dass ein Fehler beim Starten der App dazu führt, dass der Endpunkt `/api/v1/status` 500 zurückgibt.

## BEISPIELE

```powershell
New-PSUDashboard -Name 'App' -BaseUrl '/app' -FilePath 'app.ps1'
```

Erstellt eine App mithilfe der Datei `app.ps1` im Repository und stellt sie unter `/app` bereit.

## PARAMETER

| Parameter                 | Beschreibung                                                                                      |
| ------------------------- | ------------------------------------------------------------------------------------------------- |
| `-Name`                   | Erforderlicher App-Name.                                                                          |
| `-FilePath`               | Pfad zum App-Skript im Repository.                                                                |
| `-Content`                | Inline-Skriptblock der App (im Parametersatz Content erforderlich).                               |
| `-Module`                 | Modul, das den Befehl zum Definieren der App enthält.                                             |
| `-Command`                | Modulbefehl, mit dem die App definiert wird.                                                      |
| `-BaseUrl`                | URL-Pfad der App (zum Beispiel `/app`); standardmäßig `/`.                                        |
| `-Environment`            | Ausführungsumgebung der App.                                                                      |
| `-GrantAppToken`          | Gewährt App-Benutzern ein App-Token, mit dem sie als sie selbst auf PSU zugreifen.                |
| `-Maintenance`            | Aktiviert den Wartungsmodus.                                                                      |
| `-Authenticated`          | Erfordert eine Authentifizierung für die App.                                                     |
| `-Role`                   | Rollen, die auf die App zugreifen dürfen.                                                         |
| `-DisableAutoStart`       | Deaktiviert den Start zusammen mit dem Server.                                                    |
| `-Component`              | Option für Abwärtskompatibilität; ungenutzt.                                                      |
| `-SessionTimeout`         | Sitzungstimeout der App.                                                                          |
| `-IdleTimeout`            | Leerlauftimeout der App.                                                                          |
| `-AutoDeploy`             | Stellt App-Änderungen automatisch bereit.                                                         |
| `-Description`            | Beschreibung der App.                                                                             |
| `-Credential`             | Name der Ausführungsanmeldeinformation der App (nicht die Authentifizierung der Verwaltungs-API). |
| `-DisableErrorToast`      | Unterdrückt Fehler-Popups der App.                                                                |
| `-DisableStartupLog`      | Deaktiviert das Startprotokoll der App.                                                           |
| `-VerboseErrorMessages`   | Zeigt ausführliche Fehlermeldungen der App an.                                                    |
| `-Tag`                    | Der App zugeordnete Tags.                                                                         |
| `-DisableInteractiveHost` | Deaktiviert interaktive Hostfunktionen wie `Read-Host`.                                           |
| `-FavIcon`                | Favicon der App.                                                                                  |
| `-OnSessionTimeout`       | Skriptblock, der beim Sitzungstimeout ausgeführt wird.                                            |
| `-ComputerGroup`          | Der App zugewiesene Computergruppen.                                                              |
| `-AvailableInBranch`      | Beschränkt die App auf diese Branches.                                                            |
| `-Critical`               | Behandelt einen Fehler beim Starten der App als Fehler des Statusendpunkts.                       |
| `-ComputerName`           | URL oder Hostname des Ziel-PSU-Servers (Alias `-Uri`).                                            |
| `-AppToken`               | App-Token der Verwaltungs-API.                                                                    |
| `-UseDefaultCredentials`  | Verwendet die aktuellen Windows-Anmeldeinformationen.                                             |
| `-Integrated`             | Verwendet den prozessinternen Verwaltungsclient.                                                  |
| `-TrustCertificate`       | Ignoriert Fehler bei der Zertifikatsvalidierung.                                                  |
| `-Cookies`                | Verwendet die Authentifizierungscookies der Sitzung erneut.                                       |

## BERECHTIGUNGEN

Das Zugriffstoken erfordert `apps/create`, um dieses Cmdlet remote auszuführen.


---

# 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/powershell-befehle/new-psudashboard.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.