Comando Workspaces (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) workspaces exibe informações sobre espaços de trabalho no sistema e atualiza informações armazenadas em cache sobre uma alteração de nome de usuário ou nome de computador em um servidor Azure DevOps.
Pré-requisitos
Para usar o workspaces comando, você deve ter a permissão de leitura 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 workspaces comando.
Argumentos
Argumento
Descrição
<owner-name>
Fornece um valor para a /owner opção. Use uma cadeia de caracteres vazia ("") para corresponder aos espaços de trabalho criados por qualquer usuário.
<computer-name>
Fornece um valor para a /computer opção. Use uma cadeia de caracteres vazia ("") para corresponder aos espaços de trabalho em qualquer computador.
<workspace-name>
Especifica o nome de um espaço de trabalho sobre o qual exibir informações. Se um valor não for especificado, serão exibidas informações sobre todos os espaços de trabalho em um servidor. Você também pode usar um caractere curinga asterisco (*) para exibir informações sobre todos os espaços de trabalho de um servidor.
<old-user-name>
Fornece o nome de usuário antigo para a /updateUserName opção.
<old-computer-name>
Fornece o nome do computador antigo para a /updateComputerName opção.
<team-project-collection-url>
A URL da coleção de projetos que contém os espaços de trabalho sobre os quais você deseja exibir informações, 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
/owner
Especifica o nome do usuário que criou o espaço de trabalho. Se nenhum proprietário for especificado, o TFVC retornará informações sobre espaços de trabalho pertencentes apenas ao usuário atual.
/computer
Especifica o nome de um computador cliente pelo qual filtrar a lista de espaços de trabalho para o servidor. Se nenhum computador for especificado, o TFVC retornará informações sobre espaços de trabalho somente no computador atual.
/format
Especifica o formato das informações do espaço de trabalho. Brief Retorna informações do espaço de trabalho sem mapeamentos. Detailed Retorna informações do espaço de trabalho e também os mapeamentos. Xml Retorna informações do espaço de trabalho, 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 /collection opção é especificada. Brief é o valor padrão.
/updateUserName
Atualiza as informações de identificação de segurança no servidor de DevOps do Azure 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 /collection opção.
/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 /collection opção.
/remove
Remove as entradas de espaço de trabalho 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 Azure DevOps Server.
Observações
O workspaces comando do tf utilitário de linha de comando exibe informações sobre espaços de trabalho no computador atual, de propriedade de um usuário especificado ou para todos os espaços de trabalho associados a um servidor DevOps do Azure específico. Para cada espaço de trabalho, o TFVC exibe o nome, o proprietário, o comentário e o nome do computador. Com saída detalhada, ele também mostra os mapeamentos do espaço de trabalho. A menos que você forneça um filtro, como o proprietário, o computador ou o nome do espaço de trabalho, o TFVC exibe apenas informações sobre os espaços de trabalho que você criou.
Para obter mais informações sobre como editar propriedades do espaço de trabalho, consulte Comando 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.
Exemplos
O exemplo a seguir exibe uma lista de todos os espaços de trabalho para o usuário atual no computador atual:
c:\projects>tf workspaces
O exemplo a seguir exibe uma lista de todos os espaços de trabalho 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 espaços de trabalho 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 espaço de trabalho WS1, que pertence ao usuário atual e está localizado no computador atual. As informações exibidas incluem uma lista de mapeamentos de espaço de trabalho.
c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1
O exemplo a seguir remove todos os espaços de trabalho 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