Comando Workspaces (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) workspaces visualizza informazioni sulle aree di lavoro nel sistema e aggiorna le informazioni memorizzate nella cache relative a un nome utente o al nome del computer in un server Azure DevOps.
Prerequisiti
Per usare il workspaces comando, è necessario disporre dell'autorizzazione Lettura impostata su Consenti. Per altre informazioni, vedere Autorizzazioni tfvc predefinite.
Sintassi
tf workspaces [/owner:<owner-name>] [/computer:<computer-name>]
[/collection:<team-project-collection-url>] [/format:(brief|detailed|xml)]
[/updateUserName:<old-user-name>] [/updateComputerName:<old-computer-name>]
[<workspace-name>][/login:<username>,[<password>]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|<team-project-collection-url>)
Parametri
Le sezioni seguenti descrivono argomenti e opzioni del workspaces comando.
Argomenti
Argomento
Descrizione
<owner-name>
Fornisce un valore all'opzione /owner . Usare una stringa vuota ("") per trovare le corrispondenze con le aree di lavoro create da qualsiasi utente.
<computer-name>
Fornisce un valore all'opzione /computer . Usare una stringa vuota ("") per trovare le corrispondenze tra le aree di lavoro in qualsiasi computer.
<workspace-name>
Specifica il nome di un'area di lavoro per visualizzare informazioni su . Se non viene specificato un valore, vengono visualizzate informazioni su tutte le aree di lavoro in un server. È anche possibile usare un carattere jolly asterisco (*) per visualizzare informazioni su tutte le aree di lavoro per un server.
<old-user-name>
Fornisce il vecchio nome utente per l'opzione /updateUserName .
<old-computer-name>
Fornisce il nome del computer precedente per l'opzione /updateComputerName .
<team-project-collection-url>
URL della raccolta di progetti che contiene le aree di lavoro su cui si desidera visualizzare informazioni, ad esempio https://myserver:8080/tfs/DefaultCollection.
<username>
Fornisce un valore all'opzione /login . È possibile specificare questo valore come DOMAIN\<username> o <username>.
<password>
Fornisce un valore all'opzione /login .
Opzioni
Opzione
Descrizione
/owner
Specifica il nome dell'utente che ha creato l'area di lavoro. Se non viene specificato alcun proprietario, tfvc restituisce informazioni sulle aree di lavoro di proprietà dell'utente corrente.
/computer
Specifica il nome di un computer client in base al quale filtrare l'elenco di aree di lavoro per il server. Se non viene specificato alcun computer, il controllo della versione di Team Foundation restituisce informazioni sulle aree di lavoro solo nel computer corrente.
/format
Specifica il formato delle informazioni sull'area di lavoro. Brief restituisce informazioni sull'area di lavoro senza mapping. Detailed restituisce informazioni sull'area di lavoro e anche i mapping. Xml restituisce informazioni sull'area di lavoro, un mapping, la data di accesso più recente e anche gli alias del proprietario. Il formato dettagliato può essere utilizzato solo quando viene specificata l'opzione /collection . Brief è il valore predefinito.
/updateUserName
Aggiornamenti informazioni di identificazione della sicurezza nel server Azure DevOps per un utente il cui nome utente di rete è stato modificato. Se si specifica questa opzione, è necessario specificare anche una raccolta di progetti usando l'opzione /collection .
/updateComputerName
Indica a TFVC di aggiornare le tabelle in modo da riflettere una modifica nel nome di un computer client. Se si specifica questa opzione, è necessario specificare anche una raccolta di progetti usando l'opzione /collection .
/remove
Rimuove le voci dell'area di lavoro specificate per la raccolta di progetti specificata dalla cache client.
/collection
Specifica la raccolta di progetti.
/login
Specifica il nome utente e la password per autenticare l'utente con Azure DevOps Server.
Osservazioni:
Il workspaces comando dell'utilità della tf riga di comando visualizza informazioni sulle aree di lavoro nel computer corrente, di proprietà di un utente specificato o per tutte le aree di lavoro associate a un server Azure DevOps specifico. Per ogni area di lavoro, tfvc visualizza il nome, il proprietario, il commento e il nome del computer. Con output dettagliato, mostra anche i mapping dell'area di lavoro. A meno che non si fornisca un filtro, ad esempio il proprietario, il computer o il nome dell'area di lavoro, tfvc visualizza solo le informazioni sulle aree di lavoro create.
Per altre informazioni su come modificare le proprietà dell'area di lavoro, vedere Comando dell'area di lavoro.
Per altre informazioni su come usare l'utilità della tf riga di comando, vedere Usare i comandi di controllo della versione di Team Foundation.
Esempi
Nell'esempio seguente viene visualizzato un elenco di tutte le aree di lavoro per l'utente corrente nel computer corrente:
c:\projects>tf workspaces
Nell'esempio seguente viene visualizzato un elenco di tutte le aree di lavoro per tutti gli utenti in tutti i computer creati nella raccolta di progetti seguente all'indirizzo https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /owner:* /computer:* /collection:https://myserver:8080/tfs/DefaultCollection
Nell'esempio seguente vengono visualizzate informazioni dettagliate su tutte le aree di lavoro create dall'utente corrente nella raccolta di progetti all'indirizzo https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection
Nell'esempio seguente vengono visualizzate informazioni dettagliate sull'area di lavoro WS1, di proprietà dell'utente corrente e che si trova nel computer corrente. Le informazioni visualizzate includono un elenco di mapping dell'area di lavoro.
c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1
Nell'esempio seguente vengono rimosse tutte le aree di lavoro memorizzate nella cache nella raccolta di progetti all'indirizzo https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection