Condividi tramite


Comando Rename (controllo della versione di Team Foundation)

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) rename modifica il nome o il percorso di un file o di una cartella. È possibile usare il rename comando o gli alias move o renper spostare un file o una cartella in un nuovo percorso.

Nota

I risultati di questo comando non si riflettono nel server fino a quando non si esegue un'archiviazione. Per altre informazioni, vedere Sviluppare codice e gestire le modifiche in sospeso.

Prerequisiti

Per usare il rename comando, è necessario disporre dell'autorizzazione Check out impostata su Consenti. Per altre informazioni, vedere Autorizzazioni tfvc predefinite.

Sintassi

tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem

Parametri

Argomenti

Argomento

Descrizione

<olditem>

Nome e percorso originale del file o della cartella da rinominare. È possibile specificare un percorso dell'area di lavoro locale, ad esempio C:\myfiles\314.cs o un percorso del server TFVC, ad esempio $/myfiles/314.cs.

<newitem>

Nuovo nome del file o della cartella. È possibile usare questa opzione per specificare un percorso del server locale o tfvc diverso.

<username>

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

Opzioni

Opzione

Descrizione

/lock

Includere questa opzione per impedire ad altri utenti di eseguire l'archiviazione o l'estrazione degli elementi specificati. Se questa opzione non è specificata, lo stato del blocco esistente dell'elemento non viene modificato. Per altre informazioni, vedere Informazioni sui tipi di blocco.

Opzioni di blocco:

  • None: non viene applicato alcun blocco.
  • Checkin: altri utenti possono archiviare gli elementi specificati, ma non possono archiviare le revisioni nei file bloccati fino a quando non si rilascia il blocco eseguendo un'archiviazione. Se uno degli altri utenti ha bloccato uno degli elementi specificati, l'operazione di blocco ha esito negativo.
  • Checkout: impedisce ad altri utenti di archiviare o archiviare uno degli elementi specificati fino a quando non si rilascia il blocco eseguendo un'archiviazione. Se uno degli altri utenti ha bloccato uno degli elementi specificati, l'operazione di blocco ha esito negativo.

/login

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

Osservazioni:

È possibile usare il rename comando dell'utilità della tf riga di comando per spostare o rinominare un elemento controllato dalla versione nell'area di lavoro. Usare il rename comando per spostare più file specificando caratteri jolly. La possibilità di rinominare più file o cartelle controllati dalla versione è disponibile solo dalla riga di comando.

Usare il rename comando per eseguire le azioni seguenti:

  • Rinominare in olditem newitem, ad esempio tf rename 314.cs 315.cs.
  • Spostare l'oggetto olditem in una nuova posizione nel server TFVC specificando un newitem percorso diverso da quello di olditem, ad esempio tf rename 314.cs ..\newdir\314.cs.

Se si specifica un oggetto newitem che specifica una cartella inesistente, il rename comando crea la cartella di destinazione. Se newitem è una cartella, olditem diventa un elemento figlio di newitem.

Non è possibile rinominare un elemento se:

  • È già stato eliminato prima dell'archiviazione nella stessa area di lavoro.
  • Il nuovo nome esiste già nel server TFVC e non è una cartella.
  • È già stato aggiunto, ramizzato o rinominato l'archiviazione in sospeso dell'elemento.
  • L'elemento viene mappato nell'area di lavoro, ma non è disponibile nel disco locale.
  • L'elemento è nascosto.

È possibile rinominare un elemento per il quale è stato aggiunto un altro file con lo stesso nome in sospeso, ma non è possibile rinominare un elemento che è stato ramizzato ma non ancora archiviato. Quando si rinomina un file con modifiche in sospeso, le modifiche vengono mantenute.

Non è possibile rinominare un elemento mappato in modo esplicito senza prima modificare il mapping. Ad esempio, se è presente un mapping di cartelle di lavoro di $/ProjectX/MyApp a c:\MyApp, non è possibile rinominare MyApp. È possibile rinominare gli elementi in MyApp, ma non in MyApp .

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

Esempi

Nell'esempio seguente il nome di 314.cs viene modificato in 1254.cs.

c:\projects>tf rename  314.cs  1254.cs

L'esempio seguente rinomina 314.cs in 1254.cs e lo sposta nella cartella newdir .

c:\projects>tf rename 314.cs ..\newdir\1254.cs

Nell'esempio seguente il nome di Form1.vb viene modificato in MainPage.vb e viene applicato un blocco.

c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin