Condividi tramite


Comando Label (controllo della versione di Team Foundation)

Collega o rimuove un'etichetta da una versione di un file o di una cartella presente nel server per Controllo della versione di Team Foundation.

Autorizzazioni necessarie

Per utilizzare il comando label, è necessario disporre dell'autorizzazione Etichetta impostata su Consenti. Per modificare o eliminare etichette create da altri utenti, è necessario disporre dell'autorizzazione Amministra etichette impostata su Consenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

tf label labelname[@scope] [/owner:ownername] 
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)] 
[/child:(replace|merge)] [/recursive] [login:username,[password]] [/collection:TeamProjectCollectionUrl]

tf label /delete labelname[@scope] 
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Parametri

Argomento

Oggetto di descrizione

labelname

Identifica il nome dell'etichetta da collegare, modificare o rimuovere dagli elementi specificati.

@scope

Indica una directory del server Controllo della versione di Team Foundation all'interno della quale il parametro labelname è univoco. Questo parametro consente di creare, gestire, recuperare ed eliminare in modo indipendente un'etichetta o un insieme di elementi con etichetta quando in parti diverse del server Controllo della versione di Team Foundation sono presenti due etichette con lo stesso nome.

ownername

Fornisce un valore, ad esempio DOMINIO\JuanGo o solo juango, per l'opzione /owner.

itemspec

Identifica il file o la cartella da cui eseguire operazioni di etichettatura, rietichettatura o modifica. 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.

versionspec

Fornisce un valore, ad esempio c2, per l'opzione /version. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation sulla specifica di una versione per determinare gli elementi all'interno dell'ambito, vedere Sintassi della riga di comando (controllo della versione).

comment

Commento, fornito dall'utente, sull'etichetta.

@commentfile

Percorso, fornito dall'utente, di un file su disco contenente il commento da utilizzare per l'archiviazione.

username

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

TeamProjectCollectionUrl

URL dell'insieme di progetti team specificato contenente una versione di un file o di una cartella a cui si desidera allegare un'etichetta o da cui si desidera eliminare un'etichetta (ad esempio, http://myserver:8080/tfs/DefaultCollection).

Opzione

Oggetto di descrizione

/owner

Indica il nome del proprietario dell'etichetta.

/version

Facoltativo. Indica la versione del file o della cartella di cui collegare o modificare l'etichetta oppure da cui rimuovere l'etichetta. Si tratta di valori dell'insieme di modifiche, ad esempio C93. Per impostazione predefinita, in Team Foundation viene utilizzata la versione di base dell'area di lavoro se non viene specificato alcun valore per versionspec.

/comment

Aggiunge o modifica una descrizione o un commento per l'etichetta.

/child

Identifica la modalità di gestione degli elementi per i quali sono disponibili etichette preesistenti identiche a quella specificata. Utilizzare Replace per aggiornare la versione dell'elemento corrispondente all'etichetta esistente. Utilizzare Merge per lasciare solo gli elementi con l'etichetta esistente.

/recursive

Aggiunge l'etichetta a tutti gli elementi presenti nella directory corrispondente a itemspec eversionspec.

Non è possibile utilizzare questa opzione con l'opzione /delete.

/delete

Rimuove l'etichetta.

/login

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

/collection

Specifica l'insieme di progetti team.

Note

Un'etichetta è un indicatore che è possibile apporre in modo selettivo a un insieme di file e cartelle non correlati in altri modi nel server Controllo della versione di Team Foundation. Utilizzare l'etichetta per semplificare il recupero di questi file in un'area di lavoro per scopi di sviluppo o di compilazione. Un'etichetta è pertanto simile a un insieme di modifiche o a un indicatore di data/ora a cui e da cui è possibile aggiungere e rimuovere arbitrariamente file e cartelle oppure modificare le versioni degli elementi in essa presenti. Un'etichetta è una specifica di versione che è possibile passare ai seguenti comandi di Team Foundation:

Tipi comuni di etichetta sono quelle che indicano un'attività cardine, ad esempio "M1", "Beta2" o "Release Candidate 0".

Le etichette sono specifiche della versione, ovvero è possibile collegare un'etichetta a un'unica versione di un file o di una cartella. Ogni versione di un elemento può supportare più etichette.

Un'etichetta non corrisponde a un oggetto con versione, pertanto non viene tenuta traccia della cronologia delle etichette dei file. Un'operazione relativa all'etichetta non implica inoltre la creazione di una modifica in sospeso nell'area di lavoro. Quando si esegue il comando label , l’aggiornamento viene immediatamente inviato al 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.

