New-PSUApp
SINOPSIS
Crea una nueva app en PowerShell Universal.
SINTAXIS
FilePath (predeterminado)
New-PSUApp [-FilePath <String>] [-BaseUrl <String>] -Name <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] [-ComputerName <String>] [-AppToken <String>]
[-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
[<CommonParameters>]Content
New-PSUApp -Content <ScriptBlock> [-BaseUrl <String>] -Name <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] [-ComputerName <String>] [-AppToken <String>]
[-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
[<CommonParameters>]Module
DESCRIPCIÓN
Crea una nueva app en PowerShell Universal.
EJEMPLOS
Ejemplo 1
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.
-Authenticated
Cuando se especifica, se habilita la autenticación para esta app.
-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.
-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.
-Command
El comando utilizado para crear esta app.
-Component
No se utiliza. Solo está presente por compatibilidad con versiones anteriores.
-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.
-Content
El contenido de esta app.
-Credential
La credencial de usuario con la que se ejecutará esta app.
-Description
Una descripción de esta app.
-DisableAutoStart
Si se debe deshabilitar el inicio automático de esta app cuando arranca el servidor.
-DisableErrorToast
Si se deben deshabilitar los avisos de error para esta app.
-DisableInteractiveHost
Si se debe deshabilitar el host interactivo para esta app. Write-Host, Read-Host, Get-Credential y otras funciones dejarán de funcionar.
-DisableStartupLog
Si se debe deshabilitar el registro de inicio para esta app.
-Environment
El entorno en el que se ejecutará esta app.
-FavIcon
La URL del favicon de esta app.
-FilePath
La ruta al fichero que contiene el contenido de esta app.
-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.
-IdleTimeout
El tiempo de espera de inactividad de esta app.
-Integrated
Ejecuta el comando internamente en lugar de usar la API de gestión. Solo funciona cuando se ejecuta el script desde PowerShell Universal.
-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.
-Module
El módulo que contiene el comando utilizado para definir esta app.
-Name
El nombre de esta app.
-Role
Roles que tienen acceso a esta app.
-SessionTimeout
El tiempo de espera de sesión de esta app.
-Tag
Etiquetas que se aplicarán a esta app.
-UseDefaultCredentials
Usar credenciales predeterminadas al conectarse a la API de gestión
-VerboseErrorMessages
Si se deben mostrar mensajes de error detallados para esta app.
-ComputerGroup
Especifica el grupo de ordenadores al que dirigirse o asignar.
-OnSessionTimeout
Especifica el bloque de script que se ejecutará cuando una sesión de la app expire.
-AvailableInBranch
Cuando se especifica, esta app solo se mostrará y se ejecutará en las ramas especificadas.
-TrustCertificate
Si el cmdlet debe ignorar los problemas de certificado.
-Critical
La app es crítica. Esto hará que el endpoint /api/v1/status devuelva un 500 si la app no se inició.
-Cookies
Reutiliza y conserva las cookies de autenticación para la sesión actual de PowerShell.
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.
ENTRADAS
Ninguna
SALIDAS
System.Object
NOTAS
ENLACES RELACIONADOS
Última actualización
¿Te fue útil?