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 stat
, visualizza 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 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>modifiche esclusee quindi selezionare Rilevata.
Prerequisiti
Per usare il comando
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
Vedere osservazioni per le limitazioni di questa opzione.
/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 opzioni di/collection
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ù di un argomento itemspec
.
/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 dati sulle modifiche di tutti gli utenti. Il valore predefinito è l'utente corrente.
Valori accettabili per questa opzione:
<username>
<useraccount>
- Asterisco
*
Nota
Vedere osservazioni per le limitazioni di questa opzione.
/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
per 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, il /login:<username>
.
Questa opzione non può essere combinata con l'opzione /shelveset
.
Nota
Vedere osservazioni per le limitazioni di questa opzione.
Osservazioni
È possibile usare il comando status
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 opzioni /collection
, /user
e /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 un'area di lavoro server.
Esempi
In tutti gli esempi seguenti si supponga 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 della cartella SolutionA
c:\code\SiteApp\Main>tf stat SolutionA\* /recursive
Passaggi successivi
La maggior parte delle modifiche apportate ai file nel controllo della versione viene accodata come modifiche in sospeso nell'area di lavoro. Per altre informazioni, vedere Sviluppare codice e gestire le modifiche in sospeso e Creare e usare aree di lavoro.
È possibile usare il comando differenza per ottenere informazioni dettagliate sulle modifiche apportate o sulle modifiche apportate al contenuto in un file.
Se è necessario riservare le modifiche e, ad esempio, si vuole pulire l'area di lavoro per un'altra attività, usare il comando Shelve. Per altre informazioni sui set di scaffali, vedere Sospendere il lavoro e gestire gli scaffali.
Quando si è pronti per archiviare le modifiche apportate al server, usare il comando Checkin.
Per altre informazioni su come usare l'utilità
tf
, vedere Usare i comandi di controllo della versione di Team Foundation