Comando View (controllo della versione di Team Foundation)
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) view
recupera una versione specifica di un file, la archivia in una cartella temporanea nel computer e la visualizza.
Prerequisiti
Per usare il view
comando, è necessario disporre dell'autorizzazione Lettura impostata su Consenti. Per altre informazioni, vedere Autorizzazioni tfvc predefinite.
Sintassi
tf view [/collection:<team-project-collection-url>] [/console] [/recursive] [/output:<local-file>]
[/shelveset:<shelveset-name>[;<owner>]] [/noprompt] <item-spec>
[/version:<version-spec>] [/login:<username>,[<password>]]
Parametri
Le sezioni seguenti descrivono argomenti e opzioni del view
comando.
Argomenti
Argomento
Descrizione
<team-project-collection-url>
Fornisce l'URL della raccolta di progetti che contiene una versione specifica di un file che si desidera recuperare informazioni su, https://myserver:8080/tfs/DefaultCollection
ad esempio .
<shelveset-name> [:<owner>]
Identifica l'insieme di scaffali. L'argomento facoltativo <owner>
viene usato per specificare un set di scaffali non di proprietà dell'utente corrente.
<item-spec>
Identifica il file o la cartella da recuperare. Per altre informazioni su come TFVC analizza l'argomento <item-spec>
per determinare quali elementi si trovano nell'ambito, vedere Usare i comandi di controllo della versione di Team Foundation - Usare le opzioni per modificare il modo in cui un comando funziona.
Nota
È possibile specificare più <item-spec>
argomenti.
<version-spec>
Fornisce un valore come C3 per l'opzione /version
. Per altre informazioni su come TFVC analizza una specifica di versione per determinare quali elementi si trovano all'interno del relativo ambito, vedere Usare i comandi di controllo della versione di Team Foundation.
<username>
Fornisce un valore all'opzione /login
. È possibile specificare questo valore come DOMAIN\<username>
o <username>
.
<password>
Fornisce un valore all'opzione /login
.
<local-file>
Fornisce il percorso della cartella del file di output.
Opzioni
Opzione
Descrizione
/console
Specifica che l'output del file deve essere indirizzato alla console. Questa opzione è utile se si vuole scrivere il file su disco usando il reindirizzamento della console, ma usare un nome o un percorso diverso rispetto all'elemento con versione.
/recursive
Visualizza tutti gli elementi nella directory specificata e in tutte le sottodirectory.
/shelveset
Specifica il set di scaffali in base al nome.
/noprompt
Specifica che tfvc non deve richiedere prima di visualizzare ogni file quando si include un'espressione con caratteri jolly in un <item-spec>
argomento che corrisponde a più file.
/version
Specifica la versione del file da aprire per la visualizzazione. Se si omette questa opzione, view
recupera la versione più recente del server Azure DevOps.
/collection
Specifica la raccolta di progetti.
/login
Specifica il nome utente e la password per autenticare l'utente con Azure DevOps.
/output
Restituisce il file in una cartella locale anziché richiamare una shell di Windows per aprire il file.
Osservazioni:
Il view
comando dell'utilità della tf
riga di comando recupera una copia di sola lettura di un file dal server Azure DevOps, archivia il file in una cartella temporanea nel computer e visualizza il contenuto del file. A meno che non si specifichi una versione specifica, TFVC recupera la versione più recente del file dal server Azure DevOps.
Il view
comando non aggiunge file all'area di lavoro o li archivia. Per altre informazioni su come ottenere la versione del server Azure DevOps di un file ed estrarla, vedere Comandi Get e Checkout e Edit.
È possibile usare il difference
comando per visualizzare le differenze tra due versioni di un file. Per altre informazioni, vedere Comando Differenza.
Per altre informazioni su come usare l'utilità della tf
riga di comando, vedere Usare i comandi di controllo della versione di Team Foundation.
Opzioni di output
Per impostazione predefinita, tfvc visualizza il contenuto del file nel visualizzatore associato al tipo di file.
Se si include l'opzione
/console
, tfvc stampa il contenuto del file nella console dei comandi. Analogamente, se TFVC non riesce a individuare un visualizzatore per il tipo di file specificato, stampa il contenuto del file nella console dei comandi.È possibile reindirizzare il contenuto di un file all'output standard usando
|
o\>
. Questa opzione consente di salvare il file in un altro file o di passarlo a un altro programma per la post-elaborazione.
Esempi
Nell'esempio seguente viene visualizzata la versione più recente del file 314.cs:
c:\projects>tf view 314.cs
Nell'esempio seguente viene visualizzata la versione di 314.cs archiviata con il set di modifiche 1999:
c:\projects>tf view /version:C1999 314.cs
L'esempio seguente recupera la versione 5 di 314.cs e la scrive nel file 314.old:
c:\projects>tf view /version:5 314.cs > 314.old
Nell'esempio seguente viene visualizzata la versione più recente di ogni file che corrisponde all'espressione con caratteri jolly *.cs:
c:\projects>tf view *.cs