Comando Workspace (controllo della versione di Team Foundation)

  • Articolo

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) workspace consente di creare, eliminare, visualizzare o modificare proprietà e mapping associati a un'area di lavoro.

Prerequisiti

  • Per modificare o eliminare un'area di lavoro esistente, è necessario essere il proprietario o disporre dell'autorizzazione globale Amministrazione ister workspaces impostata su Consenti.
  • Per creare un'area di lavoro, è necessario avere l'autorizzazione globale Crea un'area di lavoro impostata su Consenti.
  • Per creare aree di lavoro per altri utenti, è necessario disporre dell'autorizzazione Amministrazione ister workspaces impostata su Consenti.

Per altre informazioni, vedere Autorizzazioni tfvc predefinite.

Sintassi

tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]

tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]

tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]

Parametri

Le sezioni seguenti descrivono argomenti e opzioni del workspace comando.

Argomenti

Argomento Descrizione
<workspace-name> Specifica un nome per l'area di lavoro su cui si desidera creare, modificare, eliminare o visualizzare informazioni.
<workspace-owner> Specifica un nome utente per l'area di lavoro. Questo parametro è obbligatorio quando il proprietario dell'area di lavoro non è la persona che esegue il comando.
<computer-name> Fornisce un valore all'opzione /computer .
<comment> Fornisce un valore all'opzione /comment .
@<comment-file> Specifica il percorso di un file in cui deve essere letto il commento.
<username> Fornisce un valore all'opzione /login . È possibile specificare questo valore come DOMAIN\<username> o <username>.
<password> Fornisce un valore all'opzione /login .
<team-project-collection-url> URL della raccolta di progetti che contiene l'area di lavoro che si desidera creare, modificare, eliminare o visualizzare informazioni su, https://myserver:8080/tfs/DefaultCollectionad esempio .
<owner-name> Fornisce un valore all'opzione /newowner .

Opzioni

Opzione Descrizione
/new Crea una nuova area di lavoro.
/template Specifica un'area di lavoro esistente da usare come modello per la creazione di una nuova area di lavoro. La nuova area di lavoro usa i mapping dell'area di lavoro esistente.
/delete Elimina l'area di lavoro specificata.
/computer Specifica il nome del computer in cui creare un'area di lavoro. Questa opzione è un'opzione avanzata.
/comment Fornisce un commento che descrive l'area di lavoro.
/newname Rinomina un'area di lavoro esistente.
/noprompt Esegue il comando dell'area di lavoro specificata senza visualizzare una finestra di dialogo.
/collection Specifica la raccolta di progetti.
/permission Specifica le opzioni per le autorizzazioni dell'area di lavoro:

    - Private: solo i proprietari possono usare, archiviare i file o amministrare l'area di lavoro.


    - Public Limited: qualsiasi utente valido può usare l'area di lavoro. Ma solo i proprietari possono archiviare i file o amministrare l'area di lavoro.


    - Public: qualsiasi utente valido può usare, archiviare i file o amministrare l'area di lavoro.
/location Specifica dove viene creata l'area di lavoro:

    - local: nel computer client. Si tratta del valore predefinito.


    - server: nel server Azure DevOps.
/login Specifica il nome utente e la password per autenticare l'utente con Azure DevOps.
/newowner Specifica il nome utente per il nuovo proprietario dell'area di lavoro.

Osservazioni:

Un'area di lavoro è una copia locale dei file e delle cartelle nel server, oltre alle eventuali modifiche apportate localmente. Quando si aggiungono, modificano, eliminano, spostano, rinominano o modificano qualsiasi elemento controllato dalla versione, le modifiche vengono isolate nell'area di lavoro, in cui è possibile apportare e testare le modifiche. Quando si archivia il lavoro nella codebase del team, si esegue il commit delle modifiche nel server. Diventano disponibili per altri utenti esterni all'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.

Creare un'area di lavoro

Prima di poter aggiungere file al server di controllo della versione o estrarne gli elementi nel server, è necessario creare un'area di lavoro o associarne una esistente alla directory corrente. Per altre informazioni, vedere Configurare controllo della versione di Team Foundation nel computer di sviluppo.

Per rendere la directory corrente una cartella di lavoro per un'area di lavoro esistente nel computer, seguire questa procedura:

  1. Immettere tf workspace <workspace-name>, dove <workspace-name> è il nome dell'area di lavoro esistente. Verrà visualizzata la finestra di dialogo Modifica area di lavoro .
  2. Selezionare fare clic qui per immettere una nuova cartella di lavoro.
  3. Nella casella Cartella controllo del codice sorgente immettere il percorso del server a cui si desidera eseguire il mapping della directory corrente.
  4. Nella casella Cartella locale immettere la directory corrente.
  5. Seleziona OK.

