Compartilhar via

Comando Histórico (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) tf history exibe o histórico de revisão de um ou mais arquivos ou pastas. Os dados de comando são exibidos na janela Histórico no Visual Studio ou se a opção /noprompt for especificada, no prompt de comando.

Você também pode usar o Visual Studio para obter o histórico de revisão. Para obter mais informações, consulte Obter o histórico de um item.

Pré-requisitos

Consulte permissões TFVC padrão.

Sintaxe

tf hist[ory] itemspec [/version:versionspec] 
[/stopafter:number] [/recursive] [/user:username] 
[/format:(brief|detailed)] [/slotmode] [/itemmode] [/noprompt]
[/login:username,[password]] [/sort:ascending,descending]
[/collection:TeamProjectCollectionUrl]

Parâmetros

Parâmetro

Descrição

/collection:<TeamProjectCollectionUrl>

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

Por padrão, presume-se que a coleção de projetos seja aquela que contém o workspace que mapeia o diretório atual.

/format

Especifica quantos detalhes exibir sobre cada conjunto de alterações quando a opção /noprompt for especificada:

  • Brief (padrão): exibe uma linha sobre cada conjunto de alterações que inclui: número de ID, alterações feitas, usuário que fez as alterações, data e comentário. Alguns dos dados podem ser truncados.

  • Detailed: exibe uma descrição completa de cada conjunto de alterações. Além das informações anteriores, essa opção exibe mais dados, como data com hora, itens alterados, anotações de check-in e avisos de política de check-in.

/itemmode

Você não pode combinar essa opção com a opção /slotmode. Para obter mais informações, consulte Matt Mitrik: Alterando para o modo slot no controle de versão do TFS 2010.

<itemspec>

Especifica os itens para os quais exibir o histórico. Para obter sintaxe, consulte Usar comandos de controle de versão do Team Foundation.

/noprompt

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

Não exibe o histórico de revisões que ocorreram antes de um item ser movido, renomeado, ramificado ou mesclado.

/login:<username>[,<password>]

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

/recursive

Recupera recursivamente dados históricos em itens no diretório especificado e em quaisquer subdiretórios.

/slotmode

Você não pode combinar essa opção com a opção /itemmode. Para obter mais informações, consulte Matt Mitrik: Alterando para o modo slot no controle de versão do TFS 2010.

/sort

Classifica o histórico de revisão de um ou mais arquivos ou pastas em qualquer um dos seguintes pedidos:

  • Ascending: do mais antigo à revisão mais recente.

  • Descending (padrão): da revisão mais recente à mais antiga.

Você deve usar a opção /noprompt com essa opção.

/stopafter:<number>

Especifica o número máximo de conjuntos de alterações a serem exibidos nos dados do histórico.

/user:<username>

Filtra os dados históricos para mostrar as alterações feitas pelo usuário especificado. Um símbolo de asterisco (*) inclui dados sobre alterações de todos os usuários, o padrão.

/version:<versionspec>

Especifica a versão máxima ou as versões mínima e máxima usando o intervalo ~ sintaxe. O padrão é /version:W, a versão no workspace.

Você não pode combinar essa opção com a opção /slotmode.

Para obter sintaxe, consulte Usar comandos de controle de versão do Team Foundation.

Observações

  • Para obter informações mais detalhadas sobre um conjunto de alterações, por exemplo, para ver itens de trabalho associados:

    • Na janela histórico do Visual Studio, clique duas vezes ou clique com o botão direito do mouse no conjunto de alterações e escolha Detalhes do Conjunto de Alterações.

    • No prompt de comando, use o comando Changeset.

  • A opção /collection é útil para executar esse comando de uma conta de computador e de usuário que não tem um workspace mapeado para a coleção de projetos que contém os itens.

Exemplos

Os exemplos a seguir pressupõem que c:\code\SiteApp\Main mapeia para a pasta principal no workspace.

Obter o histórico de um único arquivo

O exemplo a seguir exibe todas as alterações feitas em program2.cs na janela histórico de.

c:\code\SiteApp\Main\SolutionA\Project1>tf history program2.cs

O exemplo a seguir exibe todas as alterações feitas em program2.cs na janela do prompt de comando.

