Comando Undelete (Controle de Versão do Team Foundation)
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) undelete
restaura itens que foram excluídos anteriormente.
Nota
Os resultados desse comando não ficam visíveis em outros workspaces até que você execute uma operação de check-in. Para obter mais informações, consulte Desenvolver código e gerenciar alterações pendentes.
Pré-requisitos
Para usar o comando undelete
:
- Tenha a permissão Check-out definida para Permitir.
- Se você incluir a opção
/lock
com um valor diferente deNone
, tenha a permissão Bloquear definida como Permitir. - Você deve ser proprietário do workspace ou ter a permissão Administrar workspaces global definida para Permitir.
Para obter mais informações, consulte permissões TFVC padrão.
Sintaxe
tf undelete [/noget] [/lock:(none|checkin|checkout)]
[/recursive] <item-specification>[;<deletion-ID>] [/login:<username>,[<password>]]
Parâmetros
As seções a seguir descrevem argumentos e opções do comando undelete
.
Argumentos
Argumento | Descrição |
---|---|
<item-specification> |
Identifica o arquivo ou a pasta a ser restaurado. Para obter mais informações sobre como o TFVC analisa <item-specification> valores para determinar quais itens estão dentro do escopo, consulte Usar comandos de controle de versão do Team Foundation. |
<deletion-ID> |
Especifica um identificador exclusivo que desambigua vários itens excluídos que têm o mesmo nome. |
<username> |
Fornece um valor para a opção /login . Você pode especificar esse valor como DOMAIN\<username> ou <username> . |
Opções
opção
descrição
/noget
Restaura o item excluído em seu workspace. Após a conclusão de uma operação de check-in, essa opção restaura o item no servidor, mas não recupera imediatamente uma cópia física do item em disco.
/lock
Impede que outros usuários entrem ou confiram os arquivos especificados. Para obter mais informações, consulte Noções básicas sobre os tipos de bloqueio.
Opções de bloqueio de :
-
None
: essa opção é o valor padrão. Nenhum bloqueio é aplicado. -
Checkin
: outros usuários podem fazer check-out dos itens especificados, mas não podem fazer check-in de revisões para arquivos bloqueados até que você libere o bloqueio verificando os arquivos bloqueados. Se outros usuários bloquearem qualquer um dos itens especificados, a operação de bloqueio falhará. -
Checkout
: essa opção impede que outros usuários faça check-in ou faça check-out de qualquer um dos itens especificados até que você libere o bloqueio verificando os arquivos bloqueados. Se outros usuários bloquearem qualquer um dos itens especificados, a operação de bloqueio falhará.
/recursive
Restaura todos os arquivos e subpastas do diretório especificado.
/login
Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps.
Observações
O comando undelete
do recurso de linha de comando tf
agenda arquivos ou pastas especificados para restauração até a conclusão de uma operação de check-in. Ele também recupera os itens especificados do servidor para o disco local, a menos que você inclua explicitamente a opção /noget
.
Quando arquivos ou pastas com o mesmo nome tiverem sido excluídos da mesma pasta de servidor, você deve incluir um valor para o parâmetro <deletion-ID>
para indicar quais dos itens excluídos você deseja restaurar. Você pode obter um <deletion-ID>
usando o comando dir
.
Se você quiser alterar um arquivo depois de restaurá-lo, confira o arquivo para edição usando o comando checkout
como de costume.
Quando seu valor <item-specification>
especifica uma pasta, o TFVC restaura por padrão todos os arquivos e subpastas da pasta e os arquivos que eles contêm. Se você não quiser restaurar todos os itens em uma pasta, primeiro desdelete a pasta e seus itens e exclua os itens que não deseja manter.
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.
Exemplos
O exemplo a seguir restaura 314.cs para a pasta do servidor da qual 314.cs foi excluído. O comando também recupera uma cópia somente leitura da versão mais recente no workspace atual.
C:\projects>tf undelete c:\math\314.cs
O exemplo a seguir exibe IDs de exclusão para todos os itens no servidor que foram excluídos mais de uma vez:
c:\projects>tf dir $/ /deleted
A saída do comando anterior pode ser semelhante à seguinte amostra:
$/projects/math/314.cs;X10
$/projects/math/314.cs;X11
O exemplo a seguir restaura a versão X11 do 314.cs para a pasta do servidor da qual o arquivo foi excluído. O comando também recupera uma cópia somente leitura da versão mais recente no workspace atual.
c:\projects>tf undelete 314.cs;X11