---
title: Fasi utente
slug: help/neurons/it_it/fasi-utente
createdAt: 2026-09-08T06:59:23.946Z
---

Creare fasi utente per personalizzare e salvare fasi da utilizzare nella creazione di bot. Una volta create, le fasi sono disponibili per il riutilizzo nell'[Editor Bots](docId\:bCoExNk8SjX2W1kVfcfGP), sotto **Fasi** > **Utente**.

## Per creare una fase utente

1. Andare al **Menu principale** > **Bot**.
   Viene visualizzata la pagina home **Bot**.
2. Selezionare la scheda **Bot generali** o **Bot sondaggio**.
3. Selezionare **Crea bot** o **Crea sondaggio**.
   Viene visualizzata la pagina **Crea bot** o **Crea sondaggio**.
4. Selezionare l'attivazione del bot: Azione **Pianifica** o **Personalizza**.
5. Selezionare il tipo di destinazione: **Dispositivi** o **Persone**.
6. Inserire un **Nome** per il bot. Facoltativamente, inserire una breve descrizione.
7. Fare clic su **Crea**.
   Viene visualizzata la pagina Editor Bot.
   Il nuovo bot viene salvato come versione di bozza inattiva.
8. Nella pagina **Editor nuovi bot**, selezionare **Gestisci fasi utente** per visualizzare la pagina **Gestione fasi utente**.
9. Nella pagina **Gestione fasi utente**, fare clic sul menu a discesa **Crea&#x20;**&#x65; selezionare la fase desiderata tra le seguenti:
   - Query PowerShell
   - Azione PowerShell
   - Azione bash
   - Azione di comando
   - OSQuery
10. Nella pagina **Editor fase utente**, inserire **Nome fase**. Ad esempio, Comprimi file/cartella.
11. Facoltativamente, inserire una descrizione. Il testo descrittivo viene visualizzato quando nell'editor del bot le informazioni sulla fase sono selezionate dal pannello **Impostazioni fase**. Ad esempio, Questa fase comprime i file di origine da un percorso specificato a un percorso di destinazione al livello di compressione specificato.
12. Inserire il codice dello script.
    **Esempio**:
    `Compress-Archive -path C:\logs\file.txt`
    `-destinationpath C:\logs\file.zip`
    `-compressionlevel Optimal`

:::Paragraph{indent="1"}
È possibile rendere questo script più flessibile sostituendo parte del codice rigido con variabili. Ciò consentirebbe di personalizzare gli elementi durante l'utilizzo della fase.
**Esempio**:
`Compress-Archive -path __Percorso del file o della cartella di origine__`
`-destinationpath __Percorso di destinazione__`
`-compressionlevel __Compression level|options:Fastest,Optimal,No ``Compression__`
:::

:::Paragraph{indent="1"}
Selezionare Ctrl + Spazio per inserire una **Variabile Opzioni** o una **Variabile Valore**:
:::

- Una **Variabile opzioni** viene visualizzata nelle impostazioni come un menu a discesa di selezione, le opzioni disponibili saranno quelle inserite nello script. In questo esempio: Opzioni del livello di compressione Più veloce, Ottimale, Nessuna compressione.
- Una **Variabile valore** viene visualizzata nelle impostazioni come casella di testo, con l'etichetta inserita nello script. In questo esempio: Patch al file o alla cartella di origine, Percorso di destinazione e Livello di compressione.

:::Paragraph{indent="1"}
Per questo esempio, le **Impostazioni fase** sarebbero simili a queste:
:::

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/YLcokc-oz-CTdpXeC2FnO_bots-custom-stage.png" alt="impostazioni fase personalizzate " position="flex-start" size="35" width="346" height="602" initialPath="Images/bots-custom-stage.png" githubPath="ITA/Images/bots-custom-stage.png" showCaption="false" indent="1"}

13. Completare le **Impostazioni fase**, le impostazioni disponibili dipendono dal tipo di fase utente che si sta creando:

::::ExpandableHeading
## Query PowerShell

**Esegui come**:

- Sistema
- Utente registrato
- Credenziali

**Tipo**:

- PowerShell
- Core
- Auto

**Output**: aggiungere un output per ogni nome di colonna restituito dalla query di PowerShell che si desidera usare in una fase Filtra risultati a valle o come variabile in un'altra fase.

**Risultato singolare**: Attiva/disattiva. Utilizzare risultati singoli/multipli per definire se la query restituirà risultati singoli o multipli per dispositivo. Questo determina se le variabili sono disponibili come input di token direttamente nelle fasi a valle (singole) o se sono disponibili solo per le fasi in un blocco di risultati [for-each](docId:2QZccxv00HBNF19ec6K1P) (multiplo) per eseguire il ciclo di tali fasi per ciascun risultato.

**Esempio di query PowerShell:**

Usa PowerShell per interrogare l'ambiente quando i comportamenti personalizzati desiderati non sono ottenibili con le fasi standard del bot.

