Comando Undo (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 undo no TFVC (Controle de Versão do Team Foundation) 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 comando undo em seus próprios workspaces. Para desfazer as alterações pendentes no workspace de outro usuário, você deve ter a permissão Administrar workspaces definida como Permitir. Para saber mais, confira Permissões padrão do TFVC.

Sintaxe

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

Parâmetros

Parâmetro

Descrição

/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 opção /workspace, a coleção de projetos que contém o workspace que mapeia o diretório atual será usada por padrão.

<item-specification>

Especifica o escopo dos itens. Você pode especificar mais de um argumento <item-specification>. Para obter sintaxe, consulte Usar comandosde 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

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

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

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

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

Observação

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

Comentários

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

  • N para deixar a alteração no lugar.
  • Y para continuar apenas com a alteração atual.
  • A para continuar com esse arquivo e todos os outros arquivos modificados detectados.

O comando undo remove todos osbloqueios 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 workspace remoto:

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

Dicas

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