Comando Label (Team Foundation Version Control)
Anexa um rótulo ou remove um rótulo de uma versão de um arquivo ou pasta no servidor para Controle de versão do Team Foundation.
Permissões necessárias
Para usar o label de comando, você deve ter o rótulo permissão definida Permitir. Para modificar ou excluir rótulos criados por outros usuários, você deve ter o os rótulos de administrar permissão definida Permitir. For more information, see Permissões de Team Foundation Server.
tf label labelname[@scope] [/owner:ownername]
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)]
[/child:(replace|merge)] [/recursive] [login:username,[password]] [/collection:TeamProjectCollectionUrl]
tf label /delete labelname[@scope]
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Parâmetros
Argument |
Description |
|---|---|
labelname |
Identifica o nome da etiqueta para anexar, modificar ou remover os itens especificados. |
@scope |
Especifica um Controle de versão do Team Foundation o diretório do servidor no qual nome_do_rótulo é exclusivo. Este parâmetro permite que você criar, gerenciar, recuperar e excluir um rótulo ou conjunto de itens rotulados quando dois rótulos de mesmo nome estiverem em diferentes partes do independentemente de Controle de versão do Team Foundation server. |
ownername |
Fornece um valor como, por exemplo, DOMAIN\JuanGo ou juango apenas para o /owner opção. |
itemspec |
Identifica o arquivo ou pasta em que deseja rotular, novo rótulo para ou modificar. Para obter mais informações sobre como Team Foundation itemspecs analisa para determinar quais itens estão dentro do escopo, consulte Sintaxe de linha de comando (controle de versão). .gif "Observação") Observação
Você pode especificar mais de um Itemspec argumento.
|
versionspec |
Fornece um valor como o c2 para o /version opção. Para obter mais informações sobre como Team Foundation analisa uma especificação de versão para determinar quais itens estão dentro de seu escopo, consulte Sintaxe de linha de comando (controle de versão). |
comment |
Um comentário sobre o rótulo fornecido pelo usuário. |
@commentfile |
O caminho fornecido pelo usuário de um arquivo no disco que contém o comentário a ser usado para o check-in. |
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 especificado que contém uma versão de um arquivo ou pasta para a qual você deseja anexar um rótulo ou do qual você deseja excluir um rótulo (por exemplo, http://myserver:8080/tfs/DefaultCollection). |
Option |
Description |
|---|---|
/owner |
Especifica o nome do usuário que possui o rótulo. |
/version |
Optional. Especifica a versão do arquivo ou pasta à qual o rótulo deve ser anexado, modificado, ou a partir da qual o rótulo deve ser removido. Estes são valores de conjunto de alterações, por exemplo, C93. Por padrão, Team Foundation usa a versão básica do espaço de trabalho, se nenhum versionspec é fornecido. |
/comment |
Adiciona ou modifica uma descrição ou comentário para o rótulo. |
/child |
Identifica como lidar com itens que têm rótulos preexistentes, que são idênticos ao rótulo especificado por você. Use Replace para atualizar a versão do item correspondente a etiqueta existente. Use Merge para deixar os itens com o existente rotular sozinhos. |
/recursive |
Etiquetas de todos os itens no diretório que corresponde ao seu itemspec e versionspec. Não pode ser usado com o /delete opção. |
/delete |
Remove o rótulo. |
/login |
Especifica o nome de usuário e senha para autenticar o usuário com Visual Studio Team Foundation Server. |
/collection |
Especifica a coleção de projeto de equipe. |
Comentários
Um rótulo é um marcador que você pode anexar a um conjunto de arquivos não relacionados e as pastas de Controle de versão do Team Foundation server. Use o rótulo para simplificar a recuperação de um espaço de trabalho para o desenvolvimento ou fins de compilação. Portanto, um rótulo é como um conjunto de alterações ou a data/hora que e para que você arbitrariamente pode adicionar e remover arquivos e pastas ou alterar as versões dos itens ali. Um rótulo é uma especificação de versão pode ser passada para o seguinte Team Foundation comandos:
Tipos comuns de rótulos são rótulos de etapa do projeto como, por exemplo, "M1" "beta2,". ou "Release Candidate 0".
Rótulos são específicas da versão, ou seja, você só poderá anexar um rótulo a uma versão de um arquivo ou pasta. Cada versão de um item pode oferecer suporte a várias etiquetas.
Um rótulo não é um objeto versionado; Portanto, o histórico de rótulo de arquivos não é controlado. Além disso, uma operação de rótulo não cria uma alteração pendente no seu espaço de trabalho. Quando você emitir o label comando, a atualização imediatamente refletida na Controle de versão do Team Foundation server.
Para obter mais informações sobre como encontrar o tf o utilitário de linha de comando, consulte Comandos do utilitário de linha de comando do TF.
Removendo e excluindo rótulos
Você pode usar o Unlabel de comando para remover um rótulo de um arquivo ou pasta. Como alternativa, você pode excluir um rótulo do sistema usando o tf label /delete comando.
Para obter informações sobre uma etiqueta existente que inclui uma lista dos itens aos quais o rótulo foi anexado, o seu comentário, o escopo e o proprietário, consulte Comando de etiquetas.
Gerenciando sobrecarregados rótulos
Nomes de rótulo devem ser exclusivos em todo um escopo especificado. Quando você adiciona um rótulo, você pode reservar o uso desse nome de rótulo em ou sob o escopo especificado ou implícito. O valor padrão para o @ escopo parâmetro é o projeto de equipe, por exemplo, $/ TeamProject1.
Se outro usuário ou equipe adiciona um rótulo comuns como, por exemplo, "m3" um conjunto de arquivos com controle de versão em uma parte diferente do Controle de versão do Team Foundation server, você pode aplicar o rótulo M3 para controle de versão de arquivos em seu projeto desde que o projeto raiz pastas estiverem em diferentes diretórios. Por exemplo, se os arquivos no diretório $/ matemática são rotulados como "m3,". Você pode aplicar "m3" para arquivos no diretório $/ projetos.
Para obter, remover um rótulo ou caso contrário, gerenciar seus itens rotulados-M3, você deve especificar o parâmetro @ escopo para informar ao Team Foundation M3 etiqueta você deseja trabalhar.
Você pode impedir que outros usuários "sobrecarga" um rótulo como "m3" em partes diferentes da Controle de versão do Team Foundation o servidor, criando sua etiqueta na raiz ($ /) da Controle de versão do Team Foundation server ou ajustando as permissões de rótulo para determinadas pastas.
Usando a opção /Child para evitar a rotulagem de incidentes
Se você emitir um label comando junto com um nome de rótulo pré-existentes e um itemspec que inclui os arquivos que já estão marcados pelo mesmo rótulo, o valor da /child opção determina se os arquivos marcados são atualizados com novas informações de revisão. Ou seja, os arquivos são rotulados com o mesmo nome, mas têm escopo diferente.
Por exemplo, suponha que você tenha a pasta denominada c:\projects contém dois arquivos, o cs de 314. e 271.cs. Presuma também que a versão C70 do 314. cs é rotulado como "pronto". A versão mais recente do sistema de coordenadas de 314. é C93. Se você aplicar um rótulo, "pronto" para a versão mais recente da pasta e os arquivos que nela contidos, usando o comando a seguir, "pronto" rótulo é movido de 314.cs;C70 para 314.cs;C93:
tf label ready c:\projects /recursive /version:T /child:Replace
Por outro lado, se você não deseja mover o existente rotular "pronto" da versão C70 para a versão C93 do 314.cs, você usaria a seguinte sintaxe:
tf label ready c:\projects /recursive /version:T /child:Merge
Quando você especificar Merge como o valor da opção /child, instâncias pré-existente do rótulo emitido são deixadas sozinhos.
| Observação |
|---|
T é usado para "Dica" Para obter a última versão do versionspec no acima dois exemplos. |
Examples
O exemplo a seguir anexa "goodbuild" rótulo para a versão de espaço de trabalho do "documentos" pasta de arquivos e pastas que ele contém.
c:\projects>tf label goodbuild docs /recursive
O exemplo a seguir anexa "goodbuild" rótulo para os "documentos" pasta mas não os arquivos e pastas na pasta docs contém.
c:\projects>tf label goodbuild docs
O exemplo a seguir anexa "goodbuild" rótulo à versão 3 do sistema de coordenadas de 314. a Controle de versão do Team Foundation server.
c:\projects>tf label goodbuild /version:3 $/src/314.cs
O exemplo a seguir exclui "badbuild" rótulo de todos os itens do Controle de versão do Team Foundation server.
c:\projects>tf label /delete badbuild
O exemplo a seguir usa a opção de escopo para aplicar um rótulo para 314.cs.
c:\projects>tf label goodbuild@$/TeamProject1 314.cs
Consulte também
Referência
Sintaxe de linha de comando (controle de versão)
Conceitos
Usar rótulos para tirar um instantâneo dos seus arquivos
Usar rótulos para tirar um instantâneo dos seus arquivos