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