Compartilhar via

Comando undelete (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) undelete restaura itens que foram excluídos anteriormente.

Observação

Os resultados desse comando não são 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:

  • Você deve ter a permissão Check-out definida como Permitir.
  • Se você incluir a opção /lock com um valor diferente de None, deverá ter a permissão Bloquear definida como Permitir.
  • Você deve possuir o workspace ou ter a permissão global Administrar workspacesdefinida como Permitir.

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

Sintaxe

tf undelete [/noget] [/lock:(none|checkin|checkout)] 
[/recursive] <item-specification>[;<deletion-ID>] [/login:<username>,[<password>]]

Parâmetros

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

Argumentos

Argument Descrição
<item-specification> Identifica o arquivo ou a pasta a ser restaurada. 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> Mostra um valor para a opção /login. É possível 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 verifiquem ou verifiquem os arquivos especificados. Para obter mais informações, consulte Noções básicas sobre tipos de bloqueio.

Opções de bloqueio:

  • None: essa opção é o valor padrão. Nenhum bloqueio é aplicado.
  • Checkin: outros usuários podem marcar os itens especificados, mas não podem marcar em revisões para arquivos bloqueados até que você libere o bloqueio verificando os arquivos bloqueados. Se outros usuários tiverem bloqueado 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 check-out de qualquer um dos itens especificados até que você libere o bloqueio verificando os arquivos bloqueados. Se outros usuários tiverem bloqueado 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.

Comentários

O undelete comando do recurso tf da linha de comando agenda arquivos ou pastas especificados para restauração até a conclusão de uma operação de marcar. 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ê deverá incluir um valor para o parâmetro <deletion-ID> a fim de indicar qual 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 o 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 desfaça a exclusão da pasta e seus itens e exclua os itens que não deseja manter.

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.

Exemplos

O exemplo a seguir restaura o 314.cs para a pasta do servidor da qual o 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 se parecer com o seguinte exemplo:

$/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 de 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