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

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) undo descarta uma ou mais alterações pendentes em arquivos ou pastas.

Pré-requisitos

Por padrão, os membros do grupo de Colaboradores do projeto têm permissões para contribuir com um repositório e usar o undo comando em seus próprios espaços de trabalho. Para desfazer alterações pendentes no espaço de trabalho de outro usuário, você deve ter a permissão Administrar espaços de trabalho definida como Permitir. Para obter mais informações, consulte Permissões TFVC padrão.

Sintaxe

tf undo [/workspace:<workspace-name>[;<workspace-owner>]]
[/recursive] <item-specification> [/noprompt] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>]

Parâmetros

Parâmetro

Description

/collection:<team-project-collection-url>

Especifica a URL da coleção de projetos que contém os itens, por exemplo, https://myserver:8080/tfs/DefaultCollection.

Se você não usar a /workspace opção, a coleção de projetos que contém o espaço de trabalho que mapeia o diretório atual será usada por padrão.

<item-specification>

Especifica o escopo dos itens. Você pode especificar mais de um <item-specification> argumento. Para obter sintaxe, consulte Usar comandos de controle de versão do Team Foundation.

/login

Especifica a conta de usuário a ser usada para executar o comando. Consulte Usar comandos de controle de versão do Team Foundation.

/noprompt

Suprime a exibição de janelas e caixas de diálogo e redireciona os dados de saída para o prompt de comando. Consulte Usar comandos de controle de versão do Team Foundation.

/recursive

Recursivamente desfaz alterações em itens no diretório especificado e em quaisquer subdiretórios.

/workspace <workspace-name>[;<workspace-owner>]

Especifica o nome do espaço de trabalho para desfazer alterações pendentes. Se não for especificado, o espaço de trabalho que mapeia o diretório atual será usado.

Você pode especificar <workspace-owner> para desfazer uma alteração pendente em um espaço de trabalho que pertence a um usuário específico. Se você não fornecer esse argumento, o espaço de trabalho de propriedade do usuário atual será usado por padrão. Mas se você fornecer o /login argumento com um nome de usuário, o espaço de trabalho que pertence a esse usuário será usado. Você deve ter a permissão DesfazerOutros definida como Permitir para desfazer alterações no espaço de trabalho de outro usuário.

Nota

Você pode usar o undo comando para desfazer uma alteração pendente em um espaço de trabalho remoto que ainda está em uso. Antes de continuar o trabalho nesse espaço de trabalho, um usuário deve entrar na máquina que hospeda o espaço de trabalho e obter os itens que são afetados pela operação de desfazer. Para obter mais informações sobre o get comando e seu /all argumento, consulte Obter comando.

Observações

Para cada item que tem uma alteração de edição pendente, o undo comando determina se o arquivo foi modificado no disco. Se o arquivo tiver sido modificado e a /noprompt opção não tiver sido especificada, o sistema solicitará que você confirme que deseja continuar. No teclado, selecione:

  • N para deixar a mudança no lugar.
  • Y para prosseguir apenas com a mudança atual.
  • A para prosseguir com este arquivo e quaisquer outros arquivos modificados que são detetados.

O undo comando remove todos os bloqueios nos itens especificados .

Exemplos

O comando a seguir remove as alterações pendentes no arquivo program.cs :

c:\code\SiteApp\Main\SolutionA\Project1>tf undo program.cs

O comando a seguir remove as alterações pendentes em todos os itens na pasta c:\code\SiteApp\Main e suas subpastas:

c:\code\SiteApp\Main>tf undo * /recursive

O comando a seguir remove as alterações pendentes no arquivo program.cs na coleção especificada e no espaço de trabalho remoto:

c:\>tf undo /collection:https://fabrikam-3:8080/tfs/DefaultCollection
/workspace:FABRIKAM-1;PatI $/SiteApp/Main/SolutionA/Project1/program.cs

Sugestões

  • Para exibir uma lista de alterações pendentes no espaço de trabalho atual ou em um espaço de trabalho remoto, use o status comando. Para obter mais informações, consulte Comando Status.
  • Você pode usar a /workspace opção e, conforme necessário, a /collection opção para desfazer alterações em uma máquina de desenvolvimento remoto. Esse recurso é especialmente útil nos casos em que foi feito check-out de um arquivo e, possivelmente, bloqueado em uma máquina de desenvolvimento que você não pode acessar. Para obter mais informações, consulte a explicação do /workspace argumento, anteriormente neste artigo.
  • Às vezes, você precisa limpar seu espaço de trabalho, por exemplo, quando seu trabalho é interrompido por uma tarefa mais urgente. Se quiser preservar as alterações pendentes em vez de desfazê-las, você pode suspendê-las usando o shelve comando. Para obter mais informações, consulte Comando Shelve. Você também pode preservar a posição de suas janelas abertas, pontos de interrupção e outras dicas importantes. Para obter mais informações, consulte Suspender seu trabalho e gerenciar seus conjuntos de prateleiras.
  • Além de desfazer alterações pendentes, você também pode descartar alterações que já foram verificadas. Para obter mais informações, consulte Comando Undelete e Comando Rollback (Controle de Versão do Team Foundation).