Comando unshelve (Controle de Versão do Team Foundation)

  • Artigo

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

Visual Studio 2019 | Visual Studio 2022

O comando unshelve TFVC (Controle de Versão do Team Foundation) restaura revisões de arquivo armazenadas, notas de check-in, comentários e associações de itens de trabalho para o workspace atual. Você também pode usar o comando unshelvepara remover um conjunto check-in particular existente do servidor.

Pré-requisitos

  • Para usar o comando unshelve:
    • Você deve ter a permissão deLeitura definida como Permitir.
    • Você deve ter a permissão deCheck-out para os itens no conjunto de check-in particular definido como Permitir.
  • Para excluir um conjunto de check-in particular, você deve ser seu proprietário ou ter a permissão global Administrar alterações arquivadas definida como Permitir.

Para saber mais, confira Permissões padrão do TFVC.

Sintaxe

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

Parâmetros

Veja nas seções a seguir a descrição dos argumentos e das opções do comando unshelve.

Argumentos

Argument

Descrição

<shelveset-name>

Especifica o nome do conjunto de check-in particular a ser restaurado.

<owner-name>

Especifica o nome de usuário do proprietário do conjunto de check-in particular.

<item-spec>

Identifica as revisões de arquivo ou pasta para desfazer o check-in particular no workspace atual. Se esse parâmetro não estiver incluído, todas as alterações pendentes no conjunto de check-in particular especificado não serão úteis, por padrão. Caminhos de servidor não são permitidos.

Para obter mais informações sobre como o TFVC analisa <item-spec> valores para determinar quais itens estão dentro do escopo, consulte Usar comandos de controle de versão do Team Foundation – Usar opções para modificar como um comando funciona.

Observação

Você pode especificar mais de um argumento <item-spec>.

<username>

Mostra um valor para a opção /login. É possível especificar esse valor como DOMAIN\<username> ou <username>.

<password>

Mostra um valor para a opção /login.

Opções

Opção

Descrição

/move

Exclui o conjunto de check-in particular especificado do servidor do Azure DevOps depois de desativar com êxito o conjunto de check-in particular. Essa opção não pode ser combinada com um valor <item-spec>.

Você também pode excluir um conjunto check-ins particulares usando o comando shelve.

/recursive

Especifica que o valor <item-spec> deve ser correspondido recursivamente.

/noprompt

Especifica que o TFVC não deve solicitar entrada.

/login

Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps.

Comentários

O comando unshelve do utilitário de linha de comando tf recupera todas as revisões de arquivo armazenadas ou um subconjunto definido de todas as revisões de arquivo arquivadas do servidor do Azure DevOps. Em seguida, o comando armazena as revisões no workspace atual.

Para desfazer o check-in particular de um item, não deve haver revisões pendentes no workspace de destino.

Quando você não ajuda um conjunto de check-in particular, o TFVC restaura cada revisão arquivada no workspace de destino como uma alteração pendente, desde que a revisão não entre em conflito com uma alteração que já estava pendente no workspace. Para obter mais informações sobre o que acontece durante o processo de desfazer o check-in particular, consulte Trabalhar com conjuntos de check-in particular.

Você pode usar o comando unshelve para restaurar revisões de arquivo individuais de um conjunto de check-in particular para seu workspace. Depois de executar o comando unshelve, execute o comando get para reconciliar as alterações que foram verificadas no servidor desde que o conjunto de check-in particular foi criado.

Para obter mais informações sobre como usar o tf utilitário de linha de comando, consulte Usar comandos de controle de versão do Team Foundation.

Reciclar alterações arquivadas

Se você quiser integrar revisões arquivadas em seu workspace atual para fazer revisões contínuas, desfaça o conjunto de check-in particular. Como prática recomendada, também obtenha a versão mais recente de seus arquivos controlados por versão após a inserção.

Desfazer check-in particular e examinar o código de outro usuário

Você também pode desfazer o check-in particular para examinar as alterações do workspace de outro usuário. Para desfazer um check-in particular por esse motivo, você tem duas opções:

  • A primeira opção é apropriada quando os itens arquivados e os itens relacionados não foram revisados ou só foram revisados levemente desde que o conjunto de check-in particular foi criado. Nesse caso, você pode recuperar a versão base de todos os itens relacionados do workspace do proprietário do conjunto de check-in particular. Para usar essa opção, execute uma variação do seguinte comando: tf get \* /version;W<workspace-name>, em <workspace-name> que é o nome do workspace do qual o outro usuário criou o conjunto de check-in particular.

  • A segunda opção é apropriada quando um período significativo de tempo é passado ou várias revisões estão no workspace desde que o conjunto de check-in particular foi criado. Nesse caso, você pode recuperar a versão de todos os itens relacionados do servidor a partir da data e hora em que o conjunto de check-in particular foi criado.

Você pode cancelar a alteração arquivada de outro usuário acrescentando o nome de usuário ao nome do conjunto de check-in particular. No entanto, você só poderá remover um conjunto de check-in particular do servidor do Azure DevOps que foi criado por outro usuário se você tiver a permissão AdminShelvedChangesets.

Se você tentar desfazer o check-in particular de um item com uma alteração pendente no workspace de destino, o TFVC não mescla diferenças entre os itens e não recupera a revisão em seu workspace.

Você pode excluir um conjunto de check-in particular usando tf shelve /delete. Para obter mais informações, consulte o comando Shelve. Para excluir automaticamente um conjunto de check-in particular depois de desabilitar todo o conjunto de check-in particular, use tf unshelve /move.

Exemplos

O exemplo a seguir abre a caixa de diálogo Desfazer check-in particular para que você possa encontrar e desfazer um conjunto de check-in particular no workspace atual. Você também tem uma opção na caixa de diálogo para ter o conjunto de check-in particular excluído quando a operação for concluída.

c:\>tf unshelve

O exemplo a seguir descompõe o conjunto de buddytest_1256 no workspace atual e o remove do Azure DevOps Server:

c:\>tf unshelve /move buddytest_1256