> 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.

### Übersicht

Erstellt eine neue App in PowerShell Universal.

### Syntax

```powershell
New-PSUDashboard [-AppToken <String>] [-Authenticated] [-AutoDeploy] [-BaseUrl <String>] [-Command <String>] [-Component <DashboardComponent[]>] [-ComputerName <String>] [-Credential <String>] [-Description <String>] [-DisableAutoStart] [-DisableErrorToast] [-DisableInteractiveHost] [-DisableStartupLog] [-Environment <String>] [-FavIcon <String>] [-GrantAppToken] [-IdleTimeout <Int32>] [-Integrated] [-Maintenance] [-Module <String>] -Name <String> [-Role <String[]>] [-SessionTimeout <Int32>] [-Tag <Tag[]>] [-UseDefaultCredentials] [-VerboseErrorMessages] [-ComputerGroup <String[]>] [-OnSessionTimeout <ScriptBlock>] [-AvailableInBranch <String[]>] [-TrustCertificate] [-Critical] [<CommonParameters>]

New-PSUDashboard [-AppToken <String>] [-Authenticated] [-AutoDeploy] [-BaseUrl <String>] [-Component <DashboardComponent[]>] [-ComputerName <String>] -Content <ScriptBlock> [-Credential <String>] [-Description <String>] [-DisableAutoStart] [-DisableErrorToast] [-DisableInteractiveHost] [-DisableStartupLog] [-Environment <String>] [-FavIcon <String>] [-GrantAppToken] [-IdleTimeout <Int32>] [-Integrated] [-Maintenance] -Name <String> [-Role <String[]>] [-SessionTimeout <Int32>] [-Tag <Tag[]>] [-UseDefaultCredentials] [-VerboseErrorMessages] [-ComputerGroup <String[]>] [-OnSessionTimeout <ScriptBlock>] [-AvailableInBranch <String[]>] [-TrustCertificate] [-Critical] [<CommonParameters>]

New-PSUDashboard [-AppToken <String>] [-Authenticated] [-AutoDeploy] [-BaseUrl <String>] [-Component <DashboardComponent[]>] [-ComputerName <String>] [-Credential <String>] [-Description <String>] [-DisableAutoStart] [-DisableErrorToast] [-DisableInteractiveHost] [-DisableStartupLog] [-Environment <String>] [-FavIcon <String>] [-FilePath <String>] [-GrantAppToken] [-IdleTimeout <Int32>] [-Integrated] [-Maintenance] -Name <String> [-Role <String[]>] [-SessionTimeout <Int32>] [-Tag <Tag[]>] [-UseDefaultCredentials] [-VerboseErrorMessages] [-ComputerGroup <String[]>] [-OnSessionTimeout <ScriptBlock>] [-AvailableInBranch <String[]>] [-TrustCertificate] [-Critical] [<CommonParameters>]
```

### Beschreibung

Erstellt eine neue App in PowerShell Universal.

### Parameter

#### -AppToken

Das AppToken, das für den Aufruf der PowerShell Universal Management API verwendet wird. Sie können auch Connect-PSUServer vor diesem Cmdlet aufrufen, um das AppToken für die gesamte Sitzung festzulegen.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Authenticated

Wenn angegeben, ist die Authentifizierung für diese App aktiviert.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -AutoDeploy

Ob diese App bei Änderungen bereitgestellt werden soll. Wenn nicht angegeben, muss die App neu gestartet werden, bevor Änderungen angewendet werden.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -BaseUrl

Die Basis-URL für den Zugriff auf diese App. Sie können / verwenden, um die App im Stammverzeichnis des Servers bereitzustellen, oder /app, um die App unter /app bereitzustellen.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Command

Der Befehl, der zum Erstellen dieser App verwendet wird.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Component \<DashboardComponent\[]>

Nicht verwendet. Nur zur Abwärtskompatibilität vorhanden.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -ComputerName

Gibt den Computernamen oder die URL an, die beim Zugriff auf die PowerShell Universal Management API aufgerufen werden soll. Sie können auch Connect-PSUServer vor diesem Cmdlet verwenden, um den Computernamen für die gesamte Sitzung festzulegen.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      Uri
Accept wildcard characters?  false
```

#### -Content

Der Inhalt dieser App.

```
Required?                    true
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Credential

Die Benutzeranmeldeinformationen, unter denen diese App ausgeführt wird.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Description

Eine Beschreibung dieser App.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -DisableAutoStart

Ob der automatische Start dieser App beim Serverstart deaktiviert werden soll.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -DisableErrorToast

Ob Fehler-Toasts für diese App deaktiviert werden sollen.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -DisableInteractiveHost

Ob der interaktive Host für diese App deaktiviert werden soll. Write-Host, Read-Host, Get-Credential und andere Funktionen funktionieren dann nicht mehr.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -DisableStartupLog

Ob das Startprotokoll für diese App deaktiviert werden soll.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Environment

Die Umgebung, in der diese App ausgeführt wird.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -FavIcon

Die URL zum Favicon für diese App.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -FilePath

Der Pfad zu der Datei, die den Inhalt für diese App enthält.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -GrantAppToken

Ob Benutzern dieser App ein App-Token gewährt werden soll. Sie können das App-Token innerhalb Ihrer App verwenden, um als angemeldeter Benutzer auf Ressourcen von PSU zuzugreifen.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -IdleTimeout

Das Leerlauf-Timeout für diese App.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Integrated

Führt den Befehl intern aus, anstatt die Management API zu verwenden. Funktioniert nur, wenn das Skript innerhalb von PowerShell Universal ausgeführt wird.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Maintenance

Ob diese App in den Wartungsmodus versetzt werden soll. Im Wartungsmodus können nur Administratoren auf die App zugreifen.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Module

Das Modul, das den Befehl enthält, mit dem diese App definiert wird.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Name

Der Name dieser App.

```
Required?                    true
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Role \<String\[]>

Rollen, die Zugriff auf diese App haben.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -SessionTimeout

Das Sitzungs-Timeout für diese App.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Tag \<Tag\[]>

Tags, die auf diese App angewendet werden sollen.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -UseDefaultCredentials

Standardanmeldeinformationen bei der Verbindung mit der Management API verwenden

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -VerboseErrorMessages

Ob ausführliche Fehlermeldungen für diese App angezeigt werden sollen.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -ComputerGroup \<String\[]>

{{ Fill ComputerGroup Description }}

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -OnSessionTimeout

{{ Fill OnSessionTimeout Description }}

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -AvailableInBranch \<String\[]>

Wenn angegeben, wird diese App nur in den angegebenen Branches angezeigt und ausgeführt.

```
Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -TrustCertificate

Ob das Cmdlet Zertifikatsprobleme ignorieren soll.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### -Critical

Die App ist kritisch. Dadurch gibt der Endpunkt /api/v1/status den Status 500 zurück, wenn die App nicht gestartet wurde.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false
```

#### Allgemeine Parameter

Dieses Cmdlet unterstützt die allgemeinen Parameter: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable und OutVariable. Weitere Informationen finden Sie unter [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

### Eingaben

Keine

### Ausgaben

System.Object

### Hinweise

### Beispiele

#### Beispiel 1

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

Erstellt eine App mithilfe der Datei app.ps1 im Repository-Verzeichnis und stellt sie unter der Basis-URL /app bereit.


---

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