Comando Status
Aggiornamento: novembre 2007
Visualizza informazioni sulle modifiche in sospeso da apportare agli elementi in una o più aree di lavoro.
Autorizzazioni necessarie
Per utilizzare il comando status, è necessario disporre dell'autorizzazione Lettura impostata su Consenti per tutti i file o le cartelle specificate. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
tf status itemspec [/server:servername] [/workspace:workspacename[;workspaceowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
tf status itemspec [/server:servername] [/shelveset:shelvesetname[;shelvesetowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
Parametri
Argomento |
Descrizione |
|---|---|
itemspec |
Identifica il file o la cartella per cui visualizzare i dettagli sullo stato. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation sui parametri itemspec per determinare gli elementi all'interno dell'ambito, vedere Sintassi della riga di comando (Team System). |
servername |
Valore fornito dall'utente per l'opzione /server. Esempio: http://teamfoundation2:8080. |
workspacename |
Valore fornito dall'utente per l'opzione /workspace. |
workspaceowner |
Indica il nome dell'utente che ha creato l'area di lavoro. |
shelvesetname |
Valore fornito dall'utente per l'opzione /shelveset. |
shelvesetowner |
Indica il nome del proprietario dell'area di sospensione. |
username |
Fornisce un valore all'opzione /user. Un valore username può essere espresso in due modi, a seconda delle impostazioni di rete: DOMINIO\nomeutente o nomeutente. |
Opzione |
Descrizione |
|---|---|
/server |
Identifica Team Foundation Server. Questa opzione è necessaria se il comando viene richiamato da una directory che non è mappata a un'area di lavoro. |
/workspace |
Indica il nome dell'area di lavoro per cui visualizzare un elenco di modifiche. Se questa opzione non viene specificata e il comando viene eseguito da una directory che è stata aggiunta a un'area di lavoro, verrà utilizzata l'area di lavoro corrente. Non è possibile combinare questa opzione con /shelveset. |
/shelveset |
Nome dell'area di sospensione per cui visualizzare un elenco di modifiche. Non è possibile combinare questa opzione con /workspace. |
/format |
Formato delle informazioni sullo stato. Il formato Brief consente di visualizzare un elenco di modifiche e le modifiche che sono state apportate con l'archiviazione in sospeso, mentre Detailed consente di visualizzare informazioni complete sullo stato. Brief è il valore predefinito. |
/recursive |
Visualizza le informazioni sullo stato per tutti gli elementi nella directory specifica e nelle eventuali sottodirectory. |
/user |
Filtra l'elenco delle modifiche in base all'utente denominato. Per rappresentare tutti gli utenti, è possibile utilizzare un asterisco (*). Il valore predefinito è l'utente corrente. |
Note
È possibile utilizzare il comando status per visualizzare un elenco di modifiche in sospeso. Una modifica in sospeso corrisponde a una revisione di un file o di una cartella che non è stata inviata al server né inserita in un insieme di modifiche con versione. Per ulteriori informazioni, vedere Modifiche in sospeso.
È inoltre possibile specificare l'opzione /shelveset per visualizzare i dettagli sulle modifiche sospese senza versione che costituiscono un'area di sospensione. Per ulteriori informazioni sulla differenza tra le modifiche in sospeso e le modifiche sospese, vedere Utilizzo delle aree di sospensione per il controllo della versione.
Per i collegamenti agli altri comandi di Team Foundation che forniscono ulteriori informazioni sugli elementi disponibili sul server e su tutte le aree di lavoro mappate ad esso, vedere Comandi di carattere informativo.
Per ulteriori informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.
Output del comando
Se il tipo di modifica in sospeso è rename, viene visualizzato il nuovo nome. Per ulteriori informazioni, vedere Comando Rename (controllo della versione di Team Foundation).
Sono disponibili due modalità di visualizzazione: brief e detailed.
La modalità /Format:brief consente di visualizzare il nome file dell'elemento, il percorso locale, se l'elemento è bloccato, il tipo di modifica in sospeso che rappresenta, l'utente che ha apportato la modifica e il percorso su disco della versione dell'area di lavoro dell'elemento. L'output viene ordinato dapprima in base alla cartella, quindi al nome file nella cartella.
La modalità /Format:detailed consente di visualizzare diverse righe di informazioni su ciascuna modifica in sospeso nell'output. L'output dettagliato include tutto quanto compreso nell'output di tipo brief con l'aggiunta della data, dell'ora e di altre informazioni.
Esempi
L'esempio riportato di seguito consente di visualizzare informazioni su tutte le modifiche in sospeso per l'utente corrente nell'area di lavoro corrente. L'area di lavoro corrente è quella cui è mappata la directory locale.
c:\projects>tf status
L'esempio riportato di seguito consente di visualizzare tutte le modifiche in sospeso per l'utente corrente nel percorso d:\src sul computer corrente.
c:\projects>tf status/recursive d:\src
L'esempio riportato di seguito consente di visualizzare tutte le modifiche in sospeso per l'utente corrente nell'area di lavoro Beta1.
c:\projects>tf status/workspace:Beta1
L'esempio riportato di seguito consente di visualizzare informazioni sullo stato per tutte le modifiche in sospeso per l'utente Jason.
c:\projects>tf status/user:Jason
L'esempio riportato di seguito consente di visualizzare informazioni sullo stato per tutte le modifiche in sospeso per tutti gli utenti, in tutte le aree di lavoro disponibili sul server.
c:\projects>tf status/user:*
L'esempio riportato di seguito consente di visualizzare informazioni su tutte le modifiche in sospeso per l'utente corrente in tutte le aree di lavoro disponibili sul server situato in teamserver2.
c:\projects>tf status/server:teamserver2 /workspace:*
L'esempio riportato di seguito consente di visualizzare informazioni su tutte le modifiche effettuate ma non archiviate dall'utente Joe, in tutte le aree di lavoro mappate al server teamserver2.
c:\projects>tf status/server:teamserver2 /workspace:* /user:joe
Vedere anche
Concetti
Utilizzo delle aree di lavoro per il controllo della versione
Utilizzo degli insiemi di modifiche per il controllo della versione
Utilizzo delle aree di sospensione per il controllo della versione
Comandi di carattere informativo
Riferimenti
Sintassi della riga di comando (Team System)