Condividi tramite

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

Prerequisiti

  • Per usare il comando unshelve:
    • Impostare l'autorizzazione lettura su Consenti.
    • Disporre dell'autorizzazione Check out per gli elementi nel set di scaffali impostato su Consenti.
  • Per eliminare un insieme di scaffali, essere il proprietario o disporre delle modifiche Amministrare le modifiche set di autorizzazioni globali 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 comando unshelve.

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 <item-spec> valori per determinare quali elementi si trovano nell'ambito, vedere Usare i comandi di controllo della versione di Team Foundation - Usare le opzioni per modificare il modo in cui un comando funziona.

Nota

È possibile specificare più di un argomento <item-spec>.

<username>

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

<password>

Fornisce un valore all'opzione /login.

Opzioni

di 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 valore <item-spec>.

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

/recursive

Specifica che il valore <item-spec> 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 comando unshelve dell'utilità della riga di comando di tf recupera tutte le revisioni dei file in formato shelved o un subset definito di tutte le revisioni dei file da parte del 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 comando unshelve per ripristinare singole revisioni di file da un insieme di scaffali all'area di lavoro. Dopo aver eseguito il comando unshelve, eseguire il comando get per riconciliare le modifiche archiviate nel server dopo la creazione del set di scaffali.

Per altre informazioni su come usare l'utilità della riga di comando tf, 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 AdminShelvedChangesets.

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 l'annullamento dell'intero scaffale, utilizzare 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