Comando Workspace
Aggiornamento: novembre 2007
Consente di creare, eliminare, visualizzare o modificare proprietà e mapping associati a un'area di lavoro.
Autorizzazioni necessarie
Per modificare o eliminare un'area di lavoro esistente, è necessario essere il proprietario oppure disporre dell'autorizzazione Amministra aree di lavoro impostata su Consenti. Per creare un'area di lavoro è necessario disporre dell'autorizzazione globale Crea area di lavoro impostata su Consenti. Per creare aree di lavoro per altri utenti, è necessario disporre dell'autorizzazione Amministra aree di lavoro impostata su Consenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
tf workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
[/computer:computername] [/comment:(“comment”|@comment file)]
[/s:servername] [workspacename[;workspaceowner]]
tf workspace /delete [/server:servername] workspacename[;workspaceowner]
tf workspace [/server:servername] [/comment: (“comment”|@comment file)] [/newname:workspacename]
[workspacename[;workspaceowner]]
Parametri
Argomento |
Descrizione |
|---|---|
workspacename |
Indica un nome per l'area di lavoro da creare, modificare, eliminare o su cui visualizzare informazioni. |
workspaceowner |
Indica un nome utente per l'area di lavoro. Questo parametro è necessario quando il proprietario dell'area di lavoro non corrisponde all'utente che esegue il comando. |
computername |
Fornisce un valore all'opzione /computer . |
comment |
Fornisce un valore all'opzione /comment . |
@commentfile |
Indica il percorso di un file in cui deve essere letto il commento. |
servername |
Valore fornito dall'utente per l'opzione /server. Ad esempio, teamfoundation2. |
Opzione |
Descrizione |
|---|---|
/new |
Crea una nuova area di lavoro. |
/template |
Indica un'area di lavoro esistente da utilizzare come modello per creare la nuova area di lavoro. La nuova area di lavoro utilizza i mapping dell'area di lavoro esistente. |
/delete |
Elimina l'area di lavoro specificata. |
/computer |
Indica il nome del computer in cui creare l'area di lavoro. Si tratta di un'opzione avanzata. |
/comment |
Fornisce un commento descrittivo dell'area di lavoro. |
/server |
Identifica Team Foundation Server. Questa opzione è necessaria quando si crea una nuova area di lavoro e si tenta di avviare il comando workspace da una directory non mappata a un'area di lavoro. |
/newname |
Rinomina un'area di lavoro esistente. |
/noprompt |
Esegue il comando specificato dell'area di lavoro senza visualizzare una finestra di dialogo. |
Note
Un'area di lavoro corrisponde a una copia locale dei file e delle cartelle presenti sul server cui si aggiungono tutte le modifiche apportate localmente. Quando si aggiunge, si modifica, si elimina, si sposta, si rinomina o si modifica diversamente un elemento incluso nel controllo della versione, le modifiche verranno isolate nell'area di lavoro, dove è possibile apportarle e testarle. Una volta eseguito il commit sul server delle modifiche in sospeso, queste risultano disponibili agli altri utenti all'esterno dell'area di lavoro quando si esegue un'archiviazione.
Per ulteriori informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.
Creazione di una nuova area di lavoro
Prima di poter aggiungere file al server di controllo della versione o estrarre elementi dal server per modificarli, è necessario creare un'area di lavoro o associarne una esistente alla directory corrente. Per ulteriori informazioni, vedere Procedura: creare un'area di lavoro mappata.
Per rendere la directory corrente una cartella di lavoro per un'area di lavoro esistente sul computer, digitare tf workspaceworkspacename, dove workspacename è il nome dell'area di lavoro esistente. Verrà visualizzata la finestra di dialogo Modifica area di lavoro. Fare clic su Fare clic qui per immettere una nuova cartella di lavoro, digitare il percorso del server per il quale si desidera eseguire il mapping della directory corrente nella casella Cartella del controllo del codice sorgente , digitare la directory corrente nella casella Cartella locale e scegliere OK.
Quando si crea una nuova area di lavoro, è possibile specificare un'area di lavoro modello nell'opzione /new . Quando si specifica un'area di lavoro modello, in Team Foundation viene creata una nuova area di lavoro per il computer corrente, viene quindi impostato il proprietario sul proprietario corrente e nella nuova area di lavoro viene eseguita la replica delle proprietà relative a mapping e commento dell'area di lavoro modello. Se non si specifica alcun nome, verrà utilizzato un nome basato sul nome computer corrente. Quando si crea un'area di lavoro basata su un modello, in Team Foundation dal server non verranno recuperati i file cui viene mappato. Utilizzare il Comando Get per sincronizzare la nuova area di lavoro con l'ultima versione disponibile nel server.
Mapping di una singola cartella
È possibile scegliere di eseguire il mapping solo di elementi figlio immediati di una cartella di controllo della versione a un'area di lavoro locale. Per eseguire questa operazione, aggiungere un carattere jolly asterisco nella casella Cartella del controllo del codice sorgente nella finestra di dialogo Aggiungi area di lavoro. Ad esempio, $/cartella/*. In caso contrario, per impostazione predefinita, tutti gli elementi figlio della cartella del controllo della versione verranno mappati in modo ricorsivo all'area di lavoro locale.
Il mapping di una singola cartella all'interno di una gerarchia del controllo della versione è utile perché limita il numero di elementi scaricati nel computer client. Un'altra modalità per limitare i file scaricati è di mascherare i file che non è necessario avere nell'area di lavoro. Per ulteriori informazioni, vedere Procedura: mascherare e rendere visibili le cartelle in un'area di lavoro. Questo consente di abbreviare i tempi necessari per il download e di risparmiare spazio su disco.
Eliminazione di un'area di lavoro
Se si elimina un'area di lavoro che contiene modifiche in sospeso, queste verranno annullate in Team Foundation nell'ambito del processo di eliminazione. L'eliminazione di un'area di lavoro non implica l'eliminazione dal computer client dei file e delle cartelle inclusi in tale area di lavoro.
Modifica di un'area di lavoro
È possibile modificare i seguenti attributi dell'area di lavoro:
Nome dell'area di lavoro
Commento
Mapping della cartella di lavoro
Se non viene specificata alcuna area di lavoro, verrà utilizzata quella relativa alla cartella corrente.
Esempi
L'esempio seguente consente di aprire la finestra di dialogo Aggiungi area di lavoro e di creare una nuova area di lavoro. È possibile utilizzare la finestra di dialogo Aggiungi area di lavoro per modificare la cartella del controllo del codice sorgente, il proprietario, il computer, il commento e le cartelle locali.
c:\projects>tf workspace /new /server:teamserver2
L'esempio riportato di seguito consente di creare una nuova area di lavoro denominata Beta1 e di assegnare jenh come proprietario dell'area. Per assegnare la proprietà di una nuova area di lavoro a un altro utente, è necessario disporre dell'autorizzazione AdminWorkspaces. Per ulteriori informazioni sulle autorizzazioni di sicurezza, vedere Autorizzazioni per Team Foundation Server.
c:\projects>tf workspace /new Beta1;jenh
L'esempio riportato di seguito consente di creare una nuova area di lavoro utilizzando come modello l'area di lavoro Beta1 di proprietà dell'utente jenh.
c:\projects>tf workspace /new /template:Beta1;jenh /server:teamserver2
L'esempio riportato di seguito consente di rimuovere l'area di lavoro Beta1 dal sistema.
c:\projects>tf workspace /delete Beta1
L'esempio riportato di seguito consente di modificare le proprietà per l'area di lavoro corrente.
c:\projects>tf workspace
L'esempio riportato di seguito consente di aprire l'area di lavoro Beta1 di cui l'utente jenh è proprietario in modo da poterne visualizzare le proprietà e i mapping. Se si dispone delle autorizzazioni AdminWorkspaces, è possibile modificare le proprietà e i mapping dell'area di lavoro.
c:\projects> tf workspace Beta1;jenh
Vedere anche
Attività
Procedura: creare un'area di lavoro mappata
Procedura: mascherare e rendere visibili le cartelle in un'area di lavoro
Concetti
Utilizzo delle aree di lavoro per il controllo della versione
Riferimenti
Sintassi della riga di comando (Team System)