---
title: Etapas de usuario
slug: neurons/help/es_es/etapas-de-usuario
createdAt: 2026-09-08T03:26:03.091Z
---

Cree etapas de usuario para personalizar y guardar etapas para usarlas en la creación de bots. Una vez creadas, las etapas podrán reutilizarse desde el [Editor de bots](https://docs.ivanti.com/neurons/help/es_es/editor-de-bots), en **Etapas** > **Usuario**.

## Para crear una etapa de usuario

1. Vaya al **Menú principal&#x20;**>; **Bots**.
   Se mostrará la página de inicio de **Bots**.
2. Seleccione la pestaña **Bots generales** o **Bots de encuesta**.
3. Seleccione **Crear bot** o **Crear encuesta**.
   Aparece la págin&#x61;**&#x20;Crear bot&#x20;**&#x6F;**&#x20;Crear encuesta**.
4. Seleccione el activador del bot: **Programar** o **Acción personalizada**.
5. Seleccione el tipo de destino: **Dispositivos** o **Personas**.
6. Introduzca un **Nombre&#x20;**&#x70;ara el bot. También puede introducir una descripción.
7. Haga clic en **Crear**.
   Aparece la página del editor de Bots.
   El nuevo bot se guarda como una versión borrador inactiva.
8. En la página **Nuevo editor de bots**, seleccione **Gestionar etapas de usuario** para mostrar la página **Gestor de etapas de usuario**.
9. En la página **User Stage Manager**, haga clic en el menú desplegable **Crear&#x20;**&#x79; seleccione la etapa deseada entre las siguientes:
   - Consulta de PowerShell
   - Acción de Powershell
   - Acción de Bash
   - Acción de comando
   - OSQuery
10. En la página **Editor de la etapa del usuario**, introduzca el **nombre etapa**. Por ejemplo, Comprimir archivo/carpeta.
11. Alternativamente, introduzca una descripción. El texto descriptivo se muestra cuando en el editor de bots se selecciona Información de etapa en el panel **Ajustes de etapa** . Por ejemplo, eEsta etapa comprime archivos de origen desde una ruta específica a una ruta de destino al nivel de compresión especificado.
12. Introduzca el código de la secuencia de comandos.
    **Ejemplo**:
    `Compress-Archive -ruta C:\logs\file.txt `
    `-destinationpath C:\\logs\\file.zip `
    `-nivel de compresión Bueno`

:::Paragraph{indent="1"}
Puede hacer que este script sea más flexible reemplazando parte del código duro con variables. Esto permitiría personalizar los elementos al usar la fase.
**Ejemplo**:
`Compress-Archive -path __Ruta al archivo o carpeta de origen__`
`-destinationpath__ Ruta de destino__`
`-nieldecompresión __Opcionesdelnivelde|compresión:Más rápido,Bueno,No ``Compresión__`
:::

:::Paragraph{indent="1"}
Seleccione Ctrl + Espacio para introducir una **Variable de opciones** o una **Variable de valor**:
:::

- Se muestra una **Variable de opciones** en la configuración como un menú desplegable de selección, las opciones disponibles serán las que introduzca en el script. En este ejemplo: Opciones de nivel de compresión Más rápido, Bueno, Sin compresión.
- Una **variable de valor&#x20;**&#x73;e muestra en la configuración como un cuadro de texto, con la etiqueta que introduzca en el script. En este ejemplo: Parche al archivo o carpeta de origen, Ruta de destinoy Nivel de compresión.

:::Paragraph{indent="1"}
Para este ejemplo, el sitio **Ajustes de la etapa&#x20;**&#x74;endría el aspecto siguiente:
:::

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/7Nw7ZQX9sXlcIWVcRFcqx_bots-custom-stage.png" alt="configuraciones de etapa personalizadas " position="flex-start" size="35" width="346" height="602" initialPath="Images/bots-custom-stage.png" githubPath="ESP/Images/bots-custom-stage.png" showCaption="false" indent="1"}

13. Rellene el formulario **Ajustes de etapa**, los ajustes disponibles dependen del tipo de etapa de usuario que esté creando:

::::ExpandableHeading
## Consulta de Powershell

**Ejecutar como**:

- Sistema
- Usuario registrado
- Credenciales

**Tipo**:

- PowerShell
- Núcleo
- Auto

**Salida**: agregue una salida para cada nombre de columna devuelto por la consulta de PowerShell que desee usar en una fase de resultados de filtro descendente o como una variable en otra fase.

**Resultado singular**: activar/desactivar. Utilice resultados únicos/múltiples para definir si la consulta devolverá resultados únicos o múltiples por dispositivo. Esto determina si las variables están disponibles como entradas de token en las fases posteriores directamente (simple) o si solo están disponibles para las fases en un bloque de resultados para cada (múltiple) para recorrer esas fases [para cada](https://docs.ivanti.com/neurons/help/es_es/etapas-de-bots#for-each) resultado.

**Ejemplo de consulta de PowerShell:**

Utilice PowerShell para consultar su entorno cuando los comportamientos personalizados deseados no puedan conseguirse mediante las etapas estándar de los bots.

Para ejecutar la consulta correctamente, asegúrese de que:

- La salida del script es JSON (puede utilizar el commandlet ConvertTo-JSON).
- Puede nombrar cada campo de datos como una entrada de salida en la **configuración de la etapa**.

:::hint{type="info"}
Por defecto, el tiempo de espera del script es de 25 minutos.
:::

**Tipos de PowerShell:**

- Si selecciona tipo **PowerShell** como **Core**, el script de PowerShell se ejecuta en el PowerShell Core .Net Core 3.1 Desktop Runtime, versión 24.64.28315 o superior debe estar instalado en el equipo en la que se está ejecutando.
- Si selecciona **PowerShell** tipo como **Auto**, la consulta busca Net Core 3.1 Desktop Runtime, versión 24.64.28315 o superior. Los resultados son los siguientes:
  - Una vez instalado el tiempo de ejecución, el script se ejecutará en **PowerShell Core**.
  - Cuando el tiempo de ejecución no esté instalado, el script se ejecutará e&#x6E;**&#x20;PowerShell**.

**Tipos de salida:**

Active esta opción si desea que los resultados aparezcan en múltiplos y desactívela si desea que aparezcan en unidades.

- Single: si el tipo de salida se especifica como single, se puede devolver un objeto en formato JSON.

```bash
$name = [System.Net.Dns]::GetHostName()
```

```bash
ConvertTo-Json @([customobject]@{Nombre = $nombre;})
```

- Múltiple: si el tipo de salida se especifica como múltiple, debe devolver los datos como una matriz de objetos en formato JSON.
  Los objetos dentro de la matriz contienen los tipos primitivos. En el campo **Salida** del **inspector de etapas**, debe enlazar el campo **Ejemplo** e introducir **Nombre**.

  ```bash
  [{“Example Field”: “A”}, {“Example Field”: “B”}]
  ```

  ```bash
  $processes = Get-Process | Select-Object Name
  ConvertTo-Json $procesos
  ```
::::

:::ExpandableHeading
## Acción de Powershell

**Ejecutar como**:

- Sistema
- Usuario registrado
- Credenciales

**Tipo**:

- PowerShell
- Núcleo
- Auto

Ejemplo de acción de PowerShell:

**PowerShell Action** es similar a **PowerShell Query**, excepto que no hay salidas en **PowerShell Action**. Para obtener más información, consulte [Ejemplo de consulta PowerShell](https://docs.ivanti.com/neurons/help/es_es/etapas-de-usuario#PowerShell-query).
:::

:::ExpandableHeading
## Acción de Bash

**Ejecutar como**:

- Sistema
- Usuario registrado

Ejemplo de acción de Bash:

Para reducir el tamaño eliminando las 100 primeras entradas, utilice el siguiente comando:

```bash
sed 1,100d your-filename
```
:::

:::ExpandableHeading
## Acción de comando

**Ejecutar como**:

- Sistema
- Usuario registrado

Ejemplo de acción de comando:

- Para analizar y reparar archivos dañados:

```bash
sfc /scannow
```

- Para comprobar y arreglar el estado del disco físico:

```bash
chkdsk /offlinescanandfix
```
:::

:::ExpandableHeading
## OSQuery

**Resultado singular**: activar/desactivar. Utilice resultados únicos/múltiples para definir si la consulta devolverá resultados únicos o múltiples por dispositivo. Esto determina si las variables están disponibles como entradas de token en las fases posteriores directamente (simple) o si solo están disponibles para las fases en un bloque de resultados para cada (múltiple) para recorrer esas fases para cada resultado.

**Agregar asignación de columnas**: agregue una asignación de columnas para cada nombre de columna devuelto por el osquery que desea usar en una etapa de resultados de filtro descendente o como una variable en otra etapa.

Ejemplo de OSQuery:

Para detectar las aplicaciones iniciadas con más frecuencia por dispositivo, ejecute el script.

```bash
seleccione ruta,hora_última_ejecución,número,
orden de sid de userassist descendente
limit __Número de aplicaciones a devolver|opciones:1,5,10__
```
:::

14. Seleccione **Aplicar y Cerrar** para guardar la fase de usuario.
    Si ha realizado ediciones en una fase de usuario existente, se crea una nueva versión. Al guardar, aparece un cuadro de diálogo para advertir que cualquier bot que use la fase de usuario deberá actualizarse para usar la última versión.

## Acciones

Puede realizar las siguientes acciones en cualquiera de las fases del usuario:

- **Clonar**: seleccione una etapa de usuario, seleccione **Acciones&#x20;**> **Clonar**. Aparece el cuadro de diálogo **Clonar etapa**. Introduzcaun nombre único y seleccione **Clonar**. Aparece un mensaje emergente para informarle que la creación de la etapa se completó correctamente. La fase clonada aparece en la lista para que la seleccione y la edite.
- **Borrar**: seleccione una o más etapas de usuario, seleccione **Acciones&#x20;**> **Borrar**. Aparece el cuadro de diálogo **Borrar etapas**. Seleccione **Eliminar&#x20;**&#x70;ara confirmar la eliminación de la fase. Esta acción no se puede deshacer y dejará obsoleta la etapa de cualquier bot que la use.**&#x20;Las etapas obsoletas** se indican con un borde rojo.

### Temas relacionados

[Etapas de bots](https://docs.ivanti.com/neurons/help/es_es/etapas-de-bots)
