Comando Add

Consente di aggiungere nuovi file e cartelle da un file system locale a un server per Controllo della versione di Team Foundation.

Nota

   I risultati del comando non sono visibili sul server per Controllo della versione di Team Foundation finché non si esegue un'operazione di archiviazione. Per ulteriori informazioni, vedere Archiviare modifiche in sospeso.

Autorizzazioni necessarie

Per utilizzare il comando add è necessario essere proprietario dell'area di lavoro e disporre dell'autorizzazione Estrai per la cartella padre dei nuovi elementi impostata su Consenti. È necessario che l'autorizzazione Blocco sia impostata su Consenti in caso di utilizzo di /lock:checkout o /lock:checkin. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

tf add itemspec [/lock:(none|checkin|checkout)] [/type:filetype] 
[/noprompt] [/recursive] [/login:username,[password]] 

Parametri

Argomento

Oggetto di descrizione

itemspec

Identifica i file o le cartelle da aggiungere. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation sui parametri itemspec per determinare gli elementi all'interno dell'ambito, vedere Sintassi della riga di comando (controllo della versione).

NotaNota
È possibile specificare più di un argomento Itemspec.

filetype

Viene utilizzato con l'opzione /type. Per ulteriori informazioni, vedere Gestione di tipi di file.

username

Fornisce un valore all'opzione /login. È possibile specificare un valore username come Dominio\NomeUtente o NomeUtente.

Opzione

Oggetto di descrizione

/type

Esegue l'override della corrispondenza del tipo di file e aggiunge i file al server Controllo della versione di Team Foundation che utilizza il tipo specificato. Per ulteriori informazioni, vedere Gestione di tipi di file.

Il rilevamento del tipo di file si basa sul contenuto del primo kilobyte del file.

/lock

Specifica un tipo di blocco o rimuove un blocco da un elemento.

Opzioni di blocco:

  • Nessuna correzione

    Nessun blocco è collocato su un elemento. Se un blocco è già in posizione viene rimosso.

  • Checkin

    Consente di estrarre un elemento e di modificarlo in tutte le aree di lavoro, ma impedisce agli utenti di archiviare le modifiche apportate all'elemento all'esterno dell'opzione /workspace corrente fino al rilascio esplicito del blocco di archiviazione. Se l'elemento specificato è bloccato in qualsiasi altra area di lavoro, l'operazione di blocco non viene eseguita.

  • Checkout

    Impedisce agli utenti di archiviare o estrarre uno qualsiasi degli elementi specificati fino al rilascio esplicito del blocco. Se altri utenti hanno bloccato uno qualsiasi degli elementi specificati o se sono disponibili modifiche in sospeso per un qualsiasi elemento, l'operazione di blocco non viene eseguita.

/noprompt

Non vengono visualizzati prompt che richiedono l'input da parte dell'utente.

/recursive

Aggiunge tutti gli elementi inclusi nella directory specificate e nelle eventuali sottodirectory.

/login

Consente di specificare il nome utente e la password necessari per autenticare l'utente con Visual Studio Team Foundation Server.

Note

Prima di poter aggiungere un elemento al controllo della versione, è necessario impostare un'area di lavoro locale e definire i mapping delle cartelle di lavoro.

Add è un comando di tipo Modifiche in sospeso. Consente di pianificare l'aggiunta di elementi specificati al server Controllo della versione di Team Foundation nell'area di lavoro in attesa del completamento di un'operazione di archiviazione. Per eseguire un comando di tipo pending change, la directory corrente deve essere mappata a un'area di lavoro e al server Controllo della versione di Team Foundation corrispondente.

Quando si utilizza il comando Add per aggiungere un nuovo elemento al controllo della versione, l'elemento viene effettivamente aggiunto al server del Controllo della versione di Team Foundation solo dopo l'archiviazione delle ultime modifiche apportate all'area di lavoro. L'elemento viene invece aggiunto all'elenco delle modifiche in sospeso per l'area di lavoro corrente. Per eseguire il commit dell'operazione di aggiunta delle modifiche in sospeso nel server Controllo della versione di Team Foundation, è possibile archiviare direttamente il file aggiunto oppure archiviare tutte le modifiche in sospeso nell'area di lavoro locale. Per evitare che un altro utente possa aggiungere un file o una cartella con lo stesso nome di quella delle aggiunte in sospeso al server del Controllo della versione di Team Foundation prima di poter archiviare le proprie modifiche in sospeso, è possibile includere l'opzione /lock con il parametro Checkout. Per ulteriori informazioni, vedere Archiviare modifiche in sospeso.

Se si aggiunge il file 314.cs al controllo della versione utilizzando tf add /teamproject/projects/math/314.cs, ciascuna cartella verrà considerata un'aggiunta in sospeso se non esiste già, finché non verranno archiviate le modifiche. Quando si archiviano le modifiche, se una delle cartelle nel percorso specificato (/teamproject, /teamproject/projects o /teamproject/projects/math) non è già presente nel server del Controllo della versione di Team Foundation, verrà creata automaticamente in Team Foundation.

Utilizzare il comando Add per definire la struttura iniziale dei file di un server Controllo della versione di Team Foundation.

Per ulteriori informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.

Esempi

L'esempio riportato di seguito consente di aggiungere i file 314.c e 1256.c all'elenco delle modifiche in sospeso dell'area di lavoro cui è associata la cartella di lavoro C:\Pi.

c:\pi>tf add 314.cs 1256.c

L'esempio riportato di seguito consente di aggiungere tutti i file in codice C# (con estensione cs) presenti nella directory corrente e nelle eventuali sottodirectory all'elenco delle aggiunte in sospeso per l'area di lavoro corrente.

c:\projects>tf add *.cs /recursive

L'esempio riportato di seguito consente di aggiungere tutti i file e le cartelle il cui nome include "hello" presenti nella directory corrente e nelle eventuali sottodirectory all'elenco delle aggiunte in sospeso per l'area di lavoro cui è mappato c:\projects.

c:\projects>tf add *hello* /recursive

Vedere anche

Attività

Aggiungere al controllo della versione file e cartelle non appartenenti al progetto o alla soluzione

Archiviare modifiche in sospeso

Bloccare e sbloccare cartelle o file

Concetti

Modifiche in sospeso

Informazioni sui tipi di blocco

Altre risorse

Comandi dell'utilità della riga di comando Tf

Posizionamento dei file sotto il controllo della versione