Rimozione ed eliminazione di etichette

È possibile utilizzare il Comando Unlabel per rimuovere un'etichetta da un file o da una cartella. In alternativa, è possibile eliminare un'etichetta dal sistema utilizzando il comando tf label /delete.

Per informazioni su un'etichetta esistente che include un elenco degli elementi ai quali è stata collegata, con il relativo commento, ambito e proprietario, vedere Comando Labels.

Gestione delle etichette di overload

I nomi di etichetta devono essere univoci in un ambito specificato. Quando si aggiunge un'etichetta, si riserva l'utilizzo del nome di tale etichetta nell'ambito specificato o implicito. Il valore predefinito per il parametro @scope è il progetto Team, ad esempio $/ProgettoTeam1.

Se un altro team o utente aggiunge un'etichetta comune, ad esempio "M3", a un gruppo di file di origine in un'altra parte del server Controllo della versione di Team Foundation, sarà possibile applicare l'etichetta M3 ai file inclusi nel controllo della versione all'interno del progetto se le cartelle radice del progetto si trovano in directory diverse. Se ad esempio ai file della directory $/math viene applicata l'etichetta "M3", sarà possibile applicare tale etichetta ai file presenti nella directory $/projects.

Per ottenere o rimuovere un'etichetta o altrimenti gestire gli elementi con l'etichetta M3, è necessario specificare il parametro @scope in modo da indicare a Team Foundation l'etichetta M3 che si desidera utilizzare.

Per impedire ad altri utenti di eseguire l'overload di un'etichetta quale "M3" in parti diverse del server Controllo della versione di Team Foundation, è possibile creare l'etichetta nella radice ($/) del server Controllo della versione di Team Foundation oppure modificare le autorizzazioni Label per alcune cartelle.

Utilizzo dell'opzione /Child per evitare problemi di etichettatura

Se si esegue un comando label con un nome di etichetta preesistente e un itemspec che include file già contrassegnati dalla stessa etichetta, il valore dell'opzione /child determinerà se i file contrassegnati verranno aggiornati con le nuove informazioni sulla revisione. In altri termini, i file hanno un'etichetta con lo stesso nome, ma hanno ambito diverso.

Si supponga ad esempio di disporre di una cartella denominata c:\projects che contiene due file, ovvero 314.cs e 271.cs. Si supponga inoltre che alla versione C70 di 314.cs sia stata assegnata l'etichetta "ready". La versione più recente di 314.cs è la C93. Se si applica un'etichetta "ready" alla versione più recente della cartella e dei file che contiene utilizzando il comando seguente, l'etichetta "ready" verrà spostata da 314.cs;C70 a 314.cs;C93:

tf label ready c:\projects /recursive /version:T /child:Replace

Se invece non si desidera spostare l'etichetta "ready" esistente dalla versione C70 alla versione C93 di 314.cs, utilizzare la seguente sintassi:

tf label ready c:\projects /recursive /version:T /child:Merge

Quando si specifica Merge come valore dell'opzione /child, le istanze preesistenti dell'etichetta vengono lasciate da sole.

Nota

T è utilizzato per "Tip" per ottenere la versione più recente di versionspec nei due esempi riportati in precedenza.

Esempi

L'esempio riportato di seguito consente di collegare l'etichetta "goodbuild" alla versione dell'area di lavoro della cartella "docs" e dei file e delle cartelle in essa contenuti.

c:\projects>tf label goodbuild docs /recursive

L'esempio riportato di seguito consente di collegare l'etichetta "goodbuild" alla cartella "docs", ma non ai file e alle cartelle in essa contenuti.

c:\projects>tf label goodbuild docs

L'esempio riportato di seguito consente di collegare l'etichetta "goodbuild" alla versione 3 del file 314.cs nel server Controllo della versione di Team Foundation.

c:\projects>tf label goodbuild /version:3 $/src/314.cs

L'esempio riportato di seguito consente di rimuovere l'etichetta "badbuild" da tutti gli elementi disponibili nel server Controllo della versione di Team Foundation.

c:\projects>tf label /delete badbuild

L'esempio riportato di seguito consente di utilizzare l'opzione scope per applicare un'etichetta al file 314.cs.

c:\projects>tf label goodbuild@$/TeamProject1 314.cs

Vedere anche

Riferimenti

Sintassi della riga di comando (controllo della versione)

Comando Labels

Comando Unlabel

Concetti

Utilizzare le etichette per eseguire uno snapshot dei file

Utilizzare le etichette per eseguire uno snapshot dei file

Altre risorse

Comandi dell'utilità della riga di comando Tf