---
schema_version: "1"
id: 0680e550fbf875f2dafdc1fa9d1071c99c28c5e80627f68b6f55d1c5f6271b8f
title: Comandi tabcmd
collection: tableau
version: current
locale: it-it
portal_url: https://docs.salesforce.com/tableau/current/it-it/online/tabcmd_cmd.md
canonical_url: https://help.tableau.com/current/online/it-it/tabcmd_cmd.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 0068dc112a6c70a88781fa50960ba3b308cbfae313a2506a74b7cda56bba86ac
description: Reference for tabcmd commands and their options.
---
[Passa al contenuto principale](#main-content)

# Comandi tabcmd

**Importante:** tra agosto 2024 e marzo 2025, i siti Tableau Cloud sono stati sottoposti a migrazione a Salesforce [Hyperforce](https://help.salesforce.com/s/articleView?id=000388902&type=1). In seguito alla migrazione, tabcmd 1.0 non è più supportato. Pianifica la migrazione a tabcmd 2.0 il prima possibile per evitare eventuali problemi. Questo ritiro non ha alcun impatto su Tableau Server.

**Nota:** nella maggior parte dei casi, è necessario utilizzare l’utilità della riga di comando tabcmd 2.0 (tabcmd 2.0) con Tableau Cloud. Tabcmd 2.0 è disponibile in [Tableau tabcmd](https://tableau.github.io/tabcmd). Con questa nuova versione puoi eseguire comandi tabcmd in MacOS e Linux, autenticarti utilizzando token di accesso personali (PAT) e assicurare la conformità all’autenticazione a più fattori (MFA). La versione 2.0 sfrutta endpoint pubblici disponibili in Tableau Server Client (TSC) basato su Python.

Puoi utilizzare i comandi seguenti con lo strumento da riga di comando tabcmd in Tableau Cloud:

[login](#id5fba51c9-5608-4520-8ceb-2caf4846a2be)

[logout](#id8f512aec-57a4-4ed4-94c4-86e91ea9cc9c)

[get _url_](#id7e0a0627-ad89-4135-a1c2-85b1d8472568)

[addusers](#id1999d76f-638e-47d4-86ac-fe8e206ed364) (al gruppo)

[creategroup](#idbfa546df-2be7-444f-8bb8-07978b127783)

[deletegroup](#id0d009916-bee3-4ef0-a6ac-22188c0e7f30)

[export](#id7cb8d032-a4ff-43da-9990-15bdfe64bcd0)

[createproject](#id5a3316ed-45bb-4da4-b557-58492b2d4ac8)

[deleteproject](#idfdf59712-84ed-4590-9471-541d316917a6)

[publish](#iddf805b62-18ff-4497-9245-adc6905b2084)

[createextracts](#id5a3316ed-45bb-4da4-b557-1111112d4ac8)

[refreshextracts](#id4cdb3410-1c41-4dad-b1d2-306542ac9b32)

[deleteextracts](#id5a3316ed-45bb-4da4-b557-2222222d4ac8)

[delete _workbook-name_ o _datasource-name_](#idfdf59712-84ed-4590-9471-541d316917a6)

[createsiteusers](#idd1b7729f-dd20-475a-96f6-17fcd2577894)

[deletesiteusers](#deletesiteusers)

[removeusers](#id5cc30cba-44b8-48b0-93d6-5707938d157a)

[version](#id825f5d18-529c-408a-b876-57693195bbdd)

## addusers _group-name_

Aggiunge utenti al gruppo specificato.

**Esempio**

`tabcmd addusers "Development" --users "users.csv"`

### Opzioni

`--users`

Aggiungi gli utenti nel file `.csv` specificato al gruppo specificato. Il file dovrebbe contenere un semplice elenco con un nome utente per riga. I nomi utente non sono sensibili alle maiuscole e minuscole. Gli utenti devono essere già stati creati in Tableau Cloud.

Per maggiori informazioni, consulta le [Linee guida per l’importazione di file CSV](https://help.tableau.com/current/online/it-it/csvguidelines.htm).

`--[no-]complete`

Quando impostata su `complete`, questa opzione richiede che tutte le righe siano valide per applicare le modifiche. Se non specificato diversamente, l’opzione `--complete` viene utilizzata.

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createextracts

Crea le estrazioni per una cartella di lavoro o un’origine dati pubblicata.

### Opzioni

`-d`, `--datasource`

Nome dell’origine dati di destinazione per la creazione dell’estrazione.

`--embedded-datasources`

Un elenco separato da spazi di nomi di origini dati incorporate all’interno della cartella di lavoro di destinazione. Racchiudi i nomi delle origini dati tra virgolette doppie se contengono spazi. Disponibile solo per la creazione di estrazioni per una cartella di lavoro.

`--encrypt`

Crea un’estrazione crittografata.

`--include-all`

Includi tutte le origini dati incorporate nella cartella di lavoro di destinazione. Disponibile solo per la creazione di estrazioni per una cartella di lavoro.

`--parent-project-path`

Percorso del progetto padre del progetto che contiene la risorsa di destinazione. Devi specificare il nome del progetto con --project.

`--project`

Nome del progetto che contiene la risorsa di destinazione. Necessario solo se è specificato --workbook o --datasource. Se non specificato, viene utilizzato il progetto "Predefinito".

`-u`, `-url`

Nome canonico della risorsa visualizzato nell’URL.

`-w`, `-workbook`

Nome della cartella di lavoro di destinazione per la creazione dell’estrazione.

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## creategroup _group-name_

Crea un gruppo. Usa `addusers` per aggiungere gli utenti dopo la creazione del gruppo.

**Esempio**

`tabcmd creategroup "Development"`

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createproject _project-name_

Crea un progetto.

**Esempio**

`tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing quarterly sales reports."`

### Opzioni

`-n`, `--name`

Specifica il nome del progetto che desideri creare.

`--parent-project-path`

Specifica il nome del progetto padre per il progetto nidificato come specificato con l’opzione `-n`. Ad esempio, per specificare un progetto chiamato "Nested" che esiste in un progetto "Main", usa la sintassi seguente: `--parent-project-path "Main" -n "Nested"`.

`-d`, `--description`

Specifica una descrizione per il progetto.

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createsiteusers _filename.csv_

Aggiunge gli utenti a un sito, in base alle informazioni fornite in un file CSV (Comma-Separated Value). Se l’utente non è già stato creato nel server, il comando crea l’utente prima di aggiungerlo al sito.

Il file CSV deve contenere uno o più nomi utente e può anche includere (per ogni utente) password, nome completo, tipo di licenza, livello di amministratore, publisher (sì/no) e indirizzo e-mail. Per informazioni sul formato del file CSV, consulta le [Linee guida per l’importazione di file CSV](https://help.tableau.com/current/online/it-it/csvguidelines.htm).

In alternativa all’inclusione nel file CSV delle autorizzazioni a livello amministratore e del publisher, passa informazioni a livello di accesso includendo l’opzione `--role` e specificando il ruolo del sito che desideri assegnare agli utenti elencati nel file CSV.

Per impostazione predefinita, gli utenti vengono aggiunti al sito a cui sei connesso. Per aggiungere utenti a un altro sito, includi l’opzione globale `--site` e specifica il sito (devi disporre delle autorizzazioni per creare gli utenti nel sito specificato).

**Esempio**

`tabcmd createsiteusers "users.csv" --role "Explorer"`

### Opzioni

`--admin-type`

Deprecato. Utilizza invece l’opzione `--role`.

`--auth-type`

Imposta il tipo di autenticazione (`TableauID` o `SAML`) per tutti gli utenti nel file `.csv`. Se non specificato, il valore predefinito è `TableauID`.

**Nota:** per utilizzare l’autenticazione SAML, è necessario che il sito stesso sia abilitato SAML. Per informazioni, vedi [Attivare l’autenticazione SAML su un sito o su Tableau Cloud Manager](https://help.tableau.com/current/online/it-it/saml_config_site.htm).

`--[no-]complete`

Deprecato. Comportamento di errore predefinito: se sono presenti più di 3 errori in un intervallo di dieci righe, il comando avrà esito negativo.

`--no-publisher`

Deprecato. Utilizza invece l’opzione `--role`.

`--nowait`

Non attende il completamento dei lavori asincroni.

`--publisher`

Deprecato. Utilizza invece l’opzione `--role`.

`--role`

Specifica un ruolo del sito per tutti gli utenti nel file `.csv`. Quando vuoi assegnare i ruoli del sito utilizzando l’opzione --role, crea un file CSV separato per ogni ruolo del sito.

I valori validi sono: `ServerAdministrator`, `SiteAdministratorCreator`, `SiteAdministratorExplorer`, `SiteAdministrator`, `Creator`, `ExplorerCanPublish`, `Publisher`, `Explorer`, `Interactor`, `Viewer` e `Unlicensed`.

Il valore predefinito è `Unlicensed` per i nuovi utenti e non modificato per gli utenti esistenti. Gli utenti sono aggiunti come Unlicensed se disponi di un’installazione server basata sull’utente e se il comando `createsiteusers` crea un nuovo utente quando hai già raggiunto il numero limite di licenze per i tuoi utenti.

**Nota:** su un Tableau Server multisito, se vuoi assegnare il ruolo del sito `ServerAdministrator` usando l’opzione `--role`, usa il comando [`createusers`](#createusers) invece di `createsiteusers`.

`--silent-progress`

Non visualizza i messaggi di avanzamento del comando.

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## delete _workbook-name_ o _datasource-name_

Elimina la cartella di lavoro o l’origine dati specificata dal server.

Questo comando considera il nome della cartella di lavoro o dell’origine dati come appare nel server, non il nome del file quando è stato pubblicato.

**Esempio**

`tabcmd delete "Sales_Analysis"`

### Opzioni

`-r`, `--project`

Nome del progetto contenente la cartella di lavoro o l’origine dati da eliminare. Se non specificato, si assume il progetto "Predefinito".

`--parent-project-path`

Specifica il nome del progetto padre per il progetto nidificato come specificato con l’opzione `-r`. Ad esempio, per specificare un progetto chiamato "Nested" che esiste in un progetto "Main", usa la sintassi seguente: `--parent-project-path "Main" -r "Nested"`.

`--workbook`

Nome della cartella di lavoro che desideri eliminare.

`--datasource`

Nome dell’origine dati che desideri eliminare.

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deleteextracts

Elimina le estrazioni per una cartella di lavoro o un’origine dati pubblicata.

### Opzioni

`-d`, `--datasource`

Nome dell’origine dati di destinazione per l’eliminazione dell’estrazione.

`--embedded-datasources`

Un elenco separato da spazi di nomi di origini dati incorporate all’interno della cartella di lavoro di destinazione. Racchiudi i nomi delle origini dati tra virgolette doppie se contengono spazi. Disponibile solo per l’eliminazione di estrazioni per una cartella di lavoro.

`--encrypt`

Crea un’estrazione crittografata.

`--include-all`

Includi tutte le origini dati incorporate nella cartella di lavoro di destinazione.

`--parent-project-path`

Percorso del progetto padre del progetto che contiene la risorsa di destinazione. Devi specificare il nome del progetto con --project.

`--project`

Nome del progetto che contiene la risorsa di destinazione. Necessario solo se è specificato --workbook o --datasource. Se non specificato, viene utilizzato il progetto "Predefinito".

`-u`, `-url`

Nome canonico della risorsa visualizzato nell’URL.

`-w`, `-workbook`

Nome della cartella di lavoro di destinazione l’eliminazione dell’estrazione.

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deletegroup _group-name_

Elimina il gruppo specificato dal server.

**Esempio**

`tabcmd deletegroup "Development"`

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deleteproject _project-name_

Elimina il progetto specificato dal server.

Utilizzando `tabcmd`, è possibile specificare solo un progetto di primo livello in una gerarchia di progetto. Per automatizzare le attività che desideri eseguire su un progetto all’interno di un progetto padre, utilizza la chiamata dell’[API REST](https://help.tableau.com/current/api/rest_api/en-us/help.htm#REST/rest_api_ref.htm%23API_Reference "Apre il riferimento relativo all’API REST in una nuova scheda del browser") di Tableau equivalente.

**Esempio**

`tabcmd deleteproject "Designs"`

### Opzione

`--parent-project-path`

Specifica il nome del progetto padre per il progetto annidato come specificato con il comando. Ad esempio, per specificare un progetto denominato "Design" in un progetto "Main", utilizza la sintassi seguente: `--parent-project-path "Main" "Designs"`.

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deletesiteusers _filename.csv_

Rimuove gli utenti dal sito a cui sei connesso. Gli utenti da rimuovere sono specificati in un file contenente un semplice elenco di nomi utente per riga (non sono necessarie informazioni aggiuntive oltre al nome utente).

Per impostazione predefinita, se il server dispone di un solo sito o se l’utente appartiene a un solo sito, viene rimosso anche dal server. In un’installazione Tableau Server Enterprise, se il server contiene più siti, gli utenti assegnati al ruolo del sito **Amministratore del server** vengono rimossi dal sito, ma non dal server.

Se il contenuto dell’utente è proprietario, il ruolo dell’utente viene modificato in **Privo di licenza**, ma l’utente non viene rimosso dal server o dal sito. Il contenuto è ancora di proprietà di tale utente. Per rimuovere completamente l’utente, è necessario modificare il proprietario del contenuto e quindi provare a rimuovere di nuovo l’utente.

**Esempio**

`tabcmd deletesiteusers "users.csv"`

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## export

Esporta una vista o una cartella di lavoro da Tableau Cloud e la salva in un file. Questo comando può anche esportare i dati utilizzati per una vista. I dati della vista vengono esportati a livello di riepilogo. Per esportare i dati a livello di dettagli, devi usare l’interfaccia utente di Tableau Server. Per informazioni dettagliate, consulta [Scaricare viste e cartelle di lavoro](https://help.tableau.com/current/pro/desktop/it-it/export.htm).

Quando usi questo comando, tieni presente quanto segue:

- **Autorizzazioni**: per esportare, è necessario disporre dell’autorizzazione Esporta immagine. Per impostazione predefinita, questa autorizzazione è consentita o ereditata per tutti i ruoli, sebbene le autorizzazioni possano essere impostate per cartella di lavoro o vista.
- **Esportazione dei dati**: per esportare solo i dati di una vista, utilizza l’opzione `--csv`. In questo modo i dati di riepilogo utilizzati in una vista vengono esportati in un file con estensione csv.
- **Specificare la vista, la cartella di lavoro o i dati da esportare**:
    
    - Utilizza parte dell’URL per identificare l’esportazione, in particolare la stringa `"workbook/view"` così come visualizzata nell’URL della cartella di lavoro o della vista. Non utilizzare il "nome descrittivo" ed escludi l’ID della sessione `:iid=_<n>_` alla fine dell’URL.
        
        Ad esempio, la vista di esempio di Tableau _Order Details_ nella cartella di lavoro _Superstore_ ha un URL simile a questo: `<server_name>/#/views/Superstore/OrderDetails?:iid=2`
        
        Per esportare la vista _Order Details_, utilizza la stringa `Superstore/OrderDetails`.
        
        _Non_ utilizzare `Superstore/Order Details`o `Superstore/OrderDetails?:iid=2`.
    - Se il server esegue più siti e la vista o la cartella di lavoro si trova in un sito diverso da Predefinito, utilizza `-t <site_id>`.
    - Per esportare una cartella di lavoro, ottieni la stringa dell’URL aprendo una vista nella cartella di lavoro e includila nella stringa utilizzata.
        
        Nell’esempio precedente, per esportare la cartella di lavoro _Superstore_, utilizza la stringa `Superstore/OrderDetails`.
    - Per esportare una cartella di lavoro, essa deve essere stata pubblicata con Mostra fogli come schede selezionato nella finestra di dialogo Pubblica di Tableau Desktop.
        
        **Nota:** la cartella di lavoro Tableau che contiene le [viste amministratore](https://help.tableau.com/current/online/it-it/adminview.htm) non può essere esportata.
    - Per filtrare i dati scaricati, aggiungi un filtro parametro utilizzando questo formato:
        
        ?<filter\_name>=value
        
        oppure, se devi eseguire un filtro su un parametro e tale parametro ha un nome visualizzato che corrisponde al nome di una misura o una dimensione:
        
        `?Parameters.<filter_name>=value`
- Il formato del file salvato: le opzioni di formato dipendono dall’esportazione. Una cartella di lavoro può essere esportata solo come PDF usando l’argomento `--fullpdf`. Puoi esportare una vista come PDF (`--pdf`) o PNG (`--png`).
- **Nome e percorso del file salvato** (facoltativo): se non specifichi un nome, verrà derivato dal nome della vista o della cartella di lavoro. Se non specifichi una posizione, il file verrà salvato nella directory di lavoro corrente. Altrimenti, puoi specificare un percorso completo o relativo alla tua directory di lavoro corrente.
    
    **Nota**: è necessario includere un’estensione del nome file come `.csv` o `.pdf`. Il comando non aggiunge automaticamente un’estensione al nome file specificato.
- **Oggetti della pagina Web del dashboard non inclusi in esportazioni PDF**: un dashboard può includere un oggetto pagina Web. Se esegui un’esportazione in formato PDF di un dashboard che include un oggetto di pagina web, tale oggetto non verrà incluso nel PDF.
- **Caratteri non ASCII e ASCII non standard ed esportazioni PDF**: se esporti una vista o una cartella di lavoro con un nome che include un carattere all’esterno del set di caratteri ASCII o un set di caratteri ASCII non standard devi codificare l’URL (percent-encode) del carattere.
    
    Ad esempio, se il comando include la città `Zürich`, devi codificare l’URL come `Z%C3%BCrich`:
    
    `tabcmd export "/Cities/Sheet1?locationCity=Z%C3%BCrich" -fullpdf`

**Cancellazione della cache per l’utilizzo dei dati in tempo reale**

Puoi aggiungere facoltativamente il parametro URL `?:refresh=yes` per forzare una nuova query di dati invece di estrarre i risultati dalla cache. Se utilizzi tabcmd con il tuo script e il parametro URL `refresh` è molto utilizzato, questo potrebbe avere un impatto negativo sulle prestazioni. Consigliamo di utilizzare `refresh` solo quando sono necessari dati in tempo reale, ad esempio, su una singola dashboard invece che su un’intera cartella di lavoro.

**Esempi**

_Viste_

`tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report.csv"`

`tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"`

`tabcmd export "Finance/InvestmentGrowth" --png`

`tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png`

_Cartelle di lavoro_

`tabcmd export "Q1Sales/Sales_Report" --fullpdf`

`tabcmd export "Sales/Sales_Analysis" --fullpdf --pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"`

### Opzioni

`-f`, `--filename`

Salva il file con il nome file e l’estensione specificati.

`--csv`

Solo vista. Esporta i dati della vista (dati riepilogativi) nel formato `.csv`.

`--pdf`

Solo vista. Esporta come PDF.

`--png`

Solo vista. Esporta come immagine nel formato `.png`.

`--fullpdf`

Solo cartella di lavoro. Esporta come PDF. La cartella di lavoro deve essere stata pubblicata con Mostra fogli come schede abilitato.

`--pagelayout`

Imposta l’orientamento della pagina (`landscape` o `portrait`) del PDF esportato. Se non viene specificato, verrà utilizzata l’impostazione di Tableau Desktop corrispondente.

`--pagesize`

Imposta le dimensioni della pagina del PDF esportato come una delle seguenti: `unspecified`, `letter`, `legal`, `note folio`, `tabloid`, `ledger`, `statement`, `executive`, `a3`, `a4`, `a5`, `b4`, `b5` o `quarto`. L’impostazione predefinita è `letter`.

`--width`

Imposta la larghezza in pixel. Il valore predefinito è 800 px.

`--height`

Imposta l’altezza in pixel. Il valore predefinito è 600 px.

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## get _url_

Ottiene la risorsa da Tableau Cloud rappresentata dall’URL (parziale) specificato. Il risultato viene restituito come file.

Quando usi questo comando, tieni presente quanto segue:

- **Autorizzazioni**: per ottenere un file, devi disporre dell’autorizzazione Scarica/Salva sul Web con nome. Per impostazione predefinita, questa autorizzazione è consentita o ereditata per tutti i ruoli, sebbene le autorizzazioni possano essere impostate per cartella di lavoro o vista.
- **Specificare una vista o una cartella di lavoro da ottenere**: specifica una vista da ottenere utilizzando la stringa `"/views/<workbookname>/<viewname>.<extension>"` e specifica una cartella di lavoro da ottenere utilizzando la stringa `"/workbooks/<workbookname>.<extension>"`. Sostituisci `<workbookname>` e `<viewname>` con i nomi della cartella di lavoro e della vista come vengono mostrati nell’URL quando apri la vista in un browser e sostituisci <extension> con il tipo di file che desideri salvare. Non utilizzare l’ID sessione alla fine dell’URL (`?:iid=<n>`) o il nome "descrittivo" della cartella di lavoro o della vista.
    
    Ad esempio, quando apri una vista _Totali regionali_ in una cartella di lavoro denominata _Riepilogo metriche_, l’URL sarà simile al seguente:
    
    `/views/MetricsSummary_1/RegionalTotals?:iid=1`
    
    Utilizza la stringa `/views/MetricsSummary_1/RegionalTotals.<extension>` per ottenere la vista.
    
    Utilizza la stringa `/workbooks/MetricsSummary_1.<extension>` per ottenere la cartella di lavoro.
    
    Quando si scaricano cartelle di lavoro e viste da Tableau Cloud, il contenuto dei file .twb o .twbx viene archiviato come testo normale. Tutti i dati, compresi i valori dei filtri che possono fornire indicazioni semantiche sui dati, saranno leggibili da chiunque apra il file.
- **Estensione file**: l’URL deve includere un’estensione file. L’estensione determina ciò che viene restituito. Puoi restituire una vista in formato PDF, PNG o CSV (solo dati di riepilogo). Una cartella di lavoro Tableau viene restituita come TWB se stabilisce una connessione a un’origine dati pubblicata oppure utilizza una connessione attiva, oppure come TWBX se stabilisce una connessione a un’estrazione di dati.
    
    **Nota**: se stai scaricando una vista in un file PDF o PNG e se includi un parametro `--filename` che include l’estensione .pdf o .png, non è necessario includere un’estensione .pdf o .png nell’URL.
- **Nome e posizione del file salvato** (facoltativo): il nome utilizzato per `--filename` deve includere l’estensione del file. Se non specifichi un nome e un’estensione del file, verranno derivati dalla stringa URL. Se non specifichi una posizione, il file viene salvato nella directory di lavoro corrente. Altrimenti, puoi specificare un percorso completo o relativo alla tua directory di lavoro corrente.
- **Dimensione PNG** (facoltativa): se il file salvato è PNG, puoi specificare le dimensioni in pixel nell’URL.

**Cancellazione della cache per l’utilizzo dei dati in tempo reale**

Puoi aggiungere facoltativamente il parametro URL `?:refresh=yes` per forzare una nuova query di dati invece di estrarre i risultati dalla cache. Se utilizzi tabcmd con il tuo script e il parametro `refresh` è molto utilizzato, questo potrebbe avere un impatto negativo sulle prestazioni. Consigliamo di utilizzare `refresh` solo quando sono necessari dati in tempo reale, ad esempio, su una singola dashboard invece che su un’intera cartella di lavoro.

**Esempi**

_Viste_

`tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename "Weekly-Report.png"`

`tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f "Q1Growth.pdf"`

`tabcmd get "/views/Finance/InvestmentGrowth" -f "Q1Growth.pdf"`

`tabcmd get "/views/Finance/InvestmentGrowth.csv"`

`tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f growth.png`

`tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f growth.png`

_Cartelle di lavoro_

`tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_Workbooks\Weekly-Reports.twb"`

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## login

**Importante:** tabcmd 1.0 non supporta l’autenticazione a più fattori (MFA). Per utilizzare tabcmd con Tableau Cloud, utilizza [Tableau tabcmd 2.0](https://tableau.github.io/tabcmd) (nuova finestra). Per maggiori informazioni su Tableau Cloud e MFA, consulta [Autenticazione a più fattori e Tableau Cloud](https://help.tableau.com/current/online/it-it/to_security_mfa.htm).

Effettua l’accesso di un utente Tableau Cloud.

Utilizza le opzioni globali `--server`, `--site`, `--username` e `--password` per creare una sessione.

**Nota**: quando utilizzi il comando **tabcmd login**, non puoi utilizzare l’accesso Single Sign-On (SSO) SAML, anche se il sito è configurato per usare SAML. Per effettuare l’accesso, devi passare il nome utente e la password di un utente creato nel sito. Disporrai delle autorizzazioni dell’utente Tableau Cloud con il quale hai effettuato l’accesso.

Se desideri eseguire l’accesso utilizzando le stesse informazioni già utilizzate per creare una sessione, specifica l’opzione `--password`. Verranno utilizzati il server e il nome utente archiviati nel cookie.

Se il server utilizza una porta diversa da 80 (impostazione predefinita) dovrai specificare la porta.

Devi specificare l’opzione `--site` (`-t`) solo se il server esegue più siti e se stai effettuando l’accesso a un sito diverso da quello predefinito. Se non inserisci una password, ne verrà richiesta una. Se l’opzione `--no-prompt` è specificata e non viene fornita alcuna password, il comando non riesce.

Dopo l’accesso, la sessione continuerà finché non scadrà nel server o finché il comando `logout` non verrà eseguito.

**Esempio**

Accedi al sito Tableau Cloud con l’ID del sito specificato:

`tabcmd login -s https://prod-useast-b.online.tableau.com -t siteID -u user@email.com -p password`

### Opzioni

`-s`, `--server`

Se stai eseguendo il comando da un computer Tableau Server nella tua rete, puoi usare `http://localhost`. In caso contrario, specifica l’URL del computer, ad esempio `http://bigbox.myco.com` o `http://bigbox`.

Se il server utilizza SSL, sarà necessario specificare `https://` nell’URL del computer.

Per Tableau Cloud, specifica l’URL completo, incluso il pod in cui è distribuito il sito. Ad esempio: `https://prod-useast-b.online.tableau.com`.

`-t`, `--site`

Includi questa opzione se nel server sono presenti più siti e se stai effettuando l’accesso a un sito diverso da quello predefinito.

L’ID del sito viene utilizzato nell’URL per identificare in modo univoco il sito. Ad esempio, un sito denominato West Coast Sales può avere un ID del sito di west-coast-sales.

`-u`, `--username`

Nome dell’utente che sta effettuando l’accesso. Per Tableau Cloud, il nome utente è l’indirizzo e-mail dell’utente.

`-p`, `--password`

Password per l’utente specificato per `--username`. Se non inserisci una password, ne verrà richiesta una.

`--password-file`

Consente di memorizzare la password nel file `filename.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-x`, `--proxy`

Consente di specificare il server proxy HTTP e la porta (Host:Port) per la richiesta tabcmd.

`--no-prompt`

Non richiede alcuna password. Se non viene specificata una password, il comando `login` non riesce.

`--cookie`

Salva l’ID sessione nel login. I comandi successivi non richiedono l’accesso. Questo valore è il valore predefinito per il comando.

`--no-cookie`

Non salva le informazioni sull’ID della sessione dopo un accesso riuscito. I comandi successivi richiederanno un login.

`--timeout SECONDS`

Numero di secondi di attesa prima che il server elabori il comando `login`. Il valore predefinito è 30 secondi.

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## logout

Esegue la disconnessione dal server.

**Esempio**

`tabcmd logout`

## publish _filename.twb(x)_, _filename.tds(x)_ o _filename.hyper_

Consente di pubblicare la cartella di lavoro specificata (.twb(x)) l’origine dati (.tds(x)) o l’estrazione (.hyper) su Tableau Cloud.

Se pubblichi una cartella di lavoro, per impostazione predefinita tutti i fogli della cartella di lavoro vengono pubblicati senza nomi utente o password di database.

Le autorizzazioni assegnate inizialmente alla cartella di lavoro o all’origine dati vengono copiate dal progetto in cui viene pubblicato il file. Le autorizzazioni per la risorsa pubblicata possono essere modificate dopo la pubblicazione del file. 

Se la cartella di lavoro contiene filtri utente, è necessario specificare una delle opzioni di anteprima.

**Nota:** la pubblicazione di origini dati estese o composte tramite tabcmd non è supportata in questo momento. Se pubblichi una cartella di lavoro o un file di origine dati composta con tabcmd, questa non verrà collegata correttamente ai relativi elementi padre sul server.

**Esempio**

`tabcmd publish "analysis_sfdc.hyper" -n "Sales Analysis"   --oauth-username "user-name" --save-oauth`

Se il file non è incluso nella stessa directory di tabcmd, includi il percorso completo del file.

**Esempio**

`tabcmd publish "\\computer\volume\Tableau Workbooks\analysis_sfdc.hyper" -n "Sales Analysis" --oauth-username "username" --save-oauth`

### Opzioni

`-n`, `--name`

Nome della cartella di lavoro o dell’origine dati nel server. Se omesso, la cartella di lavoro, l’origine dati o l’estrazione dati verranno assegnati dopo il nome file.

`-o`, `--overwrite`

Sovrascrive la cartella di lavoro, l’origine dati o l’estrazione dati se esiste già nel server.

`-r`, `--project`

Pubblica la cartella di lavoro, l’origine dati o l’estrazione dati nel progetto specificato. Se questa opzione non viene specificata, il progetto viene pubblicato nel progetto predefinito.

`--parent-project-path`

Specifica il nome del progetto padre per il progetto nidificato come specificato con l’opzione `-r`. Ad esempio, per specificare un progetto chiamato "Nested" che esiste in un progetto "Main", usa la sintassi seguente: `--parent-project-path "Main" -r "Nested"`.

`--db-username`

Utilizza questa opzione per pubblicare un nome utente di database con la cartella di lavoro, l’origine dati o l’estrazione dei dati.

Se ti connetti ai dati tramite una connessione OAuth e token di accesso protetti, verrà invece eseguita l’opzione `--oauth-username`.

`--db-password`

Utilizza questa opzione per pubblicare una password del database con la cartella di lavoro, l’origine dati o l’estrazione dei dati.

`--save-db-password`

Memorizza la password del database fornita nel server.

`--oauth-username`

L’indirizzo e-mail dell’account utente. Collega l’utente tramite una connessione OAuth preconfigurata, se l’utente dispone già di un token di accesso salvato per l’origine dati cloud specificata in `--name`. I token di accesso vengono gestiti nelle preferenze utente.

Per le connessioni OAuth esistenti all’origine dati, utilizza questa opzione anziché `--db-username` e `--db-password`.

`--save-oauth`

Salva le credenziali specificate da `--oauth-username` come credenziali incorporate con la cartella di lavoro o l’origine dati pubblicata.

Al contrario, quando il publisher o l’amministratore del server accede al server e modifica la connessione per la cartella di lavoro o l’origine dati, le impostazioni di connessione visualizzeranno questa credenziale OAuth come incorporata nel contenuto.

Se desideri pianificare gli aggiornamenti dell’estrazione dopo la pubblicazione, devi includere questa opzione con `--oauth-username`. Ciò è analogo all’utilizzo di `--save-db-password` con una connessione al database tradizionale.

`--thumbnail-username`

Se la cartella di lavoro contiene filtri utente, le anteprime verranno generate in base all’elemento che l’utente specificato può visualizzare. Non può essere specificata quando è impostata l’opzione `--thumbnail-group`.

`--thumbnail-group`

Se la cartella di lavoro contiene filtri utente, le anteprime verranno generate in base a ciò che il gruppo specificato può visualizzare. Non può essere specificata quando è impostata l’opzione `--thumbnail-username`.

`--tabbed`

Quando viene pubblicata una cartella di lavoro con le viste a schede, ogni foglio diventa una scheda che i visualizzatori possono utilizzare per spostarsi nella cartella di lavoro. Nota che questa impostazione sostituirà qualsiasi funzione di sicurezza a livello di foglio.

`--append`

Aggiungi il file dell’estrazione all’origine dati esistente.

`--replace`

Utilizza il file dell’estrazione per sostituire l’origine dati esistente.

`--disable-uploader`

Disattiva l’uploader del file incrementale.

`--restart`

Riavvia il caricamento del file.

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## refreshextracts _workbook-name_ o _datasource-name_

Esegue un aggiornamento completo o incrementale di estrazioni appartenenti alla cartella di lavoro o all’origine dati specificata.

Questo comando accetta il nome della cartella di lavoro o dell’origine dati come appare nel server e non il nome del file quando è stato pubblicato. Solo un amministratore o il proprietario della cartella di lavoro o dell’origine dati possono eseguire questa operazione.

**Note:** 

- Questo metodo non funzionerà e comporterà un errore se l’amministratore del server ha disabilitato l’impostazione **RunNow** per il sito. Per maggiori informazioni, consulta [Impostazioni di Tableau Server](https://help.tableau.com/current/server/it-it/maintenance_set.htm).
- Puoi utilizzare tabcmd per aggiornare le origini dati supportate ospitate nel cloud. Ad esempio SQL Server, MySQL, PostgreSQL in una piattaforma cloud; Google Analytics e così via.
- Per aggiornare i dati locali con tabcmd, l’origine dati deve essere di un tipo che può essere configurato per le [pianificazioni consigliate](https://help.tableau.com/current/online/it-it/to_sync_schedule.htm) di Tableau Bridge. Per tutte le altre origini dati che si connettono ai dati locali, puoi usare Bridge o l’utilità di estrazione dati della riga di comando. Maggiori informazioni su [Utilizzare Bridge per mantenere aggiornati i dati](https://help.tableau.com/current/online/it-it/qs_refresh_local_data.htm) e [Automatizzare le attività di aggiornamento delle estrazioni dalla riga di comando](https://help.tableau.com/current/online/it-it/to_refresh_extract_commandline.htm).

**Esempi**

tabcmd refreshextracts --datasource sales\_ds

tabcmd refreshextracts --project "Sales External" --datasource sales\_ds

tabcmd refreshextracts --project "Sales External" --parent-project-path "Main" --project "Sales External" --datasource sales\_ds

tabcmd refreshextracts --workbook "My Workbook"

tabcmd refreshextracts --url SalesAnalysis

tabcmd refreshextracts --workbook "My Workbook" --addcalculations

tabcmd refreshextracts --datasource sales\_ds --removecalculations

### Opzioni

`--incremental`

Esegue l’operazione di aggiornamento incrementale.

`--synchronous`

Aggiunge l’operazione di aggiornamento completa alla coda utilizzata dal processo di selezione background per essere eseguito non appena è disponibile un processo di selezione background. Se è disponibile un processo di selezione background, l’operazione viene eseguita immediatamente. L’operazione di aggiornamento viene visualizzata nel rapporto Attività in background.

Durante un aggiornamento sincrono, `tabcmd` mantiene una connessione attiva al server mentre l’operazione di aggiornamento è in corso, contando ogni secondo fino al termine del processo in background.

**Nota:** l’opzione `--synchronous` non è disponibile per le origini dati aggiornate con Tableau Bridge.

`--workbook`

Nome della cartella di lavoro che contiene l’estrazione da aggiornare. Se la cartella di lavoro contiene spazi nel suo nome, inseriscila tra virgolette.

`--datasource`

Nome dell’origine dati che contiene l’estrazione da aggiornare.

`--project`

Utilizza con `--workbook` o `--datasource` per identificare una cartella di lavoro o un’origine dati in un progetto diverso da _Predefinito_. Se non specificato, si assume il progetto "Predefinito".

`--parent-project-path`

Specifica il nome del progetto padre per il progetto nidificato come specificato con l’opzione `--project`.

Ad esempio:

- Per specificare un progetto denominato "Nested" in un progetto "Main", utilizza la sintassi seguente:
- \--parent-project-path "Main" --project "Nested"
- Per specificare un progetto denominato "Nested2" annidato all’interno del progetto "Nested":
- \--parent-project-path "Main/Nested" --project "Nested2"

`--url`

Nome della cartella di lavoro visualizzata nell’URL. Una cartella di lavoro pubblicata come "Analisi vendite" ha un nome dell’URL "SalesAnalysis".

`--addcalculations`

Utilizzalo con `--workbook` per materializzare i calcoli nell’estrazione incorporata della cartella di lavoro o `--datasource` per materializzare i calcoli nell’origine dati dell’estrazione. Aggiunge l’operazione alla coda utilizzata dal processo di selezione background. Se è disponibile un processo di selezione background, l’operazione viene eseguita immediatamente. Questa operazione appare nella vista amministrativa [Attività di background per le estrazioni](https://help.tableau.com/current/online/it-it/adminview_backgrnd.htm) .

`--removecalculations`

Utilizzalo con `--workbook` o `--datasource` per rimuovere i calcoli precedentemente materializzati. Aggiunge l’operazione alla coda utilizzata dal processo di selezione background. Se è disponibile un processo di selezione background, l’operazione viene eseguita immediatamente. Questa operazione appare nella vista amministrativa [Attività di background per le estrazioni](https://help.tableau.com/current/online/it-it/adminview_backgrnd.htm) .

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## removeusers _group-name_

Rimuove gli utenti dal gruppo specificato.

**Esempio**

`tabcmd removeusers "Development" --users "users.csv"`

### Opzioni

`--users`

Rimuovi gli utenti nel file `.csv` specificato dal gruppo specificato. Il file dovrebbe contenere un semplice elenco con un nome utente per riga.

`--[no-]complete`

Tutte le righe devono essere valide per poter applicare le modifiche. Se non specificata, viene utilizzata l’opzione `--complete`.

Opzioni globali

Le seguenti opzioni sono utilizzate da tutti i comandi `tabcmd`. Le opzioni `--server`, `--user` e `--password` devono essere configurate almeno una volta per iniziare una sessione. Viene memorizzato un token di autenticazione in modo che i comandi successivi possano essere eseguiti senza dover configurare nuovamente queste opzioni. Questo token rimane valido per cinque minuti dall’ultimo comando che lo ha usato.

`-h`, `--help`

Apre la guida con le informazioni sul comando.

**Nota:** alcuni comandi elencati potrebbero non essere applicabili quando si utilizza tabcmd con Tableau Cloud.

`-s`, `--server`

L’URL di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-u`, `--user`

Il nome utente di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`-p`, `--password`

La password di Tableau Cloud, che è necessario inserire almeno una volta per iniziare la sessione.

`--password-file`

Permette di memorizzare la password nel file `.txt` specificato, non nella riga di comando, per una maggiore sicurezza.

`-t`, `--site`

Indica che il comando si applica al sito specificato dall’ID del sito di Tableau Cloud, racchiuso tra virgolette singole o doppie. Utilizza questa opzione se l’utente specificato è associato a più di un sito. Per l’ID del sito viene applicata la distinzione tra maiuscole e minuscole quando si utilizza un token di autenticazione memorizzato nella cache. Se le lettere maiuscole non corrispondono, potrebbe essere richiesta una password anche se il token è ancora valido.

`--no-prompt`

Quando viene specificato, il comando non richiede una password. Se non viene fornita una password valida, il comando non andrà a buon fine.

`--[no-]cookie`

Quando specificato, l’ID di sessione viene salvato al momento dell’accesso, in modo che i comandi successivi non siano necessari per l’accesso. Utilizza il prefisso `no-` per non salvare l’ID di sessione. Per impostazione predefinita, la sessione viene salvata.

`--timeout`

Attende che il server completi l’elaborazione del comando per il numero di secondi specificato. Per impostazione predefinita, il processo attenderà la risposta del server.

`--`

Specifica la fine delle opzioni sulla riga di comando. Si può usare `--` per indicare a `tabcmd` che tutto ciò che segue `--` non deve essere interpretato come un’impostazione di opzione e può invece essere interpretato come valore per il comando. Ciò è utile se devi specificare un valore con un trattino nel comando. L’esempio seguente mostra come si potrebbe usare `--` in un comando `tabcmd`, dove `-430105/Sheet1` è un valore richiesto per il comando `export`.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

**Suggerimento**: per i comandi tabcmd 1.0 disponibili per Tableau Server, consulta [Comandi tabcmd](https://help.tableau.com/current/server/it-it/tabcmd_cmd.htm).