Condividi tramite

Comando Label (controllo della versione di Team Foundation)

  • Articolo

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

Visual Studio 2019 | Visual Studio 2022

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

Prerequisiti

Per usare il label comando, è necessario disporre dell'autorizzazione Etichetta impostata su Consenti. Per modificare o eliminare etichette create da altri utenti, è necessario disporre dell'autorizzazione Amministrazione ister labels impostata 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 all'interno della quale è univoco labelname . 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 per l'opzione /owner .

<itemspec>

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

Nota

È possibile specificare più itemspec argomenti.

<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

Opzione

Descrizione

/owner

Specifica il nome dell'utente proprietario dell'etichetta.

/version

Facoltativo. Specifica la versione del file o della cartella a cui associare, modificare o rimuovere l'etichetta. Si tratta di valori del set di modifiche, C93ad esempio . Per impostazione predefinita, TFVC usa la versione dell'area di lavoro di base se non viene specificato alcun valore 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 a 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 M1esempio , 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 label comando, l'aggiornamento si riflette immediatamente nel server TFVC.

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

Rimuovere ed eliminare etichette

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

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 @scope parametro è il progetto, ad esempio $/TeamProject1.

Se un altro team o utente aggiunge un'etichetta comune, M3 ad esempio 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 sono etichettati M3, è anche possibile applicare l'etichetta M3 ai file nella directory $/projects .

Per ottenere, rimuovere un'etichetta o gestire M3in caso contrario gli elementi con etichetta, è necessario specificare il @scope parametro per indicare a TFVC M3 l'etichetta da usare.

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

Esempi

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

c:\projects>tf label goodbuild docs /recursive

Nell'esempio seguente l'etichetta goodbuild viene associata alla cartella docs , ma non ai file e alle cartelle contenute 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 l'etichetta badbuild viene eliminata 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