Comando Workfold (Controle de Versão do Team Foundation)

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O comando Team Foundation Version Control (TFVC) workfold cria, modifica ou exibe informações sobre os mapeamentos entre suas pastas de espaço de trabalho e as pastas que estão no servidor de DevOps do Azure para TFVC.

Pré-requisitos

Para usar o workfold comando, você deve ser o proprietário do espaço de trabalho especificado ou implícito ou ter a permissão global Administrar espaços de trabalho definida como Permitir. Para obter mais informações, consulte Permissões TFVC padrão.

Sintaxe

tf workfold <local-folder> [/login:<username>,[<password>]]
tf workfold [/workspace:<workspace-name>] [/login:<username>,[<password>]]
tf workfold [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] [/login:<username>,[<password>]]
<server-folder>
tf workfold [/map <server-folder> <local-folder>] [/collection:<team-project-collection-url>] 
[/workspace:<workspace-name>][/login:<username>,[<password>]
tf workfold /unmap [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] 
[/recursive] (<server-folder>|<local-folder>) [/login:<username>,[<password>]]
tf workfold /cloak 
<server-folder> [/workspace:<workspace-name>] [/collection:<team-project-collection-url>] [/login:<username>,[<password>]]
tf workfold /decloak <server-folder>
[/workspace:<workspace-name>] [/collection:<team-project-collection-url>][/login:<username>,[<password>]]

Parâmetros

As seções a seguir descrevem argumentos e opções do workfold comando.

Argumentos

Argumento

Descrição

<workspace-name>

Especifica o nome do espaço de trabalho no qual o comando opera com a /workspace opção.

<server-folder>

Especifica o nome de uma pasta de servidor do Azure DevOps.

<local-folder>

Especifica o nome de uma pasta local.

<team-project-collection-url>

A URL da coleção de projetos que contém as pastas que você deseja comparar com as pastas do servidor, por exemplo, https://myserver:8080/tfs/DefaultCollection/.

<username>

Fornece um valor para a /login opção. Você pode especificar esse valor como ou DOMAIN\<username> <username>.

<password>

Fornece um valor para a /login opção.

Opções

Opção

Descrição

/workspace

Especifica o nome do espaço de trabalho no qual trabalhar.

/map

Especifica uma associação entre uma pasta local e a pasta do servidor Azure DevOps. Por padrão, o workfold comando usa essa opção, mesmo que não especificada, a menos que /unmap, /cloakou /decloak seja especificado.

/unmap

Especifica qual mapeamento de pasta remover do espaço de trabalho.

/cloak

Especifica que a pasta deve ser excluída de quaisquer ações de controle de versão feitas no espaço de trabalho.

/decloak

Decloaks uma pasta para que a pasta possa ser recuperada no espaço de trabalho.

/collection

Especifica a coleção de projetos.

/login

Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps.

Observações

Você pode usar o workfold comando do tf utilitário de linha de comando para criar e editar mapeamentos de espaço de trabalho. Um mapeamento de espaço de trabalho cria uma pasta do lado do cliente na qual todos os arquivos e subpastas na pasta do servidor Azure DevOps são recuperados quando você executa uma tf get operação. A get operação não funciona se a pasta do lado do cliente estiver oculta.

Você também pode usar um caractere curinga asterisco (*) para mapear uma pasta do Servidor de DevOps do Azure e seus itens imediatos para seu espaço de trabalho local. Esse mapeamento é frequentemente chamado de mapeamento de pasta única.

Para obter mais informações sobre como usar o tf utilitário de linha de comando, consulte Usar comandos de controle de versão do Team Foundation.

Opções para mapeamento de espaço de trabalho

Um mapeamento de espaço de trabalho é uma lista de itens ativos e encobertos. Você pode adicionar itens de servidor do Azure DevOps à lista mapeada no espaço de trabalho usando a /map opção. Você também pode excluir um item do espaço de trabalho explicitamente usando a /cloak opção. Você só pode encobrir itens que tenham um pai mapeado. O cloaking é uma maneira eficaz de melhorar a velocidade das operações em lote get e economizar espaço no disco.

Use a camuflagem com discrição. Para evitar problemas de compilação e integração, você deve ocultar apenas os itens que sabe estarem fora do escopo de seus projetos atuais e futuros, como imagens e arquivos de documentação externos.

Você pode usar as /unmap opções e /decloak para excluir seletivamente entradas mapeadas e ocultas do mapeamento do espaço de trabalho.

Como os mapeamentos de espaço de trabalho são aplicados

Por padrão, os mapeamentos de espaço de trabalho são aplicados recursivamente. Quando você mapeia uma pasta local para uma pasta do servidor Azure DevOps, o sistema cria implicitamente um mapeamento entre todas as suas subpastas atuais e futuras.

Por exemplo, suponha que você mapeie $/projects para C:\projects. Em seguida, você adiciona um projeto chamado $/projects/project_one e, em seguida, executa o get comando no espaço de trabalho. Nesse cenário, o TFVC cria automaticamente uma pasta de trabalho local chamada project_one no diretório C:\projects .

O exemplo a seguir usa um caractere curinga asterisco (*) para mapear uma pasta do servidor e seus itens imediatos para o espaço de trabalho local:

tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject

O exemplo a seguir usa o workfold comando para substituir o mapeamento criado automaticamente entre $/projects/project_one e C:\projects\project_one:

tf workfold $/projects/project_one C:\DifferentWorkfold

Mapeamentos sob capas

Mapeamentos de pastas não ocultas localizadas abaixo de uma pasta oculta na hierarquia de controle de versão podem ser mapeados para seu espaço de trabalho local.

Exemplos

O exemplo a seguir exibe os mapeamentos para o espaço de trabalho em que c:\projects reside:

c:\projects>tf workfold

O exemplo a seguir encobre a pasta c:\projects\lib :

c:\projects>tf workfold /cloak c:\projects\lib

O exemplo a seguir exibe o mapeamento para o arquivo local word.cs:

c:\projects>tf workfold word.cs

O exemplo a seguir mapeia a pasta C:\DifferentWorkfold para a pasta do servidor do Azure DevOps $/projects/project_one e substitui o mapeamento de espaço de trabalho anterior para a pasta $/projects/project_one do servidor Azure DevOps:

c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold