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

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O comando Team Foundation Version Control (TFVC) unshelve restaura revisões de arquivos arquivados, notas de check-in, comentários e associações de item de trabalho para o espaço de trabalho atual. Você também pode usar o unshelve comando para remover uma prateleira existente do servidor.

Pré-requisitos

  • Para usar o unshelve comando:
    • Você deve ter a permissão de leitura definida como Permitir.
    • Você deve ter a permissão Check-out para os itens na prateleira definida como Permitir.
  • Para excluir um conjunto de prateleiras, você deve ser seu proprietário ou ter a permissão global Administrar alterações arquivadas definida como 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 unshelve comando.

Argumentos

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 a serem desarquivadas no espaço de trabalho atual. Se esse parâmetro não estiver incluído, todas as alterações pendentes no conjunto de prateleiras especificado serão desarquivadas, por padrão. Os caminhos do servidor não são permitidos.

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

Nota

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

<username>

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

<password>

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

Opções

Opção

Descrição

/move

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

Você também pode excluir um conjunto de prateleiras usando o shelve comando.

/recursive

Especifica que o valor deve ser correspondido <item-spec> 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 unshelve comando do tf utilitário de linha de comando recupera todas as revisões de arquivo arquivado ou um subconjunto definido de todas as revisões de arquivo arquivado do servidor Azure DevOps. Em seguida, o comando armazena as revisões no espaço de trabalho atual.

Para desarquivar um item, não deve haver revisões pendentes contra ele no espaço de trabalho de destino.

Quando você desarquiva um conjunto de prateleiras, o TFVC restaura cada revisão engavetada no espaço de trabalho 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 espaço de trabalho. Para obter mais informações sobre o que acontece durante o processo de desarquivamento, consulte Trabalhar com prateleiras.

Você pode usar o unshelve comando para restaurar revisões de arquivos individuais de um conjunto de prateleiras para seu espaço de trabalho. Depois de executar o unshelve comando, execute o get comando para reconciliar todas 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 tf utilitário de linha de comando, consulte Usar comandos de controle de versão do Team Foundation.

Reciclar mudanças engavetadas

Se você quiser integrar revisões engavetadas em seu espaço de trabalho atual para fazer revisões contínuas, desarquive o conjunto de prateleiras desejado. Como prática recomendada, obtenha também a versão mais recente dos seus ficheiros com controlo de versão depois de desarquivar.

Desarquivar e rever o código de outro utilizador

Você também pode desarquivar um conjunto de prateleiras para revisar as alterações do espaço de trabalho de outro usuário. Para desarquivar por esse motivo, você tem duas opções:

  • A primeira opção é apropriada quando os itens engavetados e 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 espaço de trabalho 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>, onde <workspace-name> é o nome do espaço de trabalho a partir do qual o outro usuário criou o conjunto de prateleiras.

  • A segunda opção é apropriada quando uma quantidade significativa de tempo passou ou várias revisões estiveram no espaço de trabalho 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 desarquivar a alteração arquivada de outro usuário anexando o nome de usuário ao nome do conjunto de prateleiras. No entanto, você só pode remover um conjunto de prateleiras do servidor de DevOps do Azure que foi criado por outro usuário se tiver a permissão AdminShelvedChangesets .

Se você tentar desarquivar um item com uma alteração pendente no espaço de trabalho de destino, o TFVC não mesclará diferenças entre os itens e não recuperará a revisão em seu espaço de trabalho.

Você pode excluir um conjunto de prateleiras usando tf shelve /delete. Para obter mais informações, consulte Comando Shelve. Para excluir automaticamente um conjunto de prateleiras depois de desarquivar todo o conjunto de prateleiras, use tf unshelve /move.

Exemplos

O exemplo a seguir abre a caixa de diálogo Unshelve para que você possa localizar e desarquivar um conjunto de prateleiras no espaço de trabalho 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 de desprateleira terminar.

c:\>tf unshelve

O exemplo a seguir desmonta o buddytest_1256 do conjunto de prateleiras no espaço de trabalho atual e o remove do Servidor de DevOps do Azure:

c:\>tf unshelve /move buddytest_1256