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

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O comando TFVC (Controle de Versão do Team Foundation) workspace fornece uma maneira de criar, excluir, exibir ou modificar propriedades e mapeamentos associados a um workspace.

Pré-requisitos

• Para modificar ou excluir um workspace existente, seja o proprietário ou tenha o global Administrar workspaces permissão definida para Permitir.
• Para criar um workspace, tenha o global Criar um workspace permissão definido para Permitir.
• Para criar workspaces para outros usuários, tenha a permissão Administrar workspaces definida como Permitir.

Para obter mais informações, consulte permissões TFVC padrão.

Sintaxe

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)]

Parâmetros

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

Argumentos

Opções

Observações

Um workspace é uma cópia local dos arquivos e pastas no servidor, além de todas as alterações feitas localmente. Quando você adiciona, edita, exclui, move, renomeia ou altera qualquer item controlado por versão, suas alterações são isoladas em seu workspace, onde você pode fazer e testar suas alterações. Quando você fazer check-in do seu trabalho para a base de código da equipe, você confirma suas alterações no servidor. Eles ficam disponíveis para outros usuários que estão fora do workspace.

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

Criar um workspace

Antes de adicionar arquivos ao servidor de controle de versão ou fazer check-out de itens no servidor, você deve criar um workspace ou associar um existente ao diretório atual. Para obter mais informações, consulte Configurar o Controle de Versão do Team Foundation em seu computador de desenvolvimento.

Para tornar o diretório atual uma pasta de trabalho para um workspace existente em seu computador, siga estas etapas:

1. Insira tf workspace <workspace-name>, em que <workspace-name> é o nome do workspace existente. A caixa de diálogo Editar Workspace é exibida.
2. Selecione clique aqui para inserir uma nova pasta de trabalho.
3. Na caixa pasta de controle do código-fonte , insira o caminho do servidor para o qual você deseja mapear o diretório atual.
4. Na caixa pasta local , insira o diretório atual.
5. Selecione OK.

Ao criar um novo workspace, você pode especificar um workspace modelo como parte da opção /new. Quando você especifica um workspace de modelo, o TFVC cria um novo workspace no computador atual. O TFVC também define o proprietário como o proprietário atual e replica as seguintes propriedades de workspace no novo workspace do workspace de modelo: mappings e comment. Se nenhum nome for especificado, o sistema usará um nome baseado no nome do computador atual. Quando você cria um workspace usando um modelo, o TFVC não recupera os arquivos para os quais ele mapeia do servidor. Use o comando get para sincronizar o novo workspace com a versão mais recente no servidor. Para obter mais informações, consulte Obterde comando.

Mapeamento de pasta única

Você pode optar por mapear apenas os filhos imediatos de uma pasta de controle de versão para um workspace local. Para fazer isso, adicione um caractere curinga asterisco (*) na caixa pasta de controle do código-fonte na caixa de diálogo Adicionar Workspace, por exemplo, . Caso contrário, por padrão, todos os filhos da pasta de controle de versão serão mapeados recursivamente para o workspace local.

O mapeamento de pasta única dentro de uma hierarquia de controle de versão é útil porque limita o número de itens baixados no computador cliente. Outra maneira de limitar arquivos baixados é ocultar arquivos que você não precisa ter em seu workspace. Para obter mais informações, consulte Otimizar seu workspace. Essa abordagem fornece tempos de download mais rápidos e economiza espaço em disco no computador cliente.

Excluir um workspace

Se você excluir um workspace que contém alterações pendentes, o TFVC cancelará as alterações pendentes como parte do processo de exclusão. Excluir um workspace não exclui os arquivos e pastas no computador cliente que estavam nesse workspace.

Ao excluir um workspace, você precisa fornecer o <workspace-owner> e <workspace-name>

Você pode usar o comando workspace para recuperar esses valores. Para obter mais informações, consulte comando workspaces. Para localizar o valor <workspace-owner>, execute o seguinte comando:

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

Para localizar o valor <workspace-name>, use o valor <OwnerId> da saída do comando anterior como o valor <workspace-owner>. Esse valor tem o formato de uma ID de objeto do Azure AD (Azure Active Directory) seguida por uma barra invertida e um nome de entidade de usuário. Use o valor inteiro. Em seguida, execute o seguinte comando:

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

Para excluir o workspace, execute o seguinte comando:

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

Editar um workspace

Você pode alterar os seguintes atributos de workspace:

• Nome do workspace
• Comentário
• Mapeamentos de pasta de trabalho

Se nenhuma especificação de workspace for fornecida, o workspace da pasta atual será usado.

Exemplos

O exemplo a seguir abre a caixa de diálogo Adicionar Workspace e cria um novo workspace. Você pode usar a caixa de diálogo Adicionar Workspace para editar a pasta de controle do código-fonte, o proprietário, o computador, o comentário e as pastas locais.

c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection

O exemplo a seguir cria um novo workspace chamado Beta1 e atribui jenh como o proprietário do workspace. Tenha o AdminWorkspaces permissão para atribuir a propriedade de um novo workspace a outro usuário. Para obter mais informações sobre permissões de segurança, consulte permissões TFVC padrão.

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

O exemplo a seguir cria um novo workspace usando o workspace Beta1 que pertence a jenh como modelo:

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

O exemplo a seguir remove o workspace Beta1 do servidor:

c:\projects>tf workspace /delete Beta1

O exemplo a seguir edita propriedades para o workspace atual:

c:\projects>tf workspace

O exemplo a seguir abre o workspace Beta1 que pertence a jenh para que você possa ver suas propriedades e mapeamentos. Se você tiver a permissão AdminWorkspaces, poderá alterar as propriedades e os mapeamentos do workspace.

c:\projects> tf workspaces Beta1;jenh

Artigos relacionados

• Otimizar o do workspace
• Usar comandos de controle de versão do Team Foundation
• comando Workspaces
• Criar e trabalhar com workspaces
• configurar o Controle de Versão do Team Foundation em seu computador de desenvolvimento