> 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-psuapp.md). # New-PSUApp ## SINOPSIS Crea una nueva app en PowerShell Universal. ## SINTAXIS ### FilePath (predeterminado) ``` New-PSUApp [-FilePath ] [-BaseUrl ] -Name [-Environment ] [-GrantAppToken] [-Maintenance] [-Authenticated] [-Role ] [-DisableAutoStart] [-Component ] [-SessionTimeout ] [-IdleTimeout ] [-AutoDeploy] [-Description ] [-Credential ] [-DisableErrorToast] [-DisableStartupLog] [-VerboseErrorMessages] [-Tag ] [-DisableInteractiveHost] [-FavIcon ] [-OnSessionTimeout ] [-ComputerGroup ] [-AvailableInBranch ] [-Critical] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Content ``` New-PSUApp -Content [-BaseUrl ] -Name [-Environment ] [-GrantAppToken] [-Maintenance] [-Authenticated] [-Role ] [-DisableAutoStart] [-Component ] [-SessionTimeout ] [-IdleTimeout ] [-AutoDeploy] [-Description ] [-Credential ] [-DisableErrorToast] [-DisableStartupLog] [-VerboseErrorMessages] [-Tag ] [-DisableInteractiveHost] [-FavIcon ] [-OnSessionTimeout ] [-ComputerGroup ] [-AvailableInBranch ] [-Critical] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Module ``` New-PSUApp [-BaseUrl ] -Name [-Environment ] [-GrantAppToken] [-Maintenance] [-Authenticated] [-Role ] [-DisableAutoStart] [-Component ] [-SessionTimeout ] [-IdleTimeout ] [-AutoDeploy] [-Description ] [-Credential ] [-DisableErrorToast] [-DisableStartupLog] [-VerboseErrorMessages] [-Tag ] [-DisableInteractiveHost] [-Module ] [-Command ] [-FavIcon ] [-OnSessionTimeout ] [-ComputerGroup ] [-AvailableInBranch ] [-Critical] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPCIÓN Crea una nueva app en PowerShell Universal. ## EJEMPLOS ### Ejemplo 1 ```powershell New-PSUApp -Name 'App' -BaseUrl '/app' -FilePath "app.ps1" ``` Crea una app utilizando el fichero app.ps1 del directorio del repositorio y la sirve en la URL base /app. ## PARÁMETROS ### -AppToken El AppToken que se utiliza para llamar a la API de gestión de PowerShell Universal. También puede llamar a Connect-PSUServer antes de llamar a este cmdlet para establecer el AppToken para toda la sesión. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Authenticated Cuando se especifica, se habilita la autenticación para esta app. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AutoDeploy Si se debe implementar esta app cuando se realicen cambios. Si no se especifica, la app debe reiniciarse antes de que se apliquen los cambios. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -BaseUrl La URL base para acceder a esta app. Puede usar / para servir la app en la raíz del servidor o /app para servir la app en /app. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Command El comando utilizado para crear esta app. ```yaml Type: String Parameter Sets: Module Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Component No se utiliza. Solo está presente por compatibilidad con versiones anteriores. ```yaml Type: DashboardComponent[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Especifica el nombre del ordenador o la URL que se debe llamar al acceder a la API de gestión de PowerShell Universal. También puede usar Connect-PSUServer antes de llamar a este cmdlet para establecer el nombre del ordenador para toda la sesión. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Content El contenido de esta app. ```yaml Type: ScriptBlock Parameter Sets: Content Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential La credencial de usuario con la que se ejecutará esta app. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Description Una descripción de esta app. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableAutoStart Si se debe deshabilitar el inicio automático de esta app cuando arranca el servidor. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableErrorToast Si se deben deshabilitar los avisos de error para esta app. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableInteractiveHost Si se debe deshabilitar el host interactivo para esta app. Write-Host, Read-Host, Get-Credential y otras funciones dejarán de funcionar. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableStartupLog Si se debe deshabilitar el registro de inicio para esta app. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Environment El entorno en el que se ejecutará esta app. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -FavIcon La URL del favicon de esta app. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -FilePath La ruta al fichero que contiene el contenido de esta app. ```yaml Type: String Parameter Sets: FilePath Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -GrantAppToken Si se debe conceder un token de app a los usuarios de esta app. Puede usar el token de app dentro de su app para acceder a los recursos de PSU como el usuario que inicia sesión. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -IdleTimeout El tiempo de espera de inactividad de esta app. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Ejecuta el comando internamente en lugar de usar la API de gestión. Solo funciona cuando se ejecuta el script desde PowerShell Universal. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Maintenance Si se debe poner esta app en modo de mantenimiento. Solo los administradores podrán acceder a la app cuando esté en modo de mantenimiento. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Module El módulo que contiene el comando utilizado para definir esta app. ```yaml Type: String Parameter Sets: Module Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name El nombre de esta app. ```yaml Type: String Parameter Sets: (All) Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Role Roles que tienen acceso a esta app. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SessionTimeout El tiempo de espera de sesión de esta app. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Tag Etiquetas que se aplicarán a esta app. ```yaml Type: Tag[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Usar credenciales predeterminadas al conectarse a la API de gestión ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -VerboseErrorMessages Si se deben mostrar mensajes de error detallados para esta app. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerGroup Especifica el grupo de ordenadores al que dirigirse o asignar. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -OnSessionTimeout Especifica el bloque de script que se ejecutará cuando una sesión de la app expire. ```yaml Type: ScriptBlock Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AvailableInBranch Cuando se especifica, esta app solo se mostrará y se ejecutará en las ramas especificadas. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Si el cmdlet debe ignorar los problemas de certificado. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Critical La app es crítica. Esto hará que el endpoint /api/v1/status devuelva un 500 si la app no se inició. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Reutiliza y conserva las cookies de autenticación para la sesión actual de PowerShell. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable y -ProgressAction. Para más información, consulte [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## ENTRADAS ### Ninguna ## SALIDAS ### System.Object ## NOTAS ## ENLACES RELACIONADOS --- # 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/es/comandos-de-powershell/new-psuapp.md?ask=&goal= ``` `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.