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 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 /collection
opzioni , /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 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
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 le aree di lavoro.
È possibile usare il comando Differenza per ottenere informazioni dettagliate sulle modifiche apportate alle modifiche 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