---
schema_version: "1"
id: 4afe58a4c0368dc0306e25d0883ec03ddcbd40f53c8170d8b4f4bb1740a2fe0b
title: Riferimento della riga di comando di Tableau Prep
collection: tableau
version: current
locale: it-it
portal_url: https://docs.salesforce.com/tableau/current/it-it/prep/prep_command_line_reference.md
canonical_url: https://help.tableau.com/current/prep/it-it/prep_command_line_reference.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 3fbeaa2ecaa7a242ec163d0a57a3e79c445e3b6e0046aecd4d9a991139383072
description: Reference for interacting with Tableau Prep through the command line.
---
[Passa al contenuto principale](#main-content)

# Riferimento della riga di comando di Tableau Prep

Puoi interagire con Tableau Prep utilizzando la riga di comando tramite l’applicazione principale (Tableau Prep.exe) o l’interfaccia della riga di comando (tableau-prep-cli.bat).

- Tableau Prep.exe: utilizzata per configurare la modalità di inizializzazione dell’applicazione, ad esempio installazione, attivazione, concessione di licenze, impostazione delle directory dei dati utente o risoluzione dei problemi relativi alla shell Electron.
- Tableau-prep-cli.bat: utilizzata per eseguire i flussi, ad esempio passaggio di credenziali, parametri e aggiornamento dell’output di dati senza aprire l’interfaccia visiva.

Questo documento descrive tutte le opzioni della sintassi da riga di comando supportate da Tableau Prep e disponibili per i clienti, separate dall’utilità in cui sono disponibili.

Non è invece inclusa la sintassi aggiuntiva supportata della riga di comando utilizzata dagli sviluppatori e dall’assistenza Tableau.

## Applicazione Tableau Prep

Le azioni seguenti possono essere eseguite dalla riga di comando per l’applicazione Tableau Prep.exe.

### Installazione

Per installare Tableau Prep, esegui come amministratore il file .exe del programma di installazione dalla riga di comando del computer. Per maggiori informazioni, consulta [Eseguire l’installazione da riga di comando](https://help.tableau.com/current/desktopdeploy/it-it/desktop_deploy_automate.htm).

**Nota**: questa opzione è disponibile solo per Windows.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col style="width: 875px;"></colgroup><tbody><tr><th>Sintassi</th><th>Descrizione</th></tr><tr><td><code>tableau_&lt;product_installer_name&gt;.exe /option1 /option2 PROPERTY1 PROPERTY2</code></td><td><p>Esegui il comando come amministratore dalla directory in cui si trova il file .exe oppure specifica il percorso completo del file .exe nel computer. Non eseguire il programma da una directory condivisa. Per un elenco delle opzioni supportate del programma di installazione, consulta <a href="https://help.tableau.com/current/desktopdeploy/it-it/desktop_deploy_cli_ref.htm#installer-options" target="_blank">Opzioni del programma di installazione</a>. Per un elenco delle proprietà supportate del programma di installazione, consulta <a href="https://help.tableau.com/current/desktopdeploy/it-it/desktop_deploy_cli_ref.htm#installer-properties" target="_blank">Proprietà del programma di installazione</a>.</p><ul><li><p><code>tableau_&lt;product_installer_name&gt;.exe</code> è il programma di installazione di Tableau per il prodotto e la versione in corso di installazione.</p></li><li><p><code>option1, option2</code> e così via consentono di specificare il modo in cui vuoi che venga eseguito il processo di installazione.</p></li><li><p><code>PROPERTY1, PROPERTY2</code> e così via consentono di specificare le impostazioni di configurazione che il programma di installazione deve eseguire durante il processo di installazione.</p></li></ul><p>Esempio:</p><p><code>tableauPrepBuilder-64bit-2026-2-0.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"</code></p><p>Questo comando consente di installare Tableau versione 2026.2 in modalità non interattiva (non visualizza i prompt, l’interfaccia utente o la finestra di dialogo della licenza). Termina l’installazione senza riavvio, accetta il Contratto di licenza con l’utente finale (EULA) e disattiva la segnalazione di errori e i report di utilizzo.</p></td></tr></tbody></table>

### Attivazione, licenza e registrazione

Utilizza questi comandi per controllare la licenza, attivare il prodotto durante o dopo l’installazione e registrare il prodotto. Per maggiori informazioni, consulta [Attivare Tableau Desktop e Tableau Prep Builder](https://help.tableau.com/current/desktopdeploy/it-it/desktop_deploy_automate.htm#activate-tableau-desktop-and-tableau-prep-builder).

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col></colgroup><tbody><tr><th>Sintassi</th><th>Descrizione</th></tr><tr><td><code>--activate &lt;key&gt;</code></td><td><p>Attiva il prodotto utilizzando il codice prodotto fornito. Termina con il codice 0 in caso di esito positivo. In caso contrario, termina con un codice di errore. Accetta anche il trattino singolo (-activate).</p><p>Per attivare il prodotto durante l’installazione, aggiungi una singola riga di comando che includa l’opzione di installazione ACTIVATE_KEY "&lt;codice&gt;" e immetti il codice prodotto racchiuso tra virgolette.</p></td></tr><tr><td><code>--register </code></td><td><p>Registra il prodotto. Accetta anche il trattino singolo (-register). Per registrare Tableau dalla riga di comando, devi precompilare i valori di registro (Windows) o .plist (Mac) su ogni computer che eseguirà Tableau Prep Builder.</p><p>Per Windows, puoi registrare il prodotto durante l’installazione aggiungendo un’unica riga di comando che includa l’opzione REGISTER="1" del programma di installazione.</p><p>Per maggiori informazioni, consulta <a href="https://help.tableau.com/current/desktopdeploy/it-it/desktop_deploy_automate.htm#register-tableau-desktop-and-tableau-prep-builder" target="_blank">Registrare Tableau Desktop e Tableau Prep Builder</a>.</p></td></tr><tr><td><code>--check-license </code></td><td>Visualizza l’interfaccia utente di attivazione se non disponi di una licenza.</td></tr><tr><td><code>--refresh</code></td><td><p>Aggiorna le licenze con la data di scadenza del periodo di manutenzione corrente e interrompe la visualizzazione dei messaggi relativi alla scadenza. Termina con il codice 0 in caso di esito positivo. Accetta anche il trattino singolo (-refresh).</p><p><b>Windows</b>: esegui tableau.exe con l’opzione <code>--refresh</code> e un codice prodotto.</p><p><b>MacOS</b>: esegui l’opzione <code>-refresh</code> sull’oggetto Tableau nel percorso /Applications.</p></td></tr><tr><td><code>--return &lt;key&gt;</code></td><td><p>Disattiva il codice prodotto fornito in modo che possa essere riutilizzato. Accetta anche il trattino singolo (-return).</p><p><b>Windows</b>: esegui tableau.exe con l’opzione <code>-return</code> e un codice prodotto.</p><p><b>MacOS</b>: esegui l’opzione <code>-return</code> sull’oggetto Tableau nel percorso /Applications.</p></td></tr></tbody></table>

### Configurazione e archiviazione

Utilizza questi comandi per configurare le impostazioni dei file e i percorsi dei repository.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col></colgroup><tbody><tr><th>Sintassi</th><th>Descrizione</th></tr><tr><td><code>--settings-file &lt;file location&gt;</code></td><td><p>Carica le impostazioni di configurazione dell’applicazione dal file specificato. Può essere specificato più volte per supportare configurazioni a più livelli, ad esempio quando disponi di una configurazione del server proxy globale utilizzata da tutti e di una configurazione di database specifica utilizzata per un flusso.</p><p>Esempio di file .json:</p><pre xml:space="preserve">{
 "connection-sources":[
  {
	"endpoint":"prod-db-server.company.com",
	"username":"service_account_admin",
	"password":"secure_password_123"
	}
 ]
}</pre><p>Comando di esempio:</p><p><b>Windows</b>: <code>"C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --settings-file "C:\ProgramData\Tableau\global-proxy-config.json" --settings-file  "C:\Users\jsmith\AppData\Roaming\Tableau\db-config.json"</code></p><p><b>MacOS</b><code>: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --settings-file "/Library/Tableau/global-proxy-config.json" --settings-file "/Users/jsmith/Library/Application Support/Tableau/db-config.json"</code></p></td></tr><tr><td><code>--repository-location &lt;file path&gt; </code></td><td><p>Imposta la directory del repository. Per impostazione predefinita, durante l’installazione Tableau Prep crea nella cartella Documenti una cartella denominata Repository personale di Tableau Prep. Questa cartella include le cartelle per flussi, origini dati, connessioni, nonché file di log e una cache temporanea. In ambienti server o di automazione, puoi utilizzare questo comando per specificare un percorso di repository alternativo e indirizzare l’esecuzione del flusso verso di esso.</p><p>Esempio:</p><p><b>Windows</b>: "<code>C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --repository-location "D:\Tableau_Data\My_Prep_Repo"</code></p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --repository-location "/Users/jsmith/Documents/My Tableau Prep Repository"</code></p></td></tr><tr><td><code>--user-data-directory &lt;location&gt;</code></td><td><p>Directory utilizzata per l’archiviazione dei dati dell’applicazione Electron.</p><p>Mentre <code>--repository-location</code> gestisce le risorse aziendali (log e dati), <code>--user-data-directory</code> gestisce il motore interno dell’applicazione.</p><p>In qualità di amministratore, utilizza questo flag se esegui Tableau Prep Builder in un ambiente a concorrenza elevata, in cui più processi richiedono stati dell’applicazione isolati, oppure per la risoluzione dei problemi relativi a errori persistenti di blocco della sessione su un server headless.</p><p class="note"><b>Nota</b>: quando esegui il comando, viene creata automaticamente la cartella specificata in <code>--user-data-directory</code>. Tuttavia, l’account utente che esegue lo script deve disporre delle autorizzazioni di scrittura per la directory padre.</p><p>Esempio:</p><p><b>Windows</b>: <code> "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --user-data-directory "D:\Tableau_Data\Prep_AppData"</code></p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --user-data-directory "/Users/jsmith/Library/Application Support/Tableau Prep"</code></p></td></tr></tbody></table>

### Apertura dei file

Utilizza questi comandi per aprire i file di flusso .tfl e .tflx di Tableau Prep.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col></colgroup><tbody><tr><th>Sintassi</th><th>Descrizione</th></tr><tr><td><code>--tfl&lt;file&gt;</code></td><td><p>Apre il file di flusso .tfl specificato. Utilizza le virgolette doppie se il percorso del file include spazi.</p><p>Esempio:</p><p><b>Windows</b>: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" -tfl "C:\Users\jsmith\Documents\My Flows\Clean_Sales_Data.tfl"</p><p><b>MacOS</b>: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder -tfl "/Users/jsmith/Documents/My Flows/Clean_Sales_Data.tfl"</p></td></tr><tr><td><code>--tflx&lt;file&gt; </code></td><td><p>Apre il file di flusso compresso .tflx specificato.</p><p>Esempio:</p><p><b>Windows</b>:<code>"C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --tflx "C:\Users\jsmith\Desktop\Quarterly_Report.tflx"</code></p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --tflx "/Users/jsmith/Desktop/Quarterly_Report.tflx"</code></p></td></tr></tbody></table>

## Applicazione dalla riga di comando di Tableau Prep

I comandi seguenti possono essere eseguiti utilizzando l’interfaccia della riga di comando di Tableau Prep (tableau-prep-cli.bat).

### Aggiornare l’output del flusso

Utilizza queste opzioni per eseguire il flusso dalla riga di comando e aggiornare l’output del flusso. Questo metodo consente di eseguire un solo flusso alla volta. Per maggiori informazioni e per le limitazioni, consulta [Aggiornare i file di output del flusso dalla riga di comando](https://help.tableau.com/current/prep/it-it/prep_run_commandline.htm).

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col></colgroup><tbody><tr><th>Sintassi</th><th>Descrizione</th></tr><tr><td><code>-c, --connections &lt;path&gt;</code></td><td><p>Percorso del file .json contenente le credenziali per le origini dati e i server.</p><p>Tableau Prep Builder utilizza le informazioni contenute nel file di flusso e dal file .json delle credenziali per eseguire il flusso quando disponi di connessioni remote. Per maggiori informazioni, consulta <a href="https://help.tableau.com/current/prep/it-it/prep_run_commandline.htm#credentials-json-file-requirements" target="_blank">Requisiti del file .json delle credenziali</a>.</p><p>Se ti connetti a un database Snowflake, assicurati di includere eventuali parametri specifici come Role, Warehouse e, in alcuni casi, i token OAuth o l’autenticazione tramite browser esterno.</p><p>File di impostazioni .json di esempio - Snowflake:</p><pre xml:space="preserve">{
 "connection-sources":[
  {
	"endpoint":"company_account.snowflakecomputing.com",
	"username":"SVC_TABLEAU_PREP",
	"password":"EncryptedPassword123",
	"attributes":{
	 "warehouse": "DATA_LOAD_WH",
	 "role": "TRANSFORM_ROLE"
	}
  }
 ]
}						</pre><p>Esempio:</p><p><b>Windows</b>:<code> "\[Tableau Prep Builder install location]\Tableau Prep Builder &lt;version&gt;\scripts"\tableau-prep-cli.bat -c "path\to\[your credential file name].json" -t "path\to\[your flow file name].tfl"</code></p><p><b>MacOS</b>:<code> /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl</code></p></td></tr><tr><td><code>- p,  - - parameters</code></td><td><p>Percorso di un file .json che sostituisce i valori dei parametri predefiniti nel flusso. Questo è un file separato dal file credentials.json e include i nomi e i valori dei parametri.</p><p>Per maggiori informazioni, consulta “Eseguire flussi che includono valori di parametri” in <a href="https://help.tableau.com/current/prep/it-it/prep_run_commandline.htm#credentials-json-file-requirements" target="_blank">Requisiti del file .json delle credenziali</a>.</p><p>Esempio:</p><p><b>Windows</b>: <code>"\[Tableau Prep Builder install location]\Tableau Prep Builder &lt;version&gt;\scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" -p|--parameters parameters.override.json</code></p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl -p|--parameters parameters.override.json</code></p></td></tr><tr><td><code>-t,--tflFile &lt;file path&gt;</code></td><td>Percorso del file di flusso di Tableau Prep.</td></tr><tr><td><code>-inc, --incrementalRefresh </code></td><td><p>Se Tableau Prep Conductor non è abilitato nel server per la pianificazione delle esecuzioni del flusso, puoi utilizzare questo comando per eseguire il flusso utilizzando l’aggiornamento incrementale. Per maggiori informazioni, consulta Eseguire il flusso con l’aggiornamento incrementale abilitato.</p><p>Esempio:</p><p><b>Windows</b>: <code>"\[Tableau Prep Builder install location]\Tableau Prep Builder &lt;version&gt;\scripts"\tableau-prep-cli.bat --incrementalRefresh -t "path\to\[your flow file name].tfl"</code></p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --incrementalRefresh -t path/to/[your flow file name].tfl</code></p></td></tr></tbody></table>

### Comandi vari

Utilizza questi comandi per stampare la versione di Tableau Prep, attivare la modalità di debug per eseguire il debug di un processo di flusso, disabilitare la convalida SSL e altro ancora.

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 276px;"><col></colgroup><tbody><tr><th>Sintassi</th><th>Descrizione</th></tr><tr><td><code>--version</code></td><td>Restituisce la versione corrente dell’interfaccia della riga di comando di Tableau Prep Builder e termina immediatamente il processo.</td></tr><tr><td><code>-d, --debug </code></td><td><p>Abilita la modalità di debug. Genera nella cartella del repository log dettagliati utili per la risoluzione dei problemi. I file di log vengono archiviati in: My Tableau Prep Builder Repository\Command Line Repository\Logs</p><p>Esempio:</p><p><b>Windows</b>: <code>"\[Tableau Prep Builder install location]\Tableau Prep Builder &lt;version&gt;\scripts"\tableau-prep-cli.bat --debug -t "[your flow file name].tfl"</code></p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --debug -t “[your flow file name]”.tfl</code></p></td></tr><tr><td><code>-dsv, --disableSslValidation </code></td><td><p>Disabilita la convalida del certificato SSL (utile per alcuni ambienti server interni). Quando esegui questa opzione su MacOS, potrebbe essere visualizzata una finestra di dialogo che richiede utente e password del portachiavi.</p><p>A partire da Tableau Prep Builder versione 2019.3.2, puoi inserire questo parametro aggiuntivo per disabilitare la finestra di dialogo del keychain.</p><p>Esempio:</p><p><b>MacOS</b>: <code>/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -dsv -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl</code></p></td></tr><tr><td><code>-h, --help</code></td><td><p>Visualizza il menu della Guida relativo alle opzioni della riga di comando.</p></td></tr></tbody></table>