Per eseguire la query con successo, assicurarsi che:

- L'output dello script sia JSON (è possibile usare il commandlet ConvertTo-JSON).
- È possibile nominare ogni campo dati come voce di output nelle **Impostazioni fase**.

:::hint{type="info"}
Per impostazione predefinita, il timeout dello script è di 25 minuti.
:::

**Tipi PowerShell:**

- Se si seleziona il tipo **PowerShell** come **Core**, lo script PowerShell viene eseguito su PowerShell Core .Net Core 3.1 Desktop Runtime, versione 24.64.28315 o superiore e deve essere installato sul computer su cui si sta eseguendo.
- Se si seleziona il tipo **PowerShell** come **Auto**, la query cerca Net Core 3.1 Desktop Runtime, versione 24.64.28315 o superiore. Gli esiti sono i seguenti:
  - Quando il runtime è installato, lo script viene eseguito su **PowerShell Core**.
  - Quando il runtime non è installato, lo script viene eseguito su **PowerShell**.

**Tipi di output:**

Attivare se si desidera che i risultati vengano visualizzati in singoli e disattivare se si desidera che i risultati vengano visualizzati in multipli.

- Singolo - Se il tipo di output è specificato come singolo, può essere restituito un oggetto in formato JSON.

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

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

- Multiplo - Se il tipo di output è specificato come multiplo, è necessario restituire i dati come array di oggetti in formato JSON.
  Gli oggetti all'interno dell'array contengono i tipi primitivi. Nel campo **Output** dello **Stage inspector**, è necessario vincolare il campo **Esempio** e inserire **Nome**.

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

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

:::ExpandableHeading
## Azione Powershell

**Esegui come**:

- Sistema
- Utente registrato
- Credenziali

**Tipo**:

- PowerShell
- Core
- Auto

Esempio di azione PowerShell:

L'**Azione PowerShell** è simile alla query PowerShell , tranne per il fatto che non ci sono output nell'azione **PowerShell**. Per saperne di più vedere [Esempio di query PowerShell](docId\:Q7hD1tAWxV_rd6yukwo2z).
:::

:::ExpandableHeading
## Azione bash

**Esegui come**:

- Sistema
- Utente registrato

Esempio di azione bash:

Per ridurre le dimensioni eliminando le prime 100 voci, utilizzare il seguente comando:

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

:::ExpandableHeading
## Azione di comando

**Esegui come**:

- Sistema
- Utente registrato

Esempio di azione di comando:

- Per scansionare e riparare i file danneggiati:

```bash
sfc /scannow
```

- Per controllare e correggere lo stato del disco fisico:

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

:::ExpandableHeading
## OSQuery

**Risultato singolare**: Attiva/disattiva. Utilizzare risultati singoli/multipli per definire se la query restituirà risultati singoli o multipli per dispositivo. Questo determina se le variabili sono disponibili come input di token direttamente nelle fasi a valle (singole) o se sono disponibili solo per le fasi in un blocco di risultati for-each (multiplo) per eseguire il ciclo di tali fasi per ciascun risultato.

**Aggiungi mapping colonne**: aggiunge un mapping colonne per ogni nome di colonna restituito dall'osquery che si desidera utilizzare in una fase Filtra risultati a valle o come variabile in un'altra fase.

Esempio OSQuery:

Per individuare le applicazioni lanciate più di frequente per dispositivo eseguire lo script:

```bash
select path,last_execution_time,count,
sid da ordine userassist per conteggio desc
limit __Number of Apps to return|options:1,5,10__
```
:::

14. Selezionare **Applica e chiudi** per salvare la fase utente.
    Se si sono apportate modifiche a una fase utente esistente, viene creata una nuova versione. Al momento del salvataggio, viene visualizzata una finestra di dialogo per avvisare che tutti i bot che utilizzano la fase utente dovranno essere aggiornati per utilizzare la versione più recente.

## Azioni

È possibile eseguire le seguenti azioni in qualsiasi fase utente:

- **Clona**: selezionare una fase utente, selezionare **Azioni&#x20;**> **Clona**. Viene visualizzata la finestra di dialogo **Clona fase**. Immettere un nome univoco e selezionare **Clona**. Viene visualizzato un messaggio pop-up per informare che la creazione della fase è andata a buon fine. La fase clonata viene visualizzata nell'elenco per essere selezionata e modificata.
- **Elimina**: selezionare una o più fasi utente, selezionare **Azioni&#x20;**> **Elimina**. Viene visualizzata la finestra di dialogo **Elimina fasi**. Selezionare **Elimina&#x20;**&#x70;er confermare l'eliminazione della fase. Questa azione non può essere annullata e deprecherà la fase da qualsiasi bot che la utilizza.**&#x20;Le fasi deprecate** sono indicate da un bordo rosso.

### Argomenti correlati

[Fasi bot](docId:2QZccxv00HBNF19ec6K1P)
