> 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/it/automazione/jobs.md).

# Job

Tenga traccia dei job di PowerShell Universal, esamini output e stati, configuri le protezioni sull'output e la mascheratura dei dati sensibili e richiami i job da script, app e REST.

I job sono esecuzioni di script. Li visualizzi in **Run > Jobs** per esaminare stato, output dei flussi, output della pipeline, errori, richieste di feedback, versione dello script e metadati del job.

## Output

L'output dei flussi di PowerShell, inclusi i record information, host, error, warning e verbose, viene mostrato nel riquadro di output del job. Gli oggetti scritti nella pipeline vengono archiviati come CliXml e sono disponibili dalla scheda **Pipeline Output**.

Configuri **Large job output behavior** e **Maximum job output size (KB)** in **Settings gear > Automation** per proteggere l'istanza da un output eccessivo. Il valore massimo predefinito è **10.240 KB**; lo imposti su `0` per disattivare il limite.

| Comportamento | Risultato                                                                  |
| ------------- | -------------------------------------------------------------------------- |
| Warn          | Mantiene l'output e crea un avviso. Questo è il comportamento predefinito. |
| Truncate      | Archivia l'output solo fino al limite.                                     |
| Compress      | Archivia l'output in eccesso in forma compressa.                           |
| Ignore        | Non applica il limite né il comportamento di avviso.                       |

Può anche scartare l'output della pipeline per un singolo script con la relativa impostazione **Discard Pipeline**.

### Mascherare l'output sensibile dei job

Abiliti **Redact sensitive job output** in **Settings gear > Automation** per mascherare i valori nell'output del job prima che l'output venga registrato o salvato. La mascheratura è disabilitata per impostazione predefinita.

Quando è abilitata, PowerShell Universal sostituisce i valori corrispondenti con `********` per i nomi di chiave sensibili integrati, inclusi `password`, `secret`, `client_secret`, `api_key`, `access_token`, `token`, `authorization`, `credential` e `connection_string`. Riconosce i formati chiave-valore comuni come JSON, dati di form HTTP o stringhe di query e output delimitato da due punti.

```powershell
Write-Host '{"password": "MyPassword"}'
# Job output: {"password": "********"}

Write-Host 'client_secret=MyClientSecret'
# Job output: client_secret=********

Write-Host 'Authorization: [value]'
# Job output: Authorization: ********
```

Aggiunga i nomi dei campi specifici della sua organizzazione con **Additional sensitive output keys** nella stessa pagina delle impostazioni. Queste chiavi utilizzano gli stessi modelli di corrispondenza delle chiavi integrate.

La mascheratura è una rete di sicurezza best-effort per l'output, non uno scanner completo di segreti. Non maschera i valori che non vengono emessi come coppie chiave-valore riconosciute, inclusi i valori incorporati nella formattazione di oggetti personalizzati o recuperati da un provider di segreti. Non scriva segreti nell'output dei job.

## Versione dello script

Ogni job registra la versione risolta dello script che lo ha avviato. Individui il tag **Script Version** nell'intestazione del job per identificare l'origine utilizzata per quell'esecuzione.

* Gli script dei repository sincronizzati con Git registrano lo SHA del commit Git risolto.
* Gli script di comandi di modulo registrano la versione del modulo risolta.

Il valore registrato rimane associato al job dopo la modifica dello script o del modulo, fornendo una traccia di audit del momento dell'esecuzione. I job ritentati utilizzano la versione dello script attualmente risolta, se disponibile; in caso contrario, mantengono la versione originale registrata.

## Stato e feedback

I job possono essere **Queued**, **Running**, **Error**, **Warning**, **Failed** o **Waiting on Feedback**. Una chiamata `Read-Host` mette un job in stato Waiting on Feedback; risponda dalla pagina del job. Utilizzi `Read-Host -AsSecureString` per l'inserimento della password.

## Richiamare i job

Utilizzi `Invoke-PSUScript` per avviare un job e `Wait-PSUJob` per attenderlo. Dall'esterno di PowerShell Universal, utilizzi un token di app valido.

```powershell
Invoke-PSUScript -Script 'Script1.ps1' -RequiredParameter 'Hello' | Wait-PSUJob
```

Recuperi l'output della pipeline con `Get-PSUJobPipelineOutput`.

```powershell
Get-PSUJobPipelineOutput -JobId 10
```

Utilizzi `-Integrated` solo dall'interno di PowerShell Universal. Le app possono utilizzarlo con `-Wait` per inoltrare le interazioni `Write-Progress` e `Read-Host`.

```powershell
New-UDButton -Text 'Run script' -OnClick {
    Invoke-PSUScript -Name 'AppExample.ps1' -Integrated -Wait
} -ShowLoading
```

## Job Run ID

Per impostazione predefinita, i job utilizzano ID numerici incrementali. Abiliti `JobRunID` per utilizzare un `RunID` basato su GUID per le ricerche dei job.

```powershell
Set-PSUSetting -JobRunId
```

## API

* `Invoke-PSUScript`
* `Get-PSUJob`
* `Get-PSUJobOutput`
* `Get-PSUJobPipelineOutput`
* `Wait-PSUJob`


---

# 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/it/automazione/jobs.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.