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 TFVC (Controle de Versão do Team Foundation) workspaces exibe informações sobre workspaces no sistema e atualiza informações armazenadas em cache sobre uma alteração de nome de usuário ou de computador em um servidor do Azure DevOps.
Pré-requisitos
Para usar o comando workspaces, tenha a permissão Ler definida como Permitir. Para obter mais informações, consulte permissões TFVC padrão.
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
As seções a seguir descrevem argumentos e opções do comando workspaces.
Argumentos
de argumento
descrição
<owner-name>
Fornece um valor para a opção /owner. Use uma cadeia de caracteres vazia ("") para corresponder aos workspaces criados por qualquer usuário.
<computer-name>
Fornece um valor para a opção /computer. Use uma cadeia de caracteres vazia ("") para corresponder a workspaces em qualquer computador.
<workspace-name>
Especifica o nome de um workspace sobre o qual exibir informações. 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 asterisco (*) para exibir informações sobre todos os workspaces de um servidor.
<old-user-name>
Fornece o nome de usuário antigo para a opção /updateUserName.
<old-computer-name>
Fornece 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>
Fornece um valor para a opção /login. Você pode especificar esse valor como DOMAIN\<username> ou <username>.
<password>
Fornece 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 qual filtrar a lista de workspaces para o servidor. Se nenhum computador for especificado, o TFVC retornará informações sobre workspaces somente no computador atual.
/format
Especifica o formato das informações do workspace.
Brief retorna informações de workspace sem mapeamentos.
Detailed retorna informações do workspace e também os 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 as informações de identificação de segurança no servidor do Azure DevOps para um usuário cujo nome de usuário de rede foi alterado. Se você especificar essa opção, também deverá especificar uma coleção de projetos usando 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 deverá especificar uma coleção de projetos usando a opção /collection.
/remove
Remove as entradas de workspace especificadas para a coleção de projetos especificada do 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 com o Servidor do Azure DevOps.
Observações
O comando workspaces do utilitário de linha de comando tf exibe informações sobre workspaces no computador atual, de propriedade de um usuário especificado ou para 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, ela também mostra os mapeamentos do workspace. A menos que você forneça um filtro, como o proprietário, o computador ou o nome do workspace, o TFVC exibirá apenas informações sobre os workspaces que você criou.
Para obter mais informações sobre como editar propriedades do workspace, consulte comando 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.
Exemplos
O exemplo a seguir exibe uma lista de todos os workspaces para o usuário atual no computador atual:
c:\projects>tf workspaces
O exemplo a seguir exibe uma lista de todos os workspaces para 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 exibidas 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 em cache 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