Comando workspaces (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 workspaces do TFVC (Controle de Versão do Team Foundation) exibe dados sobre workspaces no sistema e atualiza informações armazenadas em cache sobre uma alteração de nome de usuário ou computador em um servidor do Azure DevOps.
Pré-requisitos
Para usar o comando workspaces, é necessário ter a permissão de Leitura definida como Permitir. Para saber mais, consulte Permissões padrão do TFVC.
Sintaxe
tf workspaces [/owner:<owner-name>] [/computer:<computer-name>]
[/collection:<team-project-collection-url>] [/format:(brief|detailed|xml)]
[/updateUserName:<old-user-name>] [/updateComputerName:<old-computer-name>]
[<workspace-name>][/login:<username>,[<password>]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|<team-project-collection-url>)
Parâmetros
Veja nas seções a seguir a descrição dos argumentos e das opções do comando workspaces.
Argumentos
Argument
Descrição
<owner-name>
Mostra um valor para a opção /owner. Use uma cadeia de caracteres vazia ("") para corresponder aos workspaces criados por qualquer usuário.
<computer-name>
Mostra um valor para a opção /computer. Use uma cadeia de caracteres vazia ("") para corresponder aos workspaces criados em qualquer computador.
<workspace-name>
Especifica o nome de um workspace cujas informações você quer exibir. Se um valor não for especificado, as informações serão exibidas sobre todos os workspaces em um servidor. Você também pode usar um caractere curinga de asterisco (*) para exibir informações sobre todos os workspaces de um servidor.
<old-user-name>
Mostra o nome de usuário antigo para a opção /updateUserName.
<old-computer-name>
Mostra o nome do computador antigo para a opção /updateComputerName.
<team-project-collection-url>
A URL da coleção de projetos que contém os workspaces sobre os quais você deseja exibir informações, por exemplo https://myserver:8080/tfs/DefaultCollection.
<username>
Mostra um valor para a opção /login. É possível especificar esse valor como DOMAIN\<username> ou <username>.
<password>
Mostra um valor para a opção /login.
Opções
Opção
Descrição
/owner
Especifica o nome do usuário que criou o workspace. Se nenhum proprietário for especificado, o TFVC retornará informações sobre workspaces pertencentes apenas ao usuário atual.
/computer
Especifica o nome de um computador cliente pelo a lista de workspaces será filtrada para o servidor. Se nenhum computador for especificado, o TFVC retornará informações sobre workspaces apenas no computador atual.
/format
Especifica o formato das informações do workspace. Brief retorna informações de workspace sem mapeamentos. Detailed retorna informações de workspace e mapeamentos. Xml retorna informações de workspace, um mapeamento, a data de acesso mais recente e também os aliases do proprietário. O formato detalhado só pode ser usado quando a opção /collection é especificada. Brief é o valor padrão.
/updateUserName
Atualiza informações de identificação de segurança no servidor do Azure DevOps para uma pessoa cujo nome de usuário de rede foi alterado. Se você especificar essa opção, também será necessário especificar uma coleção de projetos com a opção /collection.
/updateComputerName
Instrui o TFVC a atualizar suas tabelas para refletir uma alteração no nome de um computador cliente. Se você especificar essa opção, também será necessário especificar uma coleção de projetos com a opção /collection.
/remove
Remove as entradas de workspace especificadas para a coleção de projetos especificada no cache do cliente.
/collection
Especifica a coleção de projetos.
/login
Especifica o nome de usuário e a senha para autenticar o usuário no Azure DevOps Server.
Comentários
O comando workspaces do utilitário de linha de comando tf exibe informações sobre workspaces no computador atual, pertencentes a um usuário especificado, ou sobre todos os workspaces associados a um servidor específico do Azure DevOps. Para cada workspace, o TFVC exibe o nome, o proprietário, o comentário e o nome do computador. Com a saída detalhada, ele também mostra os mapeamentos de workspace. A menos que você forneça um filtro, como o proprietário, o computador ou o nome do workspace, o TFVC exibe apenas informações sobre os workspaces que você criou.
Para saber mais sobre como editar as propriedades do workspace, confira Comando workspace.
Para saber mais sobre como usar o utilitário de linha de comando tf, confira Usar comandos de controle de versão do Team Foundation.
Exemplos
O exemplo a seguir exibe uma lista de todos os workspaces do usuário atual no computador atual:
c:\projects>tf workspaces
O exemplo a seguir exibe uma lista de todos os workspaces de todos os usuários em todos os computadores que foram criados na seguinte coleção de projetos no endereço https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /owner:* /computer:* /collection:https://myserver:8080/tfs/DefaultCollection
O exemplo a seguir exibe informações detalhadas sobre todos os workspaces que o usuário atual criou na coleção de projetos no endereço https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection
O exemplo a seguir exibe informações detalhadas sobre o workspace WS1, que pertence ao usuário atual e está localizado no computador atual. As informações mostradas incluem uma lista de mapeamentos de workspace.
c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1
O exemplo a seguir remove todos os workspaces armazenados do cache na coleção de projetos no endereço https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection