Comando Espaço de trabalho (Controle de versão do Team Foundation)

  • Artigo

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) workspace fornece uma maneira de criar, excluir, exibir ou modificar propriedades e mapeamentos associados a um espaço de trabalho.

Pré-requisitos

  • Para modificar ou excluir um espaço de trabalho existente, você deve ser o proprietário ou ter a permissão global Administrar espaços de trabalho definida como Permitir.
  • Para criar um espaço de trabalho, você deve ter a permissão global Criar um espaço de trabalho definida como Permitir.
  • Para criar espaços de trabalho para outros usuários, você deve ter a permissão Administrar espaços de trabalho 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 workspace comando.

Argumentos

Argumento Description
<workspace-name> Especifica um nome para o espaço de trabalho sobre o qual você deseja criar, editar, excluir ou exibir informações.
<workspace-owner> Especifica um nome de usuário para o espaço de trabalho. Esse parâmetro é necessário quando o proprietário do espaço de trabalho não é a pessoa que está executando o comando.
<computer-name> Fornece um valor para a /computer opção.
<comment> Fornece um valor para a /comment opção.
@<comment-file> Especifica o caminho de um arquivo onde o comentário deve ser lido.
<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.
<team-project-collection-url> A URL da coleção de projetos que contém o espaço de trabalho que você deseja criar, editar, excluir ou exibir informações sobre, por exemplo, https://myserver:8080/tfs/DefaultCollection.
<owner-name> Fornece um valor para a /newowner opção.

Opções

Opção Description
/new Cria um novo espaço de trabalho.
/template Especifica um espaço de trabalho existente a ser usado como modelo para criar um novo espaço de trabalho. O novo espaço de trabalho usa os mapeamentos do espaço de trabalho existente.
/delete Exclui o espaço de trabalho especificado.
/computer Especifica o nome do computador no qual criar um espaço de trabalho. Esta opção é uma opção avançada.
/comment Fornece um comentário que descreve o espaço de trabalho.
/newname Renomeia um espaço de trabalho existente.
/noprompt Executa o comando de espaço de trabalho especificado sem exibir uma caixa de diálogo.
/collection Especifica a coleção de projetos.
/permission Especifica as opções para permissões de espaço de trabalho:
    - Private: Somente os proprietários podem usar, fazer check-in de arquivos ou administrar o espaço de trabalho.
    - Public Limited: Qualquer usuário válido pode usar o espaço de trabalho. Mas apenas os proprietários podem fazer check-in de arquivos ou administrar o espaço de trabalho.
    - Public: Qualquer usuário válido pode usar, fazer check-in de arquivos ou administrar o espaço de trabalho.
/location Especifica onde o espaço de trabalho é criado:
    - local: Na máquina cliente. Este valor é a predefinição.
    - server: No servidor de DevOps do Azure.
/login Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps.
/newowner Especifica o nome de usuário para o novo proprietário do espaço de trabalho.

Observações

Um espaço de trabalho é uma cópia local dos arquivos e pastas no servidor, além de quaisquer alterações feitas localmente. Quando você adiciona, edita, exclui, move, renomeia ou altera qualquer item com controle de versão, as alterações são isoladas no espaço de trabalho, onde você pode fazer e testar as alterações. Ao fazer check-in do seu trabalho na 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 seu espaço de trabalho.

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.

Criar uma área de trabalho

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

Para tornar o diretório atual uma pasta de trabalho para um espaço de trabalho existente no seu computador, execute estas etapas:

  1. Digite tf workspace <workspace-name>, onde <workspace-name> é o nome do espaço de trabalho existente. A caixa de diálogo Editar espaço de trabalho é exibida.
  2. Selecione clique aqui para inserir uma nova pasta de trabalho.
  3. Na caixa Pasta de controle do código-fonte, digite 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 espaço de trabalho, você pode especificar um espaço de trabalho de modelo como parte da /new opção. Quando você especifica um espaço de trabalho de modelo, o TFVC cria um novo espaço de trabalho no computador atual. O TFVC também define o proprietário como o proprietário atual e replica as seguintes propriedades do espaço de trabalho no novo espaço de trabalho a partir do espaço de trabalho do modelo: mappings e comment. Se nenhum nome for especificado, o sistema usará um nome baseado no nome do computador atual. Quando você cria um espaço de trabalho usando um modelo, o TFVC não recupera os arquivos para os quais ele mapeia do servidor. Use o get comando para sincronizar o novo espaço de trabalho com a versão mais recente no servidor. Para obter mais informações, consulte Obter comando.

Mapeamento de pasta única

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

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

Eliminar uma área de trabalho

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

Nota

Os comandos executados manualmente exigem a opção de ignorar a /noprompt confirmação do usuário. Tenha cuidado se você usar o método PowerShell Start() para executar comandos. A /noprompt opção pode ser definida automaticamente no PowerShell.

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

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

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

Para localizar o <workspace-name> valor, use o <OwnerId> valor da saída do comando anterior como o <workspace-owner> valor. Esse valor tem o formato de uma ID de objeto do Azure Ative Directory (Azure AD) seguida por uma barra invertida e um nome principal 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 espaço de trabalho, execute o seguinte comando:

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

Editar um espaço de trabalho

Você pode alterar os seguintes atributos do espaço de trabalho:

  • Nome da área de trabalho
  • Comentário
  • Mapeamentos de pastas de trabalho

Se nenhuma especificação de espaço de trabalho for fornecida, o espaço de trabalho para a pasta atual será usado.

Exemplos

O exemplo a seguir abre a caixa de diálogo Adicionar espaço de trabalho e cria um novo espaço de trabalho. Você pode usar a caixa de diálogo Adicionar Espaço de Trabalho 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 espaço de trabalho chamado Beta1 e atribui jenh como o proprietário do espaço de trabalho. Você deve ter a permissão AdminWorkspaces para atribuir a propriedade de um novo espaço de trabalho 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 espaço de trabalho usando o espaço de trabalho Beta1 que pertence ao jenh como modelo:

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

O exemplo a seguir remove o espaço de trabalho Beta1 do servidor:

c:\projects>tf workspace /delete Beta1

O exemplo a seguir edita propriedades para o espaço de trabalho atual:

c:\projects>tf workspace

O exemplo a seguir abre o espaço de trabalho Beta1 de propriedade do 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 espaço de trabalho.

c:\projects> tf workspaces Beta1;jenh