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

Você também pode usar o Visual Studio para obter o histórico de revisões. 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 espaço de trabalho que mapeia o diretório atual.

/format

Especifica a quantidade de detalhes a serem exibidos sobre cada conjunto de alterações quando a /noprompt opção é 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 estar 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, notas de check-in e avisos de política de check-in.

/itemmode

Não é possível combinar esta opção com a /slotmode opção. Para obter mais informações, consulte Matt Mitrik: Mudando para o modo de 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 sobre itens no diretório especificado e quaisquer subdiretórios.

/slotmode

Não é possível combinar esta opção com a /itemmode opção. Para obter mais informações, consulte Matt Mitrik: Mudando para o modo de slot no controle de versão do TFS 2010.

/sort

Classifica o histórico de revisões de um ou mais arquivos ou pastas em uma das seguintes ordens:

  • Ascending: Da revisão mais antiga à mais recente.

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

Você deve usar a /noprompt opção com esta 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 a sintaxe do intervalo ~ . O padrão é /version:W, a versão no espaço de trabalho.

Não é possível combinar esta opção com a /slotmode opção.

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 /collection opção é útil para executar esse comando a partir de uma máquina e conta de usuário que não tem um espaço de trabalho 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 espaço de trabalho.

Obter histórico de um único arquivo

O exemplo a seguir exibe todas as alterações feitas no program2.cs na janela Histórico.

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

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

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

Resultado:

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

Obter 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 .

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

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

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

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

Resultado:

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 anteriores, na janela do prompt de comando:

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

Resultado:

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 anteriores

Os exemplos a seguir exibem as alterações feitas em todos os itens na SolutionA, incluindo aqueles em subpastas, em 23/04/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

Resultado:

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

Obtenha o histórico de várias datas

O exemplo a seguir exibe as alterações feitas em todos os itens na SolutionA, incluindo aqueles em subpastas, entre 12/04/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

Resultado:

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

Obtenha um histórico detalhado

O exemplo a seguir exibe detalhes sobre as alterações feitas em todos os itens na SolutionA, incluindo aqueles em subpastas, entre 12/04/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 /format:detailed

Resultado:

-------------------------------------------------------------------------------
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 foi uma renomeação, você pode 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