Comando Status (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) status o il relativo alias statvisualizza informazioni sulle modifiche in sospeso ai file e alle cartelle e ai candidati di modifica in sospeso in una o più aree di lavoro. Quando si usa l'opzione /shelveset , il comando visualizza le informazioni sulle modifiche in sospeso in un insieme di scaffali.

Nota

Un candidato di modifica in sospeso è un file nella cartella o nella sottocartella dell'area di lavoro che non viene aggiunta al controllo della versione. Per visualizzare tutti i candidati alle modifiche in sospeso in Visual Studio, passare a Team Explorer>Modifiche>in sospeso Escluse modifiche e quindi selezionare Rilevata.

Prerequisiti

Per usare il status comando, è necessario disporre dell'autorizzazione Lettura per l'elemento di origine e le autorizzazioni Estrazione e Unione per la cartella di destinazione impostata su Consenti. Per altre informazioni, vedere Autorizzazioni tfvc predefinite.

Sintassi

tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]] 
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]

Parametri

Argomenti

Argomento

Descrizione

/collection: <TeamProjectCollectionUrl>

Quando si usa l'opzione /workspace , specifica l'URL della raccolta di progetti che contiene l'area di lavoro che contiene le modifiche in sospeso. Ad esempio: http://myserver:8080/tfs/DefaultCollection.

Se non specificato, 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.

Ignorato se non si usa l'opzione /workspace .

Nota

Per le limitazioni di questa opzione, vedere la sezione Note .

/format

Specifica la quantità di dettagli da visualizzare per ogni modifica in sospeso:

  • Brief (impostazione predefinita): visualizza una riga su ogni modifica in sospeso che include: nome file, modifiche, se l'elemento è bloccato come indicato da un asterisco *, percorso locale e utente se si usano le /collection opzioni e /workspace . Alcuni dati potrebbero essere troncati.
  • Detailed: visualizza una descrizione completa di ogni modifica in sospeso. Oltre alle informazioni precedenti, questa opzione visualizza più dati, ad esempio data e ora.

<itemspec>

Specifica gli elementi per i quali si desiderano dati di modifica in sospeso. Per la sintassi, vedere Usare i comandi di controllo della versione di Team Foundation. È possibile specificare più itemspec argomenti.

/login

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

/recursive

Recupera in modo ricorsivo i dati sulle modifiche in sospeso agli elementi nella directory specificata ed eventuali sottodirectory.

/shelveset:<shelvesetname>[;<shelvesetowner>]

Specifica il set di scaffali che contiene le modifiche da elencare.

Questa opzione non può essere combinata con l'opzione /workspace .

/user

Elenca tutte le modifiche in sospeso apportate dall'utente specificato. Un asterisco * include i dati sulle modifiche di tutti gli utenti. Il valore predefinito è l'utente corrente.

Valori accettabili per questa opzione:

  • <username>
  • <useraccount>
  • Asterisco *

Nota

Per le limitazioni di questa opzione, vedere la sezione Note .

/workspace:<workspacename>[;<workspaceowner>]

Specifica il nome dell'area di lavoro che contiene le modifiche in sospeso. Se non specificato, l'area di lavoro è quella che esegue il mapping della directory corrente.

È possibile specificare workspaceowner di ottenere dati sulle modifiche in sospeso in un'area di lavoro appartenente a un utente specifico. Se non specificato, si presuppone che l'area di lavoro sia l'utente corrente o, se specificato, ./login:<username>

Questa opzione non può essere combinata con l'opzione /shelveset .

Nota

Per le limitazioni di questa opzione, vedere la sezione Note .

Osservazioni:

È possibile usare il status comando per visualizzare le modifiche in sospeso nell'area di lavoro corrente, ad esempio l'area di lavoro che esegue il mapping della directory corrente, indipendentemente dal fatto che si tratti di un'area di lavoro locale o di un'area di lavoro server. È anche possibile usare questo comando per visualizzare le modifiche in sospeso in un'area di lavoro del server remoto, ad esempio le modifiche apportate da un altro utente in un altro computer di sviluppo, usando le /collectionopzioni , /usere /workspace . Tuttavia, non è possibile visualizzare le modifiche in sospeso in un'area di lavoro locale remota.

Per altre informazioni, vedere Decidere tra l'uso di un'area di lavoro locale o server.

Esempi

In tutti gli esempi seguenti si presuppone che $/SiteApp/Main/ sia mappato a c:\code\SiteApp\Main\ nell'area di lavoro.

Elencare tutte le modifiche nell'area di lavoro corrente

Nell'esempio seguente vengono elencate tutte le modifiche in sospeso nell'area di lavoro:

c:\code\SiteApp\Main\SolutionA\>tf stat

Elencare tutte le modifiche in una cartella

Nell'esempio seguente vengono elencate tutte le modifiche in sospeso a tutti gli elementi nella cartella SolutionA :

c:\code\SiteApp\Main>tf stat SolutionA\*

Elencare tutte le modifiche in una cartella e nelle relative sottocartelle

Nell'esempio seguente vengono elencate le modifiche in sospeso a tutti gli elementi nella cartella SolutionA , incluse le modifiche nelle relative sottocartelle:

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

Passaggi successivi