Aplicaciones
Crear una aplicación
El primer paso es crear una aplicación en PowerShell Universal. Este es el contenedor de todas las páginas y componentes del sitio web de su aplicación. Recomendamos ejecutar las aplicaciones en entornos externos, como PowerShell 7, para garantizar que estén aisladas del resto del servidor. Para crear una aplicación, haga clic en Apps \ Apps y luego en Create New App.
Deberá proporcionar un nombre y una URL únicos para la aplicación al crearla. Todas las demás propiedades son opcionales. Después de crear la aplicación, puede editar su código. Por ejemplo, pruebe a añadir un componente a su aplicación.
New-UDApp -Content {
New-UDButton -Text 'Click Me' -OnClick {
Show-UDToast "Ouch!"
}
}Una vez que haya guardado su aplicación, puede hacer clic en el icono del globo terráqueo para ver el resultado. Al hacer clic en el botón se mostrará un mensaje toast en su navegador.
New-UDApp
El cmdlet de nivel superior para los dashboards es New-UDApp. Debe llamarlo al devolver una aplicación. Puede usarlo con o sin páginas.
Contenido
El contenido de la aplicación es una serie de componentes que se muestran en la página. Es un bloque de script que devolverá todos los componentes en el orden en que se renderizarán en la página. Puede usar el componente Grid para organizar los elementos y mostrar cosas como texto con tipografía.
New-UDApp -Title 'My New Dashboard' -Content {
New-UDTypography -Text 'Hello!'
}Personalización del encabezado
Puede personalizar el encabezado de la aplicación mediante varios parámetros.
Posición
Use el parámetro -HeaderPosition para ajustar el comportamiento del encabezado.
absolute\fixed - Permanece en la parte superior de la página, incluso al desplazarse
relative - Permanece en la parte superior de la página. No es visible al desplazarse.
Colores
Puede ajustar los colores del encabezado especificando los parámetros -HeaderColor y -HeaderBackgroundColor. Estos colores anularán los colores del tema.
Contenido
Puede definir contenido personalizado para incluir en el encabezado mediante el parámetro -HeaderContent.
Desactivar el conmutador de tema
Puede eliminar el conmutador de tema con -DisableThemeToggle.
Logotipo
Puede cambiar la imagen del logotipo proporcionando una URL al parámetro -Logo.
Navegación
Para cambiar el diseño de la navegación, use los parámetros -Navigation y -NavigationLayout.
Componentes
Los componentes son los widgets individuales que puede colocar en su aplicación. Hay componentes para mostrar datos, recibir entradas del usuario, añadir texto e imágenes y mucho más. Los componentes se pueden descargar como módulos de PowerShell y añadirse a su aplicación.
Los componentes se invocan usando la sintaxis estándar verbo-nombre de cualquier cmdlet de PowerShell.
Más información sobre los componentes aquí.
Páginas
Puede especificar varias páginas dentro de una aplicación. Cada página define una ruta. A partir de la v3, todas las páginas son dinámicas. PowerShell se ejecutará en cada carga de página para renderizar la nueva página. Dado que UD es una aplicación de una sola página, el navegador web no necesita actualizar toda la página web al navegar entre las diferentes páginas de la aplicación.
Más información sobre las páginas aquí.
Módulo
Las aplicaciones tendrán acceso automáticamente a cualquier comando disponible dentro de PSModulePath, así como a los módulos que cargue directamente en la propia aplicación. Dicho esto, también puede definir funciones dentro de la propia aplicación. Estas funciones se incluirán en un módulo que se almacena junto al código de su aplicación. Cualquier función definida en este fichero se incluirá automáticamente en su aplicación.
Dentro de la consola de administración de PowerShell Universal, defina funciones, variables y alias en la pestaña Module. Cualquier función definida se escribirá en un fichero PSM1 en el mismo directorio que el código de la aplicación.
Variables integradas
Las variables integradas se pueden encontrar en la página de variables.
Depuración
Al crear una aplicación, probablemente se encuentre con problemas con las llamadas a cmdlets o con la sintaxis. Las aplicaciones se recargarán automáticamente a medida que realice cambios en los ficheros de la aplicación. Si una aplicación no se inicia, puede ir a la página de administración, hacer clic en Apps y luego en el botón Info junto a su aplicación.
La pestaña Log mostrará todo el registro procedente de la ejecución de PowerShell dentro de su aplicación. Esto debería permitirle ver fácilmente los errores y advertencias procedentes de su aplicación.
Puede usar Write-Debug para añadir mensajes de registro adicionales a su aplicación. Para habilitar el registro de depuración, deberá establecer la variable $DebugPreference en la parte superior del script de su aplicación.
Menú
Puede personalizar el menú de la aplicación mediante el parámetro -Menu.
Iniciar y detener aplicaciones
De forma similar a los trabajos, las aplicaciones pueden ejecutarse en procesos de PowerShell separados. Puede iniciar y detener un proceso de aplicación haciendo clic en el botón Start o Stop de la página Apps.
Runspaces persistentes
Los runspaces persistentes le permiten mantener el estado del runspace dentro de los controladores de eventos de su aplicación. Esto es importante para los usuarios que realizan algún tipo de inicialización dentro de sus endpoints y no desean que se ejecute en las llamadas posteriores.
De forma predeterminada, los runspaces se restablecerán después de cada ejecución. Esto afectará a las variables, módulos y funciones definidos durante la ejecución de un endpoint.
Para habilitar los runspaces persistentes, deberá configurar un entorno para su API. Establezca el parámetro -PersistentRunspace para habilitar esta función. Esto se configura en el script environments.ps1.
Deberá asegurarse de que la aplicación utilice el entorno.
Conceder tokens de aplicación automáticamente
Puede conceder automáticamente tokens de aplicación a los usuarios que visitan las aplicaciones. Esto es útil si desea invocar la API de administración de PowerShell Universal desde dentro de una aplicación. Su aplicación deberá tener la autenticación habilitada y tendrá que usar el parámetro de conmutador -GrantAppToken en New-PSUDashboard.
Desde dentro de su aplicación, ahora puede invocar la API de administración sin tener que preocuparse por la gestión de tokens de aplicación. La API se invocará en el contexto del usuario que está visitando la aplicación.
Desactivar los mensajes toast de error
De forma predeterminada, las aplicaciones mostrarán un mensaje toast cuando se genere un error dentro de un script de endpoint. Para evitar este comportamiento, puede usar el parámetro -DisableErrorToast de New-UDApp
Desactivar el registro de inicio
Al iniciar una aplicación, la información sobre las variables y los módulos se muestra en el registro de la aplicación. Si desea suprimir esta información, puede usar el parámetro -DisableStartupLogging.
Aplicaciones críticas
Las aplicaciones críticas, definidas mediante el parámetro -Critical, son aplicaciones que harán que el endpoint de estado del balanceador de carga devuelva un código de respuesta 500 si la aplicación no se está ejecutando. El endpoint de estado del balanceador de carga es /api/v1/status .
Véase también
Última actualización
¿Te fue útil?