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

Nota

Os resultados desse comando não são visíveis em outros espaços de trabalho 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 undelete comando:

  • Você deve ter a permissão Check-out definida como Permitir.
  • Se você incluir a /lock opção com um valor diferente de None, deverá ter a permissão Bloquear definida como Permitir.
  • Você deve ser o proprietário do espaço de trabalho ou ter a permissão global Administrar espaços de trabalho definida como 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 undelete comando.

Argumentos

Argumento Description
<item-specification> Identifica o arquivo ou pasta a ser restaurado. Para obter mais informações sobre como o TFVC analisa valores para determinar quais itens estão dentro do <item-specification> 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 /login opção. Você pode especificar esse valor como ou DOMAIN\<username><username>.

Opções

Opção

Descrição

/noget

Restaura o item excluído para seu espaço de trabalho. Aguardando 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 no disco.

/lock

Impede que outros usuários façam check-in ou check-out dos arquivos especificados. Para obter mais informações, consulte Compreender os tipos de bloqueio.

Opções de bloqueio:

  • None: Esta 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 de arquivos bloqueados até que você libere o bloqueio fazendo check-in dos arquivos bloqueados. Se outros usuários tiverem bloqueado qualquer um dos itens especificados, a operação de bloqueio falhará.
  • Checkout: Esta opção impede que outros usuários façam check-in ou check-out de qualquer um dos itens especificados até que você libere o bloqueio fazendo check-in dos 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.

Observações

O undelete comando do tf recurso de linha de comando 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 /noget opção.

Quando arquivos ou pastas com o mesmo nome foram excluídos da mesma pasta do servidor, você deve incluir um valor para o <deletion-ID> parâmetro para indicar quais dos itens excluídos você deseja restaurar. Você pode obter um <deletion-ID> usando o dir comando.

Se você quiser alterar um arquivo depois de restaurá-lo, verifique o arquivo para edição usando o checkout comando como de costume.

Quando seu <item-specification> valor 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, você deve primeiro cancelar a exclusão da pasta e seus itens e, em seguida, excluir os itens que você 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 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 espaço de trabalho 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 exemplo a seguir:

$/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 espaço de trabalho atual.

c:\projects>tf undelete 314.cs;X11