Comando de espaço de trabalho
Permite criar, excluir, exibir ou modificar propriedades e mapeamentos associados a um espaço de trabalho.
Permissões necessárias
Para modificar ou excluir um espaço de trabalho existente, você deve ser o proprietário ou ter global espaços de trabalho de administrar permissão definida Permitir. Para criar um espaço de trabalho, você deve ter o global criar um espaço de trabalho permissão definida Permitir. Para criar espaços de trabalho para outros usuários, você deve ter o espaços de trabalho de administrar permissão definida Permitir. For more information, see Permissões de Team Foundation Server.
tf workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
[/computer:computername] [/comment:("comment"|@comment file)]
[/collection:TeamProjectCollectionUrl] [/permission:(Private|PublicLimited|Public)][workspacename[;workspaceowner]][/login:username,[password]]
tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner][/login:username,[password]]
tf workspace [/collection:TeamProjectCollectionUrl] [/comment: ("comment"|@comment file)] [/newname:workspacename]
[workspacename[;workspaceowner]] [/newowner:ownername] [/computer:computername] [/permission:(Private|PublicLimited|Public)] [/login:username,[password]]
Parâmetros
Argument |
Description |
|---|---|
workspacename |
Especifica um nome para o espaço de trabalho para criar, editar, excluir ou exibir informações sobre. |
workspaceowner |
Especifica um nome de usuário do espaço de trabalho. Este parâmetro é obrigatório quando o proprietário do espaço de trabalho não é a pessoa que a execução do comando. |
computername |
Fornece um valor para o /computer opção. |
comment |
Fornece um valor para o /comment opção. |
@commentfile |
Especifica o caminho de um arquivo onde o comentário deve ser lido. |
username |
Fornece um valor para o /login opção. Você pode especificar um valor de username como domínio\nome de usuário ou nome de usuário. |
TeamProjectCollectionUrl |
A URL da coleção de projeto de equipe que contém o espaço de trabalho sobre o qual você deseja criar, editar, excluir ou exibir informações (por exemplo, http://myserver:8080/tfs/DefaultCollection). |
ownername |
Fornece um valor para o /newowner opção. |
Option |
Description |
|---|---|
/new |
Cria um novo espaço de trabalho. |
/template |
Especifica um espaço de trabalho existente para usar como modelo para criar um novo espaço de trabalho. O novo espaço de trabalho usa os mapeamentos de espaço de trabalho existente. |
/delete |
Exclui o espaço de trabalho especificado. |
/computer |
Especifica o nome do computador no qual deseja criar o espaço de trabalho. Essa opção é uma opção avançada. |
/comment |
Fornece um comentário descrevendo 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 projeto de equipe. |
/permission |
Especifica as opções de permissão do espaço de trabalho:
|
/login |
Especifica o nome de usuário e senha para autenticar o usuário com Visual Studio Team Foundation Server. |
/newowner |
Especifica o nome de usuário para o novo proprietário do espaço de trabalho. |
Comentários
A espaço de trabalho é uma cópia local dos arquivos e pastas no servidor, além de quaisquer alterações feitas localmente. Quando você adicionar, editar, excluir, move, renomear ou caso contrário, alterar qualquer item controlado por versão, as alterações são isoladas do espaço de trabalho onde você pode fazer e testar as alterações. O alterações pendentes são confirmadas para o servidor e ficam disponíveis para outros usuários fora do espaço de trabalho quando você executa um check-in.
Para obter mais informações sobre como localizar o tf o utilitário de linha de comando, consulte Comandos do utilitário de linha de comando do TF.
Criando um espaço de trabalho.
Antes de adicionar arquivos ao servidor de controle de versão ou check-out de itens no servidor, para editá-los, você deve criar um espaço de trabalho ou associar a um já existente com o diretório atual. For more information, see Criar um espaço de trabalho e arquivos de Get.
Para tornar o diretório atual de uma pasta de trabalho para um espaço de trabalho existente no seu computador, digite tf workspace workspacename, onde workspacename é o nome do espaço de trabalho existente. O Editar espaço de trabalho caixa de diálogo aparece. Clique em Clique aqui para inserir uma nova pasta de trabalho, digite o caminho do servidor para o qual você deseja mapear o diretório atual na Da pasta de controle de origem , digite o diretório atual na Pasta Local caixa e, em seguida, clique em OK.
Quando você cria um novo espaço de trabalho, você pode especificar um espaço de trabalho do modelo como parte do /new opção. Quando você especifica um espaço de trabalho do modelo, Team Foundation cria um novo espaço de trabalho no computador atual, define o proprietário para o proprietário atual e replica as seguintes propriedades do espaço de trabalho no novo espaço de trabalho do espaço de trabalho do modelo: os mapeamentos e comentário. Se nenhum nome for especificado, o sistema usa um nome com base no nome do computador atual. Quando você cria um espaço de trabalho usando um modelo, Team Foundation não recuperar os arquivos aos quais ele mapeia a partir do servidor. Use o Comando Get para sincronizar o novo espaço de trabalho com a versão mais recente no servidor.
Mapeamento de pasta única
Você pode escolher mapear somente 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 o Pasta de controle de origem caixa a Adicionar espaço de trabalho caixa de diálogo. Por exemplo, $/ pasta / *. Caso contrário, por padrão, todos os filhos da pasta de controle de versão são recursivamente mapeado para o espaço de trabalho local.
Mapeamento de pasta única dentro de uma hierarquia de controle de versão é útil porque ela limita o número de itens baixados para o computador cliente. Outra maneira de limitar os arquivos baixados é encobrir os arquivos que você não precisa ter em seu espaço de trabalho. For more information, see Encobrir e desencobrir pastas em um espaço de trabalho.. Isso proporciona tempos de download mais rápidos e poupa espaço no computador cliente em disco.
A exclusão de um espaço de trabalho.
Se você excluir um espaço de trabalho que contém as alterações, pendentes Team Foundation cancela 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 no espaço de trabalho.
Edição de um espaço de trabalho.
Você pode alterar os atributos de espaço de trabalho a seguir:
Nome do espaço de trabalho
Comment
Mapeamentos de pasta de trabalho
Se nenhuma especificação de espaço de trabalho for fornecida, o espaço de trabalho para a pasta atual é usado.
Examples
O exemplo a seguir abre o Adicionar espaço de trabalho caixa de diálogo e cria um novo espaço de trabalho. Você pode usar o Adicionar espaço de trabalho caixa de diálogo para editar a pasta de controle de origem, o proprietário, o computador, o comentário e a pastas locais.
c:\projects>tf workspace /new /collection:http://myserver:8080/tfs/DefaultCollection
O exemplo a seguir cria um novo espaço de trabalho chamado Beta1 e atribui o 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 para outro usuário. Para obter mais informações sobre permissões de segurança, consulte Permissões de Team Foundation Server.
c:\projects>tf workspace /new Beta1;jenh
O exemplo a seguir cria um novo espaço de trabalho usando o espaço de trabalho do Beta1 pertencentes a jenh como um modelo.
c:\projects>tf workspace /new /template:Beta1;jenh /collection:http://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 as propriedades do espaço de trabalho atual.
c:\projects>tf workspace
O exemplo a seguir abre o espaço de trabalho Beta1 para qual usuário o jenh é o proprietário para que você possa ver suas propriedades e os mapeamentos. Se você tiver as permissões de AdminWorkspaces, você pode alterar as propriedades do espaço de trabalho e os mapeamentos.
c:\projects> tf workspace Beta1;jenh
Consulte também
Tarefas
Criar um espaço de trabalho e arquivos de Get
Encobrir e desencobrir pastas em um espaço de trabalho.
Referência
Sintaxe de linha de comando (controle de versão)
Comando de espaços de trabalho
Conceitos
Configurar a sua máquina de desenvolvimento para trabalhar com projeto do sua equipe