> 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/es/comandos-de-powershell/new-psudashboard.md).

# New-PSUDashboard

New-PSUDashboard crea una nueva aplicación en PowerShell Universal a partir de una ruta de fichero, el contenido de un script o un módulo, usando el nombre heredado del cmdlet de dashboard.

## SINOPSIS

Crea una nueva aplicación en PowerShell Universal.

## SINTAXIS

```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]`. Aquí, `-Credential` es el nombre de la credencial de ejecución de la aplicación, no las credenciales básicas de la API de administración.

## DESCRIPCIÓN

Este nombre de cmdlet heredado es un alias de `New-PSUApp`. Cree la aplicación a partir de un archivo del repositorio, de contenido insertado o de un comando de módulo. `-FilePath` es opcional en el conjunto de parámetros predeterminado. `-Component` se conserva por compatibilidad, pero no se utiliza. `-Critical` hace que un error al iniciar la aplicación provoque que el punto de conexión `/api/v1/status` devuelva 500.

## EJEMPLOS

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

Crea una aplicación con el archivo `app.ps1` del repositorio y la sirve en `/app`.

## PARÁMETROS

| Parámetro                 | Descripción                                                                                              |
| ------------------------- | -------------------------------------------------------------------------------------------------------- |
| `-Name`                   | Nombre de aplicación obligatorio.                                                                        |
| `-FilePath`               | Ruta del script de la aplicación en el repositorio.                                                      |
| `-Content`                | Bloque de script insertado de la aplicación (obligatorio en el conjunto de parámetros Content).          |
| `-Module`                 | Módulo que contiene el comando que define la aplicación.                                                 |
| `-Command`                | Comando de módulo utilizado para definir la aplicación.                                                  |
| `-BaseUrl`                | Ruta de URL de la aplicación (por ejemplo, `/app`); el valor predeterminado es `/`.                      |
| `-Environment`            | Entorno de ejecución de la aplicación.                                                                   |
| `-GrantAppToken`          | Concede a los usuarios de la aplicación un token de aplicación para acceder a PSU como ellos mismos.     |
| `-Maintenance`            | Activa el modo de mantenimiento.                                                                         |
| `-Authenticated`          | Requiere autenticación para la aplicación.                                                               |
| `-Role`                   | Roles con permiso para acceder a la aplicación.                                                          |
| `-DisableAutoStart`       | Desactiva el inicio junto con el servidor.                                                               |
| `-Component`              | Opción de compatibilidad con versiones anteriores; no se utiliza.                                        |
| `-SessionTimeout`         | Tiempo de espera de la sesión de la aplicación.                                                          |
| `-IdleTimeout`            | Tiempo de inactividad de la aplicación.                                                                  |
| `-AutoDeploy`             | Implementa automáticamente los cambios de la aplicación.                                                 |
| `-Description`            | Descripción de la aplicación.                                                                            |
| `-Credential`             | Nombre de la credencial de ejecución de la aplicación (no la autenticación de la API de administración). |
| `-DisableErrorToast`      | Suprime las notificaciones de error de la aplicación.                                                    |
| `-DisableStartupLog`      | Desactiva el registro de inicio de la aplicación.                                                        |
| `-VerboseErrorMessages`   | Muestra mensajes de error detallados de la aplicación.                                                   |
| `-Tag`                    | Etiquetas aplicadas a la aplicación.                                                                     |
| `-DisableInteractiveHost` | Desactiva las características de host interactivo, como `Read-Host`.                                     |
| `-FavIcon`                | Favicon de la aplicación.                                                                                |
| `-OnSessionTimeout`       | Bloque de script que se ejecuta al agotar el tiempo de espera de la sesión.                              |
| `-ComputerGroup`          | Grupos de ordenadores asignados a la aplicación.                                                         |
| `-AvailableInBranch`      | Restringe la aplicación a estas ramas.                                                                   |
| `-Critical`               | Trata el error de inicio de la aplicación como un error del punto de conexión de estado.                 |
| `-ComputerName`           | URL o nombre de host del servidor PSU de destino (alias `-Uri`).                                         |
| `-AppToken`               | Token de aplicación de la API de administración.                                                         |
| `-UseDefaultCredentials`  | Usa las credenciales actuales de Windows.                                                                |
| `-Integrated`             | Usa el cliente de administración en proceso.                                                             |
| `-TrustCertificate`       | Ignora los errores de validación del certificado.                                                        |
| `-Cookies`                | Reutiliza las cookies de autenticación de la sesión.                                                     |

## PERMISOS

El token de acceso requiere `apps/create` para ejecutar este cmdlet de forma remota.


---

# 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/es/comandos-de-powershell/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.