Condividi tramite


Comando History

Visualizza la cronologia delle revisioni di uno o più file o cartelle. I dati vengono visualizzati nella finestra Cronologia o nel prompt dei comandi, se è stata specificata l'opzione /noprompt.

Requisiti: vedere Riferimento alle autorizzazioni per 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]

Parametri

Parametro

Descrizione

/collection: TeamProjectCollectionUrl

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

Per impostazione predefinita, si presuppone che la raccolta di progetti team sia l'unica che contiene l'area di lavoro di cui è stato eseguito il mapping alla directory corrente.

/format

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

  • Brief (impostazione predefinita): visualizza una riga per ogni insieme di modifiche che include: numero ID, modifiche apportate, utente che ha effettuato le modifiche, data e commento. Alcuni dati potrebbero essere troncati.

  • Detailed: visualizza una descrizione completa di ogni insieme di modifiche. In aggiunta alle informazioni sopra riportate, questa opzione consente di visualizzare ulteriori dati, ad esempio data e ora, elementi modificati, note di archiviazione e avvisi dei criteri di archiviazione.

/itemmode

Non è possibile combinare questa opzione con l'opzione /slotmode. Vedere Matt Mitrik: Passare alla modalità Slot nel controllo della versione di TFS 2010.

itemspec

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

/noprompt

Questa opzione:

  • Evita la visualizzazione delle finestre e delle finestre di dialogo (come ad esempio la finestra Cronologia) e reindirizza i dati di output al prompt dei comandi. Vedere Riferimenti ai comandi del controllo della versione di Team Foundation.

  • Non visualizza la cronologia delle revisioni eseguite prima dello spostamento, della ridenominazione, del branching o del merge di un elemento.

/login:username,[password]

Specifica l'account utente per l'esecuzione del comando. Vedere Riferimenti ai comandi del controllo della versione di Team Foundation.

/recursive

Recupera in modo ricorsivo i dati cronologici degli elementi nella directory specificata e in tutte le sottodirectory.

/slotmode

Non è possibile combinare questa opzione con l'opzione /itemmode. Vedere Matt Mitrik: Passare 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 dei seguenti ordini:

  • Ascending: dalla revisione meno recente a quella più recente.

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

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

/stopafter:number

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

/user:username

Filtra i dati cronologici per visualizzare le modifiche apportate dall'utente specificato. Un asterisco (*) include i dati sulle modifiche effettuate da tutti gli utenti (impostazione predefinita).

/version:versionspec

Specifica uno dei seguenti limiti per i dati di cronologia:

  • Versione massima

  • Versione minima e massima utilizzando la sintassi dell'intervallo ~.

L'impostazione predefinita è /version:W (la versione nell'area di lavoro).

Per la sintassi, vedere Riferimenti ai comandi del controllo della versione di Team Foundation.

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

Esempi

Ottenere la cronologia di un singolo file

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

Visualizza tutte le modifiche apportate a program.cs nella finestra Cronologia.

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

Visualizza tutte le modifiche apportate a program.cs nella finestra del prompt dei comandi. Ad esempio:

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 di una cartella

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

Visualizza tutte le modifiche apportate a tutti gli elementi in SolutionA (comprese quelle presenti nelle sottocartelle) nella finestra Cronologia.

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

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

Visualizza le ultime 5 modifiche apportate agli elementi in SolutionA (comprese quelle presenti nelle sottocartelle):

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 dalle versioni precedenti

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

Visualizza le modifiche apportate a tutti gli elementi in SolutionA (comprese quelle presenti nelle sottocartelle) nella versione 30 e nelle versioni precedenti:

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 a partire dalla data D e in precedenza

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

Visualizza le modifiche apportate a tutti gli elementi in SolutionA (comprese quelle presenti nelle sottocartelle) il 23/4/12 o in precedenza:

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 versione x alla versione y

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

Visualizza le modifiche apportate a tutti gli elementi in SolutionA (comprese quelle presenti nelle sottocartelle) tra il 12/4/2012 e il 23/4/12:

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

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

Visualizza i dettagli sulle modifiche apportate a tutti gli elementi in SolutionA (compresi quelli presenti nelle sottocartelle) tra il 12/4/2012 e il 23/4/12:

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

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

Visualizza la cronologia della cartella SolutionA nella finestra Cronologia, che consente di esplorare le modifiche precedenti effettuate alla cartella. Ad esempio, se la modifica più recente alla cartella è una ridenominazione, è possibile espandere l'insieme di modifiche per visualizzare le modifiche apportate prima della ridenominazione.

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

Visualizza la modifica più recente apportata alla cartella SolutionA nella finestra del prompt dei comandi.

Utilizzo di Visual Studio

Suggerimenti

  • Suggerimento Per informazioni su come utilizzare la finestra Cronologia, vedere Ottenere la cronologia di un elemento.

  • Suggerimento Per ottenere ulteriori informazioni su un insieme di modifiche (ad esempio, se si desidera visualizzare gli elementi di lavoro associati):

    • Nella finestra Cronologia fare doppio clic sull'insieme di modifiche oppure aprire il menu di scelta rapida e scegliere Dettagli insieme di modifiche.

    • Dal prompt dei comandi utilizzare Changeset Command.

  • Suggerimento Per ulteriori informazioni sugli insiemi di modifiche, vedere Trovare e visualizzare insiemi di modifiche.

  • Suggerimento L'opzione /collection è utile per eseguire questo comando da un computer e da un account utente che non dispone di un'area di lavoro di cui è stato eseguito il mapping alla raccolta di progetti team contenente gli elementi.

  • Suggerimento Vedere Visualizzare e gestire le versioni precedenti.