For the complete documentation index, see llms.txt. This page is also available as Markdown.

Interacción

Invoke-UDRedirect https://devolutions.net/powershell-universal/

Universal Apps permite crear sitios web interactivos con PowerShell. Varios cmdlets proporcionan información al usuario, actualizan componentes, leen el estado de los componentes y conservan las preferencias locales del navegador.

Portapapeles

Puede establecer datos de cadena en el portapapeles del usuario con Set-UDClipboard.

New-UDButton -Text 'Clipboard' -OnClick {
    Set-UDClipboard -Data 'Hello, there!'
}

API

  • Set-UDClipboard

Descargas

Puede iniciar una descarga en el navegador del usuario utilizando Start-UDDownload. Debido a la seguridad del navegador, el usuario debe realizar una acción, como hacer clic en un botón, para permitir la descarga. Start-UDDownload no es adecuado para descargas de ficheros grandes.

New-UDButton -Text 'Download' -OnClick {
    Start-UDDownload -StringData 'Hello, World!'
}

Almacenamiento local

Utilice Set-UDLocalStorage y Get-UDLocalStorage para conservar las preferencias de la aplicación de un usuario en el almacenamiento local del navegador. Los valores permanecen disponibles después de recargar la página y cuando el usuario abre más tarde la misma aplicación en el mismo perfil de navegador.

PowerShell Universal limita el ámbito de los valores almacenados al dashboard y al navegador. No se comparten con otros usuarios, navegadores ni dashboards. Utilice estos cmdlets desde un controlador de eventos interactivo para que PowerShell Universal pueda comunicarse con el navegador conectado.

Los valores se serializan con el serializador de PowerShell antes de almacenarse, por lo que puede guardar y recuperar objetos de PowerShell y tablas hash. Get-UDLocalStorage devuelve $null cuando el elemento no existe.

El almacenamiento local del navegador puede ser leído y modificado por el código que se ejecuta en la página. No almacene en él contraseñas, credenciales, claves de API, tokens ni otros datos sensibles. Trate los valores almacenados como entradas controladas por el usuario.

API

  • Set-UDLocalStorage

  • Get-UDLocalStorage

Controladores de eventos

Muchos componentes admiten controladores de eventos en forma de bloques de script. También puede verlos denominados endpoints, ya que así se llamaban en Universal Dashboard v2. Estos controladores de eventos le permiten invocar scripts de PowerShell cuando se producen determinadas acciones en la página.

Por ejemplo, puede tener un clic de botón que llame a un controlador de eventos. Este botón muestra un toast al hacer clic. Puede incluir cualquier cmdlet de PowerShell válido dentro del código del controlador de eventos.

Ámbito de las variables

Las variables se incluyen automáticamente en el ámbito de los controladores de eventos. Puede acceder a las variables que defina fuera del controlador de eventos.

Datos del evento

Algunos controladores de eventos proporcionan datos como cadena o como tabla hash. Esto depende del controlador de eventos que utilice. Por ejemplo, el controlador de eventos -OnClick de New-UDButton no proporciona datos. Por otro lado, -OnChange de New-UDSelect sí proporciona datos de evento.

Puede acceder a los datos del evento utilizando la variable $Body como cadena, a veces con formato JSON, o utilizando la variable $EventData como tabla hash.

Formularios

Enviar un formulario

Puede forzar el envío de un formulario utilizando el cmdlet Invoke-UDForm. De forma opcional, puede aplicar la validación incluyendo el parámetro -Validate.

Validar un formulario

Puede forzar la validación de un formulario utilizando Test-UDForm.

JavaScript

Puede invocar JavaScript desde PowerShell utilizando el cmdlet Invoke-UDJavaScript.

API

  • Invoke-UDJavaScript

Toast

Mostrar un toast

Puede utilizar el cmdlet Show-UDToast para crear un mensaje toast que aparece en la página web del usuario final. Se produce a través de un WebSocket y muestra el toast inmediatamente.

Mostrar un toast con un icono

Los toasts admiten iconos como cadenas. Puede utilizar todos los iconos de FontAwesome v5.

Ocultar un toast

Oculte un toast según el ID especificado.

API

  • Show-UDToast

  • Hide-UDToast

Redirección

Puede redirigir a los usuarios a diferentes páginas utilizando el cmdlet Invoke-UDRedirect. Se produce a través de un WebSocket y redirige en cuanto se llama al cmdlet.

Invoke-UDRedirect redirige automáticamente a las páginas del dashboard cuando se utiliza una ruta relativa.

Si desea redirigir a una ruta local fuera del dashboard, utilice el parámetro -Native.

API

  • Invoke-UDRedirect

Puede abrir un modal utilizando el cmdlet Show-UDModal. Se abre en cuanto lo llama. Puede incluir los componentes que desee dentro del modal.

Lea más sobre los modales aquí.

Gestión del estado de los componentes

Puede gestionar el estado de los componentes de forma dinámica utilizando los comandos UDElement.

Obtener el estado de un componente

Puede recibir el estado de un elemento utilizando Get-UDElement. El estado se devuelve como una tabla hash. Esto resulta útil principalmente para los componentes de entrada.

Establecer el estado de un componente

Como alternativa, puede establecer el estado de un componente utilizando Set-UDElement. Debe especificar un ID y una tabla hash de propiedades que establecer en el componente. Todos los componentes integrados admiten Set-UDElement.

Eliminar un componente

Puede eliminar componentes de la página utilizando Remove-UDElement. El componente ya no aparece en la página.

Añadir un componente

Añada un componente secundario a un componente principal existente.

Borrar un componente

Puede eliminar todos los componentes secundarios de un componente existente utilizando Clear-UDElement.

Recargar un componente

Algunos componentes admiten la recarga. Puede activar la recarga de un componente utilizando Sync-UDElement.

Seleccionar un componente

Puede seleccionar un componente con Select-UDElement.

Integración con el host de PowerShell

Los dashboards se integran directamente con el host de PowerShell para proporcionar funciones basadas en cmdlets estándar.

Read-Host

Al utilizar el cmdlet Read-Host se muestra un diálogo en el dashboard del usuario. El texto introducido es devuelto por el cmdlet.

Get-Credential

Al utilizar Get-Credential se muestra un diálogo que acepta un nombre de usuario y una contraseña. El cmdlet devuelve un objeto PSCredential.

Write-Progress

Los cmdlets que utilizan el flujo de progreso o Write-Progress dan como resultado un diálogo de progreso. La ventana emergente muestra la actividad, el porcentaje completado y la operación actual.

Puede desactivar la integración de Write-Progress estableciendo $ProgressPreference en SilentlyContinue.

Solicitar una elección

Puede utilizar la función $Host.UI.PromptForChoice para mostrar un diálogo de selección múltiple.

Write-Host

Write-Host dentro de las aplicaciones escribe en la pestaña Log de la Admin Console de la aplicación. Para recibir estos mensajes de registro en la consola de herramientas de desarrollo de su navegador, active el registro en consola en appsettings.json.

API

  • Get-UDElement

  • Set-UDElement

  • Clear-UDElement

  • Remove-UDElement

  • Sync-UDElement

  • Select-UDElement

Véase también

Última actualización

¿Te fue útil?