Condividi tramite

Comando Cronologia (controllo della versione di Team Foundation)

  • Articolo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Il comando controllo della versione di Team Foundation (TFVC) tf history visualizza la cronologia delle revisioni di uno o più file o cartelle. I dati del comando vengono visualizzati nella finestra Cronologia in Visual Studio o, se l'opzione /noprompt è specificata, al prompt dei comandi.

È anche possibile usare Visual Studio per ottenere la cronologia delle revisioni. Per altre informazioni, vedere Ottenere la cronologia di un elemento.

Prerequisiti

Vedere Autorizzazioni tfvc predefinite.

Sintassi

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]

Parametri

Parametro

Descrizione

/collection:<TeamProjectCollectionUrl>

Specifica l'URL della raccolta di progetti che contiene gli elementi. Ad esempio: http://myserver:8080/tfs/DefaultCollection.

Per impostazione predefinita, si presuppone che la raccolta di progetti sia quella che contiene l'area di lavoro che esegue il mapping della directory corrente.

/format

Specifica il livello di dettaglio da visualizzare per ogni insieme di modifiche quando viene specificata l'opzione /noprompt :

  • Brief (impostazione predefinita): visualizza una riga su ogni insieme di modifiche che include: numero ID, modifiche apportate, utente che ha apportato le modifiche, la data e il commento. Alcuni dati possono essere troncati.

  • Detailed: visualizza una descrizione completa di ogni insieme di modifiche. Oltre alle informazioni precedenti, questa opzione visualizza più dati, ad esempio data con ora, elementi modificati, note di archiviazione e avvisi dei criteri di archiviazione.

/itemmode

Non è possibile combinare questa opzione con l'opzione /slotmode . Per altre informazioni, vedere Matt Mitrik: Passaggio alla modalità slot nel controllo della versione di TFS 2010.

<itemspec>

Specifica gli elementi per i quali visualizzare la cronologia. Per la sintassi, vedere Usare i comandi di controllo della versione di Team Foundation.

/noprompt

Elimina la visualizzazione di finestre e finestre di dialogo, ad esempio la finestra Cronologia , e reindirizza i dati di output al prompt dei comandi. Vedere Usare i comandi di controllo della versione di Team Foundation.

Non visualizza la cronologia delle revisioni che si sono verificate prima dello spostamento, ridenominazione, creazione di rami o unione di un elemento.

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

Specifica l'account utente per eseguire il comando. Vedere Usare i comandi di controllo della versione di Team Foundation.

/recursive

Recupera in modo ricorsivo i dati cronologici sugli elementi nella directory specificata ed eventuali sottodirectory.

/slotmode

Non è possibile combinare questa opzione con l'opzione /itemmode . Per altre informazioni, vedere Matt Mitrik: Passaggio alla modalità slot nel controllo della versione di TFS 2010.

/sort

Ordina la cronologia delle revisioni per uno o più file o cartelle in uno degli ordini seguenti:

  • Ascending: dal meno recente alla revisione più recente.

  • Descending (impostazione predefinita): dalla revisione più recente alla revisione meno recente.

È necessario usare l'opzione /noprompt con questa opzione.

/stopafter:<number>

Specifica il numero massimo di insiemi di modifiche da visualizzare nei dati della cronologia.

/user:<username>

Filtra i dati cronologici per visualizzare le modifiche apportate dall'utente specificato. Un simbolo asterisco (*) include i dati sulle modifiche di tutti gli utenti, ovvero l'impostazione predefinita.

/version:<versionspec>

Specifica la versione massima o le versioni minime e massime usando la sintassi dell'intervallo ~ . Il valore predefinito è /version:W, la versione nell'area di lavoro.

Non è possibile combinare questa opzione con l'opzione /slotmode .

Per la sintassi, vedere Usare i comandi di controllo della versione di Team Foundation.

Osservazioni:

  • Per ottenere informazioni più dettagliate su un insieme di modifiche, ad esempio per visualizzare gli elementi di lavoro associati:

    • Nella finestra Cronologia di Visual Studio fare doppio clic o fare clic con il pulsante destro del mouse sul set di modifiche e scegliere Dettagli set di modifiche.

    • Dal prompt dei comandi usare il comando Changeset.

  • L'opzione /collection è utile per eseguire questo comando da un computer e un account utente che non dispone di un'area di lavoro mappata alla raccolta di progetti che contiene gli elementi.

Esempi

Gli esempi seguenti presuppongono che c:\code\SiteApp\Main sia mappato alla cartella principale nell'area di lavoro.

Ottenere la cronologia di un singolo file

Nell'esempio seguente vengono visualizzate tutte le modifiche apportate a program2.cs nella finestra Cronologia .

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

Nell'esempio seguente vengono visualizzate tutte le modifiche apportate a program2.cs nella finestra del prompt dei comandi.

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

Output:

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

Ottenere la cronologia di tutti gli elementi in una cartella

Nell'esempio seguente vengono visualizzate tutte le modifiche apportate a tutti gli elementi di SolutionA, inclusi quelli nelle sottocartelle, nella finestra Cronologia .

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

Ottenere la cronologia delle ultime cinque modifiche a tutti gli elementi di una cartella

Nell'esempio seguente vengono visualizzate le cinque modifiche più recenti apportate agli elementi in SolutionA, incluse quelle nelle sottocartelle, nella finestra del prompt dei comandi:

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

Output:

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

Ottenere la cronologia dalla versione x e precedenti

Nell'esempio seguente vengono visualizzate le modifiche apportate a tutti gli elementi in SolutionA, inclusi quelli nelle sottocartelle, nella versione 30 e precedenti, nella finestra del prompt dei comandi:

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

Output:

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

Ottenere la cronologia dalla data D e versioni precedenti

Negli esempi seguenti vengono visualizzate le modifiche apportate a tutti gli elementi in SolutionA, inclusi quelli nelle sottocartelle, il 4/23/12 o versioni precedenti, nella finestra del prompt dei comandi:

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

Oppure:

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

Output:

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

Ottenere la cronologia da un intervallo di date

Nell'esempio seguente vengono visualizzate le modifiche apportate a tutti gli elementi in SolutionA, inclusi quelli nelle sottocartelle, tra il 4/12/2012 e il 23/4/2012, nella finestra del prompt dei comandi:

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

Output:

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

Ottenere la cronologia dettagliata

Nell'esempio seguente vengono visualizzati i dettagli sulle modifiche apportate a tutti gli elementi di SolutionA, inclusi quelli nelle sottocartelle, tra il 4/12/2012 e il 23/4/2012, nella finestra del prompt dei comandi:

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

Output:

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

Ottenere la cronologia non ricorsiva di una cartella

Nell'esempio seguente viene visualizzata la cronologia della cartella SolutionA nella finestra Cronologia di Visual Studio, che consente di esplorare le modifiche precedenti alla cartella. Ad esempio, se la modifica più recente alla cartella è stata rinominata, è possibile espandere il set di modifiche per visualizzare le modifiche apportate prima della ridenominazione.

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

Nell'esempio seguente viene visualizzata la modifica più recente alla cartella SolutionA nella finestra del prompt dei comandi.

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