Partilhar via

Comando Histórico

  • Artigo

Exibe o histórico de revisão de um ou mais arquivos ou pastas. Os dados são exibidos na janela Histórico ou, se a opção /noprompt estiver especificada, no prompt de comando.

Requisitos: consulte Referência de permissões para o Team Foundation Server.

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 o URL da coleção de projeto de equipe que contém os itens. Por exemplo: http://myserver:8080/tfs/DefaultCollection.

Por padrão, a coleção de projeto de equipe é presumida ser 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 opção /noprompt for especificada:

  • Brief (padrão): exibe uma linha sobre cada conjunto de alterações que inclui o número de identificação, as alterações feitas, o usuário que fez as alterações, a data, e o 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, esta opção exibe dados adicionais como a data com hora, itens alterados, anotações de check-in e avisos de política de check-in.

/itemmode

Você não pode combinar esta opção com a opção /slotmode. Consulte Matt Mitrik: Alterando o modo de slot no controle de versão do TFS 2010.

itemspec

Especifica os itens para os quais o histórico deve ser exibido. Para obter a sintaxe, consulte Referência de comandos de controle de versão do Team Foundation.

/noprompt

Esta opção:

  • Suprime a exibição de janelas e caixas de diálogo (como a janela Histórico) e redireciona dados de saída para o prompt de comando. Consulte Referência de 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 Referência de comandos de controle de versão do Team Foundation.

/recursive

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

/slotmode

Você não pode combinar esta opção com a opção /itemmode. Consulte Matt Mitrik: Alterando o modo de 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 uma das seguintes ordens:

  • Ascending: da revisão mais antiga para a mais recente.

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

Você deve usar a opção de /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 nas alterações de todos os usuários (padrão).

/version:versionspec

Especifica um dos seguintes limites nos dados do histórico:

  • A versão máxima

  • As versões mínima e máxima usando a sintaxe de intervalo ~.

O padrão é /version:W (a versão no espaço de trabalho).

Para obter a sintaxe, consulte Referência de comandos de controle de versão do Team Foundation.

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

Exemplos

Obter o histórico de um único arquivo

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

Exibe todas as alterações feitas em program.cs na janela Histórico.

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

Exibe todas as alterações feitas em program.cs na janela de prompt de comando. Por exemplo:

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

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

Exibe todas as alterações feitas em todos os itens na SoluçãoA (incluindo as que estiverem em subpastas) na janela Histórico.

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

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

Exibe as 5 últimas alterações feitas em todos os itens na SoluçãoA (incluindo as que estiverem em subpastas):

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

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

Exibe as alterações feitas em todos os itens na SoluçãoA (incluindo as que estiverem em subpastas) na versão 30 e anterior:

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

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

Exibe as alterações feitas em todos os itens na SoluçãoA (incluindo as que estiverem em subpastas) em 23/04/2012 ou antes:

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 o histórico da versão x para a versão y

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

Exibe as alterações feitas em todos os itens na SoluçãoA (incluindo as que estiverem em subpastas) entre 12/04/2012 e 23/04/2012:

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

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

Exibe detalhes sobre as alterações feitas em todos os itens na SoluçãoA (incluindo as que estiverem em subpastas) entre 12/04/2012 e 23/04/2012:

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

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

Exibe o histórico de pasta de SoluçãoA na janela Histórico, que permite explorar alterações anteriores feitas na pasta. Por exemplo, se a alteração mais recente na pasta foi uma renomeação, você poderá expandir o conjunto de alterações para ver alterações que ocorreram antes da renomeação.

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

Exibe a alteração mais recente feita na pasta SoluçãoA na janela de prompt de comando.

Trabalho no Visual Studio

Dicas

  • Dica Para obter mais informações sobre como usar a janela Histórico, consulte Obter o histórico de um item.

  • Dica Para obter informações mais detalhadas sobre um conjunto de alterações (por exemplo, você deseja ver itens de trabalho associados):

    • Na janela Histórico, clique duas vezes no conjunto de alterações ou abra o menu de contexto e escolha Detalhes do Conjunto de Alterações.

    • No prompt de comando, use Changeset Command.

  • Dica Para obter mais informações sobre conjuntos de alterações, consulte Localizar e exibir conjuntos de alterações.

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

  • Dica Consulte Exibir e gerenciar versões anteriores.