> 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/portal/portal-widgets.md).

# Widgets del portal

Descubra los widgets del Portal integrados en PowerShell Universal, incluidos los formularios de script, las tablas y los gráficos, además de cómo crear widgets personalizados con PSBlazor.

Los widgets son bloques de interfaces de usuario creados con PowerShell y Blazor. Puede crear interfaces de usuario basadas en web robustas con una experiencia mínima en desarrollo web.

## Widgets integrados

PowerShell Universal ofrece widgets integrados para integrarse con otras funciones de la plataforma y mostrar elementos de la interfaz de usuario.

### Formulario de script

Proporciona un formulario para que los usuarios finales ejecuten scripts. El acceso al Portal se evalúa en tres etapas distintas:

1. **Listado del script:** el usuario debe tener un rol coincidente en **Propiedades del script > Portal** o un rol asignado a una etiqueta **Mostrar en el Portal** asociada.
2. **Apertura del formulario del script:** el usuario debe tener un rol coincidente en **Propiedades del script > Portal**. El acceso concedido únicamente mediante una etiqueta no es suficiente.
3. **Ejecución del script:** el usuario debe tener el permiso aplicable **Scripts de automatización > Ejecutar**.

**Importante:** los roles del Portal, los roles de etiqueta y los permisos de ejecución no se sustituyen entre sí. Un script puede aparecer en el listado y devolver **Unauthorized** al abrirlo, o puede abrirse pero no ejecutarse si el usuario no cumple todos los requisitos aplicables.

Las etiquetas también determinan dónde se lista un script:

| Configuración                                                                                                  | Resultado en el Portal                                                         |
| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Rol del Portal del script coincidente y sin etiquetas                                                          | Aparece en la raíz del Portal                                                  |
| Etiqueta **Mostrar en el Portal** autorizada                                                                   | Aparece bajo la etiqueta                                                       |
| Etiqueta autorizada pero sin rol del Portal del script coincidente                                             | Aparece bajo la etiqueta, pero devuelve **Unauthorized** al abrirlo            |
| Rol del Portal del script coincidente pero sin permiso de ejecución                                            | Puede aparecer en el listado y abrirse, pero no puede ejecutarse               |
| Solo etiquetas sin **Mostrar en el Portal**                                                                    | No aparece en el listado, incluso con un rol del Portal del script coincidente |
| Rol del Portal del script coincidente, permiso de ejecución y una etiqueta **Mostrar en el Portal** autorizada | Aparece bajo la etiqueta y puede abrirse y ejecutarse                          |

Una etiqueta está autorizada cuando **Mostrar en el Portal** está habilitado y la etiqueta incluye un rol asignado al usuario. Si un script tiene etiquetas, no aparece en la raíz del Portal. Se requiere al menos una etiqueta **Mostrar en el Portal** autorizada para que se pueda descubrir.

### Tabla de script

El widget de tabla de script mostrará una tabla basada en la última salida de un script. Selecciona el trabajo más reciente y genera la tabla en función de las propiedades de los objetos devueltos. Por ejemplo, pruebe a ejecutar un script que devuelva los procesos de la máquina actual.

```powershell
Get-Process | Select-Object Name, Id
```

### Gráfico circular de script

El widget de gráfico circular de script muestra un gráfico basado en los datos de la última ejecución de un script. El script debe generar los datos en un formato concreto para poder definir los sectores del gráfico. A continuación se muestra un ejemplo de cómo generar datos para un gráfico circular.

```powershell
1..5 | ForEach-Object {
    [PSCustomObject]@{ 
        type = "Category $_"
        value = Get-Random -Min 5 -Max 60
    }
}
```

En las propiedades del widget de gráfico circular, establezca la propiedad Category en `type` y la propiedad Value en `value`.

### Gráfico de líneas de script

El widget de gráfico de líneas de script muestra un gráfico basado en los datos de la última ejecución de un script. El script debe generar los datos en un formato concreto para poder definir las líneas del gráfico. A continuación se muestra un ejemplo de cómo generar datos para un gráfico de líneas.

```powershell
1..5 | ForEach-Object {
    [PSCustomObject]@{ 
        type = "Category $_"
        value = Get-Random -Min 5 -Max 60
    }
}
```

En las propiedades del widget de gráfico de líneas, establezca XProperty en `type` y YProperty en `value`.

## Widgets predefinidos

Puede encontrar widgets creados por Ironman Software y miembros de la comunidad en la[ galería de PowerShell Universal](/powershell-universal/es/plataforma/library.md).

## Widgets personalizados

Puede desarrollar sus propios widgets personalizados con PSBlazor. PSBlazor emplea una sintaxis similar a Razor combinada con PowerShell para permitir la creación de componentes totalmente interactivos y personalizables.


---

# 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/portal/portal-widgets.md?ask=<question>&goal=<endgoal>
```

`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.