c:\code\SiteApp\Main\SolutionA\Project1>tf history program2.cs /noprompt

Saída:

Changeset Change                     User              Date       Comment
--------- -------------------------- ----------------- ---------- -------- 
29        edit                       Jamal Hartnett    4/23/2012  Fix bug
20        add                        Raisa Pokrovskaya 4/12/2012  Add new

Obter o histórico de todos os itens em uma pasta

O exemplo a seguir exibe todas as alterações feitas em todos os itens em SolutionA, incluindo aqueles em subpastas, na janela histórico de.

c:\code\SiteApp\Main\SolutionA>tf history * /recursive

Obter o histórico das últimas cinco alterações em todos os itens em uma pasta

O exemplo a seguir exibe as cinco alterações mais recentes feitas em itens em SolutionA, incluindo as de subpastas, na janela do prompt de comando:

c:\code\SiteApp\Main\SolutionA>tf history * /noprompt /recursive /stopafter:5

Saída:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
31        Raisa Pokrovskaya 5/15/2012
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to Proje
15        Raisa Pokrovskaya 4/8/2012

Obter histórico da versão x e anterior

O exemplo a seguir exibe as alterações feitas em todos os itens em SolutionA, incluindo aqueles em subpastas, na versão 30 e anterior, na janela do prompt de comando:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:30

Saída:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to 
15        Raisa Pokrovskaya 4/8/2012

Obter histórico da data D e anterior

Os exemplos a seguir exibem alterações feitas em todos os itens em SolutionA, incluindo aqueles em subpastas, em 23/4/12 ou anterior, na janela do prompt de comando:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/24/2012

Ou:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D2012-04-24T12:00

Saída:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to 15        Raisa Pokrovskaya 4/8/2012

Obter histórico de uma variedade de datas

O exemplo a seguir exibe alterações feitas em todos os itens no SolutionA, incluindo aqueles em subpastas, entre 12/4/2012 e 23/04/2012, na janela do prompt de comando:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012

Saída:

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to

Obter histórico detalhado

O exemplo a seguir exibe detalhes sobre as alterações feitas em todos os itens no SolutionA, incluindo aqueles em subpastas, entre 12/4/2012 e 23/4/2012, na janela do prompt de comando:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012 /format:detailed

Saída:

-------------------------------------------------------------------------------
Changeset: 30
User: Raisa Pokrovskaya (Fabrikam)
Date: Monday, April 23, 2012 1:23:05 PM

Comment:
  Much better name for this file

Items:
  rename                $/SiteApp/Main/SolutionA/Project1/programBig.cs
  delete, source rename $/SiteApp/Main/SolutionA/Project1/program3.cs;X15

-------------------------------------------------------------------------------
Changeset: 29
User: Raisa Pokrovskaya (Fabrikam)
Date: Monday, April 23, 2012 1:03:13 PM

Comment:
  Fix bug in new method

Items:
  edit $/SiteApp/Main/SolutionA/Project1/program1.cs
  edit $/SiteApp/Main/SolutionA/Project1/program2.cs

-------------------------------------------------------------------------------
Changeset: 20
User: Raisa Pokrovskaya (Fabrikam)
Date: Thursday, April 12, 2012 5:09:35 PM

Comment:
  Add new method, add program2.cs to Project1

Items:
  add $/SiteApp/Main/SolutionA/Project1/program2.cs

Check-in Notes:
  Documentation:
    An important new part of our codebase.

Policy Warnings:
  Override Reason:
    Jamal agrees with me that we can bypass for this check-in.
  Messages:
    The Code Analysis Policy requires files to be checked in through Visual
Studio with an open solution.

Obter o histórico não recursivo de uma pasta

O exemplo a seguir exibe o histórico da pasta SolutionA na janela histórico do Visual Studio, que permite explorar alterações anteriores na pasta. Por exemplo, se a alteração mais recente na pasta for renomeada, você poderá expandir o conjunto de alterações para ver as alterações que ocorreram antes da renomeação.

c:\code\SiteApp\Main\SolutionA>tf history .

O exemplo a seguir exibe a alteração mais recente na pasta SolutionA na janela do prompt de comando.

c:\code\SiteApp\Main\SolutionA>tf history . /noprompt