Compartilhar via

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 TFVC (Controle de Versão do Team Foundation) unshelve restaura revisões de arquivo arquivadas, notas de check-in, comentários e associações de itens de trabalho para o workspace atual. Você também pode usar o comando unshelve para remover um conjunto de prateleiras existente do servidor.

Pré-requisitos

  • Para usar o comando unshelve:
    • Tenha a permissão Ler definida para Permitir.
    • Tenha a permissão Check-out para os itens no conjunto de prateleiras definido como Permitir.
  • Para excluir um conjunto de prateleiras, seja seu proprietário ou tenha o Administrar alterações arquivadas permissão global definida para Permitir.

Para obter mais informações, consulte permissões TFVC padrão.

Sintaxe

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

Parâmetros

As seções a seguir descrevem argumentos e opções do comando unshelve.

Argumentos

de argumento

descrição

<shelveset-name>

Especifica o nome do conjunto de prateleiras a ser restaurado.

<owner-name>

Especifica o nome de usuário do proprietário do conjunto de prateleiras.

<item-spec>

Identifica as revisões de arquivo ou pasta para desacompartar no workspace atual. Se esse parâmetro não estiver incluído, todas as alterações pendentes no conjunto de prateleiras 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 – Use opções para modificar como um comando funciona.

Nota

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

<username>

Fornece um valor para a opção /login. Você pode especificar esse valor como DOMAIN\<username> ou <username>.

<password>

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

Opções

opção

descrição

/move

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

Você também pode excluir um conjunto de prateleiras 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.

Observações

O comando unshelve do utilitário de linha de comando tf recupera todas as revisões de arquivo arquivadas 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 desacompartar um item, não deve haver revisões pendentes no workspace de destino.

Quando você não ajuda um conjunto de prateleiras, 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 inútil, consulte Trabalhar com conjuntos de prateleiras.

Você pode usar o comando unshelve para restaurar revisões de arquivo individuais de um conjunto de prateleiras 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 prateleiras foi criado.

Para obter mais informações sobre como usar o utilitário de linha de comando tf, 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, descomplam o conjunto de prateleiras desejado. Como prática recomendada, também obtenha a versão mais recente de seus arquivos controlados por versão após a inserção.

Descompartive e examine o código de outro usuário

Você também pode desacompartar um conjunto de prateleiras para examinar as alterações do workspace de outro usuário. Para desacompartá-lo 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 prateleiras foi criado. Nesse caso, você pode recuperar a versão base de todos os itens relacionados do workspace do proprietário do conjunto de prateleiras. Para usar essa opção, execute uma variação do seguinte comando: tf get \* /version;W<workspace-name>, em que <workspace-name> é o nome do workspace do qual o outro usuário criou o conjunto de prateleiras.

  • 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 prateleiras 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 prateleiras foi criado.

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

Se você tentar desacompartar 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 prateleiras usando tf shelve /delete. Para obter mais informações, consultede comando Shelve. Para excluir automaticamente um conjunto de prateleiras depois de desabilitar todo o conjunto de prateleiras, use tf unshelve /move.

Exemplos

O exemplo a seguir abre a caixa de diálogo Não útil para que você possa encontrar e desacomplicar um conjunto de prateleiras no workspace atual. Você também tem uma opção na caixa de diálogo para ter o conjunto de prateleiras excluído quando a operação não útil for concluída.

c:\>tf unshelve

O exemplo a seguir desacompla o conjunto de prateleiras buddytest_1256 no workspace atual e o remove do Servidor do Azure DevOps:

c:\>tf unshelve /move buddytest_1256