Quando si crea una nuova area di lavoro, è possibile specificare un'area di lavoro modello come parte dell'opzione /new . Quando si specifica un'area di lavoro modello, TFVC crea una nuova area di lavoro nel computer corrente. TFVC imposta anche il proprietario sul proprietario corrente e replica le proprietà dell'area di lavoro seguenti nella nuova area di lavoro dall'area di lavoro modello: mappings e comment. Se non viene specificato alcun nome, il sistema usa un nome basato sul nome del computer corrente. Quando si crea un'area di lavoro usando un modello, TFVC non recupera i file di cui esegue il mapping dal server. Usare il get comando per sincronizzare la nuova area di lavoro con la versione più recente nel server. Per altre informazioni, vedere Comando Get.

Mapping di cartelle singole

È possibile scegliere di eseguire il mapping solo degli elementi figlio immediati di una cartella del controllo della versione a un'area di lavoro locale. A tale scopo, aggiungere un carattere jolly asterisco (*) nella casella Cartella controllo codice sorgente nella finestra di dialogo Aggiungi area di lavoro , $/folder/*ad esempio . In caso contrario, per impostazione predefinita, tutti gli elementi figlio della cartella del controllo della versione vengono mappati in modo ricorsivo all'area di lavoro locale.

Il mapping di una singola cartella all'interno di una gerarchia di controllo della versione è utile perché limita il numero di elementi scaricati nel computer client. Un altro modo per limitare i file scaricati consiste nel nascondere i file che non è necessario avere nell'area di lavoro. Per altre informazioni, vedere Ottimizzare l'area di lavoro. Questo approccio offre tempi di download più rapidi e consente di risparmiare spazio su disco nel computer client.

Eliminazione di un'area di lavoro

Se si elimina un'area di lavoro che contiene modifiche in sospeso, tfvc annulla le modifiche in sospeso come parte del processo di eliminazione. L'eliminazione di un'area di lavoro non elimina i file e le cartelle nel computer client in tale area di lavoro.

Nota

I comandi eseguiti manualmente richiedono l'opzione per ignorare l'acknowledgement /noprompt dell'utente. Prestare attenzione se si usa il metodo PowerShell Start() per eseguire i comandi. L'opzione /noprompt può essere impostata automaticamente in PowerShell.

Quando si elimina un'area di lavoro è necessario specificare <workspace-owner> e <workspace-name>

È possibile usare il workspace comando per recuperare tali valori. Per altre informazioni, vedere Comando aree di lavoro. Per trovare il <workspace-owner> valore, eseguire il comando seguente:

c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml

Per trovare il <workspace-name> valore, usare il <OwnerId> valore dell'output del comando precedente come <workspace-owner> valore. Tale valore ha il formato di un ID oggetto di Azure Active Directory (Azure AD) seguito da una barra rovesciata e da un nome dell'entità utente. Usare l'intero valore. Poi eseguire quindi il comando seguente.

c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`

Per eliminare l'area di lavoro, eseguire il comando seguente:

c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`

Modificare un'area di lavoro

È possibile modificare gli attributi dell'area di lavoro seguenti:

  • Nome dell'area di lavoro
  • Commento
  • Mapping delle cartelle di lavoro

Se non viene specificata alcuna specifica dell'area di lavoro, viene usata l'area di lavoro per la cartella corrente.

Esempi

Nell'esempio seguente viene aperta la finestra di dialogo Aggiungi area di lavoro e viene creata 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 /collection:https://myserver:8080/tfs/DefaultCollection

L'esempio seguente crea una nuova area di lavoro denominata Beta1 e assegna jenh come proprietario dell'area di lavoro. È necessario disporre dell'autorizzazione Amministrazione Workspaces per assegnare la proprietà di una nuova area di lavoro a un altro utente. Per altre informazioni sulle autorizzazioni di sicurezza, vedere Autorizzazioni tfvc predefinite.

c:\projects>tf workspace /new Beta1;jenh

L'esempio seguente crea una nuova area di lavoro usando l'area di lavoro Beta1 di proprietà di jenh come modello:

c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection

L'esempio seguente rimuove l'area di lavoro Beta1 dal server:

c:\projects>tf workspace /delete Beta1

L'esempio seguente modifica le proprietà per l'area di lavoro corrente:

c:\projects>tf workspace

L'esempio seguente apre l'area di lavoro Beta1 di proprietà di jenh in modo da visualizzarne le proprietà e i mapping. Se si dispone dell'autorizzazione Amministrazione Workspaces, è possibile modificare le proprietà e i mapping dell'area di lavoro.

c:\projects> tf workspaces Beta1;jenh