Comando de rótulo (Team Foundation controle de versão)
Anexa um rótulo ou remove um rótulo de uma versão de um arquivo ou pasta no Controle de versão do Team Foundation servidor.
Permissões necessárias
Para usar o label comando, você deve ter o Rótulo permissão conjunto para Permitir.Para modificar ou excluir etiquetas criadas por outros usuários, você deve ter o Administrar rótulos permissão definido como Permitir.Para obter mais informações, consulte Permissões de Team Foundation Servidor.
tf label [/server:servername] labelname[@scope] [/owner:ownername]
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)]
[/child:(replace|merge)] [/recursive]
tf label [/server:servername] /delete labelname[@scope]
[/owner:ownername] itemspec [/version:versionspec]
Parâmetros
Argumento |
Descrição |
|---|---|
servername |
O valor fornecido pelo usuário para o /server opção. Exemplo: teamfoundation2. |
labelname |
Identifica o nome do rótulo para anexar, modificar ou remover os itens especificados. |
@scope |
Especifica um Controle de versão do Team Foundation diretório do servidor no qual o nome_do_rótulo é exclusivo. Este parâmetro permite 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 independentementeControle de versão do Team Foundation servidor. |
ownername |
Fornece um valor sistema autônomo domínio\JuanGo ou juango apenas à /owner opção. |
itemspec |
Identifica o arquivo ou pasta da qual rótulo, re-rótulo, ou modificar.Para obter mais informações sobre como Team Foundation analisa itemspecs para determinar quais itens estão dentro do escopo, consulte Sintaxe de linha de comando (Team Sistema). |
versionspec |
Fornece um valor, sistema autônomo 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 do seu escopo, consulte Sintaxe de linha de comando (Team Sistema). |
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. |
Opção |
Descrição |
|---|---|
/server |
Identifica o Team Foundation Server. Esta opção é necessária se o comando é chamado de um diretório que não está mapeado para um espaço de trabalho. |
/owner |
Especifica o nome do usuário que possui o rótulo. |
/version |
Opcional especifica a versão do arquivo ou pasta à qual o rótulo deve ser anexado, modificadas, ou do qual o rótulo deve ser removido.Estes são valores de conjunto de alterações, por exemplo, C93.Por padrão, Team Foundation utiliza a versão básica do espaço de trabalho se nenhum versionspec é fornecida. |
/comment |
Adiciona ou modifica uma descrição ou comentário para o rótulo. |
/child |
Identifica como lidar com itens que possuem rótulos pré-existentes que são idênticos ao rótulo especificado.Use Replace Para atualizar a versão do item correspondente à existente rótulo. Use Merge deixar apenas itens com o rótulo existente. |
/recursive |
Nomeia 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. |
Comentários
Um rótulo é um marcador que você pode anexar a um conjunto de arquivos não relacionados e pastas no Controle de versão do Team Foundation servidor. Use a etiqueta para simplificar a recuperação da um espaço de trabalho para o desenvolvimento ou criar fins.Portanto, um rótulo é como um conjunto de alterações ou data/time para o qual e do qual você arbitrariamente adicionar e remover arquivos e pastas ou alterar versões dos itens ali.Um rótulo é uma especificação de versão que pode ser passada para o seguinte Team Foundation comandos:
Tipos comuns de rótulos são rótulos de etapa do projeto sistema autônomo "M1", "Beta2" ou "versão Release Candidate 0".
Rótulos de versão específicos, 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 oferece suporte a várias etiquetas.
Um rótulo não é um objeto com versão; 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 alterar pendente em seu espaço de trabalho.Quando você executar o label comando, a atualização imediatamente refletida no Controle de versão do Team Foundation servidor.
Para obter mais informações sobre como localizar o TF utilitário de linha de comando, consulte Comandos do utilitário de linha de comando TF.
Removendo e excluindo etiquetas
Você pode usar o Comando unlabel Para remover um rótulo de um arquivo ou pasta. Alternatively, you can delete a label from the system using the tf label /delete command.
Para obter informações sobre uma etiqueta existente que inclui uma lista de itens ao qual o rótulo foi anexado, seu comentário, o escopo e o proprietário, consulte Comando de etiquetas.
Gerenciar rótulos sobrecarregados
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 abaixo do escopo especificado ou implícito.O valor padrão para o @ escopo parâmetro é o projeto da equipe, for example, $/TeamProject1.
Se outro usuário ou equipe adiciona um rótulo comuns, sistema autônomo "M3" a um conjunto de arquivos com controle de versão em uma parte diferente daControle de versão do Team Foundation servidor, você pode aplicar o rótulo M3 a arquivos com controle de versão no seu projeto, desde que sistema autônomo pastas de projeto raiz estejam em pastas diferentes. Por exemplo, se arquivos no diretório $ / matemática são rotulados "M3", você pode aplicar "M3" para arquivos no diretório $ / projetos.
Para obter, remover um rótulo ou gerenciar seus itens rotulados M3 caso contrário, você deve especificar o parâmetro @ escopo dizer Team Foundation que rótulo M3 que você deseja trabalhar com.
Impedir que outros usuários "sobrecarga" um rótulo sistema autônomo "M3" em partes diferentes dasControle de versão do Team Foundation servidor, criando sua etiqueta na raiz ($ /) dos Controle de versão do Team Foundation servidor ou ajustando sistema autônomo permissões de rótulo para determinadas pastas.
Usando a opção /filho para evitar a rotulagem incidentes
Se você emitir um label comando junto com um nome de rótulo pré-existentes e um itemspec que inclui arquivos que já são marcados por mesma etiqueta, 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 pasta c:\projects contém dois arquivos, 314. cs e 271.cs de chamada.Também presumem que a versão que C70 de cs 314. é rotulada "pronto". A versão mais recente do cs 314. é a versão C93.Se você aplicar um rótulo "pronto" para a versão mais recente da pasta e arquivos nela contidos, usando o comando a seguir, o rótulo "pronto" é movido do 314.cs;C70 para 314.cs;C93:
tf label ready c:\projects /recursive /version:T /child:Replace
Por Outros lado, se desejar mover o rótulo existente "pronto" da versão C70 versão C93 do 314.cs, você usaria a seguinte sintaxe:
tf label ready c:\projects /recursive /version:T /child:Merge
Quando você especifica Merge sistema autônomo o valor da opção /filho, instâncias preexistentes do rótulo emitido são deixadas sozinhos.
.gif "Observação") Observação: |
|---|
T é usada para "Dica" para obter a versão mais recente do versionspec nos dois exemplos acima. |
Exemplos
O exemplo a seguir anexa o rótulo "goodbuild" para a versão do espaço de trabalho da pasta "documentos" e os arquivos e pastas que ela contém.
c:\projects>tf label goodbuild docs /recursive
O exemplo a seguir anexa o rótulo "goodbuild" pasta "documentos", mas não a arquivos e pastas que contém a pasta docs.
c:\projects>tf label goodbuild docs
O exemplo a seguir anexa o rótulo "goodbuild" versão 3 do cs 314. naControle de versão do Team Foundation servidor.
c:\projects>tf label goodbuild /version:3 $/src/314.cs
O exemplo a seguir exclui o rótulo "badbuild" de todos os itens naControle de versão do Team Foundation servidor.
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
Tarefas
Demonstra Passo a passo: Funcionalidade Avançado de Controlarar de versão
Conceitos
Referência
Sintaxe de linha de comando (Team Sistema)