Comando Unshelve (Controle de Versão do Team Foundation)
Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | do 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 comando unshelve para remover uma prateleira existente do servidor.
Pré-requisitos
- Para usar o comando
unshelve:- Tenha a permissão Ler definida como Permitir.
- Tenha o Check-out permissão para os itens na prateleira definido como Permitir.
- Para excluir um conjunto de prateleiras, seja seu proprietário ou tenha o Administrar alterações arquivadas permissão global definida como Permitir.
Para obter mais informações, consulte Default TFVC permissions.
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
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 de <item-spec> 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 <item-spec> argumento.
<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 de DevOps do Azure depois de desarquivar com êxito o conjunto de prateleiras. Esta 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.
Comentários
O comando unshelve do utilitário de linha de comando tf 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 comando unshelve para restaurar revisões de arquivos individuais de um conjunto de prateleiras para seu espaço de trabalho. Depois de executar o comando unshelve, execute o comando get 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 utilitário de linha de comando tf, 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 de 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