Condividi tramite

Comando Label (Controllo della versione di Team Foundation)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Il controllo della versione di Team Foundation (TFVC) tf label comando collega un'etichetta a o rimuove un'etichetta da una versione di un file o di una cartella nel server TFVC.

Prerequisiti

Per usare il comando , impostare l'autorizzazione etichetta su Consenti. Per modificare o eliminare etichette create da altri utenti, impostare l'autorizzazione Amministrare le etichette su Consenti. Per altre informazioni, vedere autorizzazioni TFVC predefinite.

Sintassi

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

Argomenti

argomento

Descrizione

<labelname>

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

@<scope>

Specifica una directory del server TFVC in cui il labelname è univoco. Questo parametro consente di creare, gestire, recuperare ed eliminare in modo indipendente un'etichetta o un set di elementi etichettati quando due etichette dello stesso nome si trovano in parti diverse del server TFVC.

<ownername>

Fornisce un valore come DOMAIN\JuanGo o solo juango all'opzione di /owner.

<itemspec>

Identifica il file o la cartella da cui etichettare, etichettare nuovamente o modificare. Per altre informazioni su come TFVC analizza il itemspec per determinare quali elementi si trovano nell'ambito, vedere Usare i comandi di controllo della versione di Team Foundation.

Nota

È possibile specificare più di un argomento itemspec.

<versionspec>

Fornisce un valore come c2 per l'opzione /version. Per altre informazioni su come TFVC analizza una specifica di versione per determinare quali elementi si trovano all'interno del relativo ambito, vedere Usare i comandi di controllo della versione di Team Foundation.

<comment>

Commento fornito dall'utente sull'etichetta.

@<commentfile>

Percorso fornito dall'utente di un file su disco contenente il commento da usare per l'etichetta.

<username>

Fornisce un valore all'opzione /login. È possibile specificare un valore di nome utente come DOMAIN\username o username.

<TeamProjectCollectionUrl>

URL della raccolta di progetti specificata che contiene 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.

Opzioni

di opzione

Descrizione

/owner

Specifica il nome dell'utente proprietario dell'etichetta.

/version

Opzionale. Specifica la versione del file o della cartella a cui associare, modificare o rimuovere l'etichetta. Si tratta di valori del set di modifiche, ad esempio, C93. Per impostazione predefinita, TFVC usa la versione dell'area di lavoro di base se non viene fornita alcuna versionspec.

/comment

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

/child

Non documentato.

/recursive

Etichetta tutti gli elementi nella directory che corrispondono al itemspec e versionspec. Non è possibile usare con l'opzione /delete.

/delete

Rimuove l'etichetta.

/login

Specifica il nome utente e la password per autenticare l'utente con Azure DevOps.

/collection

Specifica la raccolta di progetti.

Osservazioni

Un'etichetta è un marcatore che è possibile collegare a un set di file e cartelle altrimenti non correlati nel server TFVC. Usare l'etichetta per semplificare il recupero di file e cartelle in un'area di lavoro a scopo di sviluppo o compilazione. Un'etichetta è come un insieme di modifiche o una data/ora a cui e da cui è possibile aggiungere e rimuovere arbitrariamente file e cartelle o modificare le versioni degli elementi in esso contenuti. Un'etichetta è una specifica di versione che può essere passata ai comandi TFVC seguenti:

I tipi comuni di etichette sono etichette cardine, ad esempio M1, Beta2o Release Candidate 0.

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

Un'etichetta non è un oggetto con controllo delle versioni. Pertanto, la cronologia delle etichette dei file non viene rilevata. Inoltre, un'operazione di etichetta non crea una modifica in sospeso nell'area di lavoro. Quando si esegue il comando label, l'aggiornamento si riflette immediatamente nel server TFVC.

Per altre informazioni su come usare l'utilità della riga di comando tf, vedere Usare i comandi di controllo della versione di Team Foundation.

Rimuovere ed eliminare etichette

È possibile usare il comando Annullare l'etichetta per rimuovere un'etichetta da un file o una cartella. In alternativa, è possibile eliminare un'etichetta dal sistema usando il comando tf label /delete.

Per informazioni su un'etichetta esistente che include un elenco degli elementi a cui è stata associata l'etichetta, il relativo commento, ambito e proprietario, vedere comando Etichette.

Gestire le etichette di overload

I nomi delle etichette devono essere univoci in un ambito specificato. Quando si aggiunge un'etichetta, si riserva l'uso del nome dell'etichetta in corrispondenza o nell'ambito specificato o implicito. Il valore predefinito per il parametro @scope è il progetto, ad esempio $/TeamProject1.

Se un altro team o utente aggiunge un'etichetta comune, ad esempio M3 a un set di file controllati dalla versione in una parte diversa del server TFVC, è possibile applicare l'etichetta M3 ai file controllati dalla versione nel progetto, purché le cartelle del progetto radice si trovino in directory diverse. Ad esempio, se i file nella directory $/math vengono etichettati M3, è anche possibile applicare l'etichetta M3 ai file nella directory $/projects.

Per ottenere, rimuovere un'etichetta o gestire in altro modo gli elementi con etichetta M3, è necessario specificare il parametro @scope per indicare a TFVC quale M3 etichetta usare.

È possibile impedire ad altri utenti di eseguire l'overload di un'etichetta, ad esempio M3 in parti diverse del server TFVC, creando l'etichetta nel $/ radice del server di controllo della versione di Team Foundation o modificando etichetta autorizzazioni per determinate cartelle.

Esempi

Nell'esempio seguente viene associata l'etichetta goodbuild alla versione dell'area di lavoro della docs cartella e ai file e alle cartelle in esso contenuti.

c:\projects>tf label goodbuild docs /recursive

Nell'esempio seguente l'etichetta viene associata alla cartella docs, ma non ai file e alle cartelle contenuti nella cartella docs.

c:\projects>tf label goodbuild docs

Nell'esempio seguente l'etichetta goodbuild viene associata alla versione 3 di 314.cs nel server TFVC.

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

Nell'esempio seguente viene eliminata l'etichetta badbuild da tutti gli elementi nel server TFVC.

c:\projects>tf label /delete badbuild

Nell'esempio seguente viene usata l'opzione ambito @ per applicare un'etichetta a 314.cs.

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