Comando History
Aggiornamento: novembre 2007
Visualizza la cronologia delle revisioni per uno o più file e cartelle.
Autorizzazioni necessarie
Per utilizzare il comando history, è necessario disporre dell'autorizzazione Lettura impostata su Consenti per tutti i file o le cartelle per le quali è richiesta la cronologia. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
tf history [/server:servername] itemspec [/version:versionspec]
[/stopafter:number] [/recursive] [/user:username]
[/format:(brief|detailed)] [/slotmode] [/noprompt]
Parametri
Argomento |
Descrizione |
---|---|
servername |
Valore fornito dall'utente per l'opzione /server. Esempio: teamfoundation2. |
itemspec |
Identifica il file o la cartella per cui visualizzare la cronologia. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation sui parametri itemspec per determinare gli elementi all'interno dell'ambito, vedere Opzioni della riga di comando. |
versionspec |
Fornisce un valore, ad esempio C58, per l'opzione /version. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation sulla specifica di una versione per determinare gli elementi all'interno dell'ambito, vedere Sintassi della riga di comando (Team System). |
number |
Specifica il numero di insiemi di modifiche da includere nella query relativa alla cronologia. |
username |
Fornisce un valore all'opzione /user. A seconda delle impostazioni di rete, è possibile specificare DOMINIO\nomeutente o nomeutente. |
Opzione |
Descrizione |
---|---|
/server |
Identifica Team Foundation Server. Questa opzione è necessaria se il comando viene richiamato da una directory che non è mappata a un'area di lavoro. |
/version |
Specifica la versione degli elementi per i quali visualizzare la cronologia delle revisioni. Per impostazione predefinita, in Team Foundation viene utilizzata la versione dell'area di lavoro. Non è possibile combinare questa opzione con l'opzione /slotmode. |
/stopafter |
Visualizza la cronologia per il number di insiemi di modifiche specificati. Specificando ad esempio /stopafter:10 verranno visualizzate le ultimi dieci modifiche apportate all'elemento specificato. |
/recursive |
Recupera le informazioni della cronologia relative a elementi in un percorso specificato. |
/user |
Filtra l'elenco delle modifiche in base all'utente denominato. Per selezionare tutti gli utenti, è possibile utilizzare un asterisco (*). Se non viene specificato, verranno selezionati tutti gli utenti. |
/format |
Specifica le descrizioni visualizzate per le informazioni della cronologia. L'opzione Brief consente di visualizzare una sola riga per ogni insieme di modifiche. L'opzione Detailed consente invece di visualizzare una descrizione completa dell'insieme di modifiche. Se non viene specificato, le descrizioni saranno brevi. |
/slotmode |
Visualizza la cronologia delle revisioni per tutti gli elementi che hanno occupato da sempre la posizione dello spazio dei nomi specificata. |
/noprompt |
Non vengono visualizzati prompt che richiedono l'input da parte dell'utente. |
Note
Il comando History consente di visualizzare la finestra Cronologia in cui sono disponibili i pulsanti relativi alle opzioni Dettagli, Visualizza e Confronta. Scegliere Dettagli per visualizzare i dettagli relativi all'insieme di modifiche, Visualizza per visualizzare versioni dei file e Confronta per confrontare le versioni del file con la versione corrente dell'area di lavoro se viene selezionata una sola riga oppure con due diverse versioni se vengono selezionate due righe. Dal menu di scelta rapida della finestra Cronologia, utilizzare l'opzione copy per copiare negli Appunti le informazioni di testo presenti nelle righe attualmente selezionate. Per ulteriori informazioni, vedere Informazioni sulla finestra Cronologia.
Utilizzare il comando history per visualizzare la cronologia delle revisioni per uno o più file e cartelle. Per ogni insieme di modifiche in cui sono stati inclusi gli elementi richiesti in Team Foundation verrà visualizzata una revisione nell'output dell'insieme di modifiche. I dettagli dell'insieme di modifiche includono informazioni sull'utente che ha eseguito il commit della modifica nel server Controllo della versione di Team Foundation, i file e le cartelle di cui è stato eseguito il commit delle modifiche in sospeso, il tipo della modifica in sospeso di cui è stato eseguito il commit, il numero dell'insieme di modifiche e la data e l'ora di creazione dell'insieme di modifiche.
Se non viene specificato alcun valore per specversione, in Team Foundation viene visualizzata la cronologia completa del file o della cartella. Quando viene specificata una singola versione, in Team Foundation vengono visualizzate informazioni sull'elemento da tale versione fino alla versione 1. Se viene specificato un intervallo di versioni utilizzando la sintassi ~ , verrà invece visualizzata la cronologia di tali versioni e di tutte le versioni tra esse comprese. È possibile specificare un intervallo in ordine crescente o decrescente.
Se si include l'opzione /slotmode, in Team Foundation viene visualizzata la cronologia revisioni per l'elemento specificato. Ad esempio, se è stato rinominato un file, questa opzione mostra il nome precedente e il nuovo. . Poiché l'opzione /slotmode consente di specificare un intervallo di elementi e versioni diverse, è consigliabile non combinare le opzioni /slotmode e /version.
Utilizzare il comando history per determinare il numero dell'insieme di modifiche in cui è stato eseguito il commit di un set di file, quindi il comando Changeset per visualizzare ulteriori informazioni dettagliate sulla natura dell'insieme di modifiche e sull'operazione di archiviazione in cui è stato creato. In alternativa, nella finestra Cronologia è possibile selezionare una riga, quindi fare clic sul pulsante Dettagli.
Per i collegamenti agli altri comandi di Team Foundation che forniscono ulteriori informazioni sugli elementi disponibili sul server Controllo della versione di Team Foundation e su tutte le aree di lavoro mappate ad esso, vedere Comandi di carattere informativo.
Per ulteriori informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.
Esempi
L'esempio riportato di seguito consente di visualizzare le modifiche apportate al file 1256.c tra la versione 5 e la versione 8 dell'insieme di modifiche.
c:\projects> tf history /version:C5~C8 1256.c
L'esempio riportato di seguito consente di visualizzare le ultime dieci modifiche apportate al file 314.cs.
c:\projects> tf history /stopafter:10 314.cs
L'esempio riportato di seguito consente di visualizzare la cronologia formattata per l'output dettagliato della posizione dello spazio dei nomi di 1256.c.
c:\projects> tf history /format:detailed/slotmode 1256.c
Vedere anche
Concetti
Utilizzo degli insiemi di modifiche per il controllo della versione
Comandi di carattere informativo
Riferimenti
Sintassi della riga di comando (Team System)
Altre risorse
Comandi dell'utilità della riga di comando Tf