Comando Unshelve (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) unshelve ripristina le revisioni dei file, le note di archiviazione, i commenti e le associazioni degli elementi di lavoro nell'area di lavoro corrente. È anche possibile usare il unshelve comando per rimuovere un insieme di scaffali esistente dal server.

Prerequisiti

  • Per usare il unshelve comando :
    • È necessario disporre dell'autorizzazione Lettura impostata su Consenti.
    • È necessario disporre dell'autorizzazione Check out per gli elementi nel set di scaffali impostato su Consenti.
  • Per eliminare un set di scaffali, è necessario essere il proprietario o disporre dell'autorizzazione globale delle modifiche Amministrazione ister impostate su Consenti.

Per altre informazioni, vedere Autorizzazioni tfvc predefinite.

Sintassi

tf unshelve [/move] [<shelveset-name>[;<owner-name>]] <item-spec> 
[/recursive] [/noprompt][/login:<username>,[<password>]]

Parametri

Le sezioni seguenti descrivono argomenti e opzioni del unshelve comando.

Argomenti

Argomento

Descrizione

<shelveset-name>

Specifica il nome dell'insieme di scaffali da ripristinare.

<owner-name>

Specifica il nome utente del proprietario degli scaffali.

<item-spec>

Identifica le revisioni di file o cartelle da annullare nell'area di lavoro corrente. Se questo parametro non è incluso, per impostazione predefinita tutte le modifiche in sospeso nel set di scaffali specificato vengono annullate. I percorsi del server non sono consentiti.

Per altre informazioni sul modo in cui tfvc analizza i <item-spec> valori per determinare quali elementi rientrano nell'ambito, vedere Usare i comandi di controllo della versione di Team Foundation - Usare le opzioni per modificare le funzioni di un comando.

Nota

È possibile specificare più <item-spec> argomenti.

<username>

Fornisce un valore all'opzione /login . È possibile specificare questo valore come DOMAIN\<username> o <username>.

<password>

Fornisce un valore all'opzione /login .

Opzioni

Opzione

Descrizione

/move

Elimina il set di scaffali specificato dal server Azure DevOps dopo aver rimosso correttamente lo scaffale. Questa opzione non può essere combinata con un <item-spec> valore.

È anche possibile eliminare un insieme di scaffali usando il shelve comando .

/recursive

Specifica che il <item-spec> valore deve corrispondere in modo ricorsivo.

/noprompt

Specifica che tfvc non deve richiedere l'input.

/login

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

Osservazioni:

Il unshelve comando dell'utilità della tf riga di comando recupera tutte le revisioni di file con spaziatura o un subset definito di tutte le revisioni dei file shelved dal server Azure DevOps. Il comando archivia quindi le revisioni nell'area di lavoro corrente.

Per annullare un elemento, nell'area di lavoro di destinazione non devono essere presenti revisioni in sospeso.

Quando si annulla l'inserimento di un set di scaffali, TFVC ripristina ogni revisione suddivisa nell'area di lavoro di destinazione come modifica in sospeso, purché la revisione non sia in conflitto con una modifica già in sospeso nell'area di lavoro. Per altre informazioni su cosa accade durante il processo di annullamento, vedere Usare gli scaffali.

È possibile usare il unshelve comando per ripristinare singole revisioni di file da un insieme di scaffali all'area di lavoro. Dopo aver eseguito il comando, eseguire il unshelve get comando per riconciliare le modifiche archiviate nel server dopo la creazione dell'insieme di scaffali.

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

Riciclare le modifiche archiviate

Se si vogliono integrare revisioni suddivise nell'area di lavoro corrente per apportare revisioni in corso, rimuovere gli scaffali desiderati. Come procedura consigliata, ottenere anche la versione più recente dei file controllati dalla versione dopo l'annullamento dell'applicazione.

Annullare e rivedere il codice di un altro utente

È anche possibile rimuovere uno scaffale per esaminare le modifiche apportate dall'area di lavoro di un altro utente. Per annullare l'archiviazione per questo motivo, sono disponibili due opzioni:

  • La prima opzione è appropriata quando gli elementi e gli elementi correlati non sono stati rivisti o sono stati rivisti leggermente dopo la creazione dell'insieme di scaffali. In questo caso, è possibile recuperare la versione di base di tutti gli elementi correlati dall'area di lavoro del proprietario degli scaffali. Per usare questa opzione, eseguire una variante del comando seguente: tf get \* /version;W<workspace-name>, dove <workspace-name> è il nome dell'area di lavoro da cui l'altro utente ha creato il set di scaffali.

  • La seconda opzione è appropriata quando è trascorsa una quantità significativa di tempo o più revisioni nell'area di lavoro dopo la creazione dell'insieme di scaffali. In questo caso, è possibile recuperare la versione di tutti gli elementi correlati dal server a partire dalla data e dall'ora di creazione dell'insieme di scaffali.

È possibile annullare la modifica di un altro utente aggiungendo il nome utente al nome dell'insieme di scaffali. Tuttavia, è possibile rimuovere un insieme di scaffali solo dal server Azure DevOps creato da un altro utente se si dispone dell'autorizzazione Amministrazione ShelvedChangesets.

Se si tenta di annullare l'inserimento di un elemento con una modifica in sospeso nell'area di lavoro di destinazione, TFVC non unisce le differenze tra gli elementi e non recupera la revisione nell'area di lavoro.

È possibile eliminare un insieme di scaffali usando tf shelve /delete. Per altre informazioni, vedere Comando Shelve. Per eliminare automaticamente un set di scaffali dopo aver rimosso l'intero scaffale, usare tf unshelve /move.

Esempi

Nell'esempio seguente viene aperta la finestra di dialogo Unshelve in modo che sia possibile trovare e rimuovere uno scaffale nell'area di lavoro corrente. Nella finestra di dialogo è anche disponibile un'opzione per eliminare il set di scaffali al termine dell'operazione di annullamento.

c:\>tf unshelve

L'esempio seguente rimuove il set di scaffali buddytest_1256 nell'area di lavoro corrente e lo rimuove dal server Azure DevOps:

c:\>tf unshelve /move buddytest_1256