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). .gif "Nota") Nota
È 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:
|
/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
Informazioni sui tipi di blocco