Comando Get
Recupera uma cópia somente leitura de um arquivo do servidor para Controle de versão do Team Foundation o espaço de trabalho e cria as pastas no disco para conter o proprietário.
Permissões necessárias
Para usar o get de comando, você deve ter o leitura permissão definida Permitir para cada item recuperada e você deve tanto possuir o espaço de trabalho de destino ou tiver global espaços de trabalho de administrar permissão. For more information, see Permissões de Team Foundation Server.
tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force]
[/preview] [/recursive] [/remap] [/noprompt] [/login:username,[password]]
Parâmetros
Argument |
Description |
|---|---|
Itemspec |
Arquivo ou pasta para recuperar. Não se for fornecido nenhum itemspec, Team Foundation Server executa uma operação de get recursiva em todos os itens que são mapeados no espaço de trabalho atual. .gif "Observação") Observação
Você pode especificar mais de um Itemspec argumento.
|
Versionspec |
O valor fornecido pelo usuário para o /version opção. Para obter mais informações sobre como Team Foundation Server 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). |
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. |
Option |
Description |
|---|---|
/version |
Especificação de versão opcional. O versionspec é a versão do item que você deseja recuperar. Você pode especificar uma versão por:
|
/all |
Força todos os arquivos a serem recuperados, não apenas aqueles que estão desatualizados. |
/overwrite |
Substitui arquivos graváveis que não são checked out. |
/force |
Combina /all e /overwrite. |
/preview |
Exibe o que ocorreria, sem realmente executar o Get operação. |
/recursive |
Recursivamente recupera todos os itens que correspondem ao seu itemspec. |
/noprompt |
Suprime as caixas de diálogo que seriam exibidas durante a operação. |
/remap |
Atualiza o mapeamento de local no servidor e re-downloads o arquivo mais rápido se você já tiver baixado o mesmo arquivo de outra ramificação. Observação
Essa opção melhor é usada quando você não tem um mapeamento local complexo e com freqüência, você deve alternar entre ramificações.
|
/login |
Especifica o nome de usuário e senha para autenticar o usuário com Team Foundation Server. |
Comentários
O get comando recupera itens do servidor em um espaço de trabalho. Não se for fornecida nenhuma outra versão, a versão mais recente do servidor é recuperada.
Se você trabalha em um ambiente de desenvolvimento de equipe, get é o comando que você usa com mais freqüência porque obter todos os arquivos no projeto atual sincroniza com a sua equipe e torna-se de que a cópia mais recente do trabalho compartilhado. O get comando não substituir os arquivos que você fez check-out no diretório local. Quanto maior a freqüência de executar o get comando em um ambiente de trabalho colaborativo, atual mais os arquivos locais forem da equipe. Isso ocorre porque um get operação preenche o espaço de trabalho local com as alterações que foram verificados no servidor por seus colegas. Se você mantiver seu espaço de trabalho atualizada, realizando uma get operação sempre que você receber uma notificação de check-in (a partir de alertas do projeto, por exemplo), você pode resolver rapidamente as diferenças entre a sua versão de um projeto e a versão do servidor do projeto. Você pode evitar fazer alterações que não podem ser fácil reconciliar com o servidor quando você faz check in suas alterações pendentes.
Durante um get operação, se sua versão do espaço de trabalho é o mesmo que a versão do servidor solicitado, Team Foundation Server não substitui o arquivo no disco, a menos que o /all opção é especificada. Você pode usar o /overwrite opção forçosamente sobrescrever a versão gravável de espaço de trabalho atual com uma versão de servidor especificado para restaurar o seu espaço de trabalho para um estado consistente quando ele se tornar impossível de gerenciar, como às vezes ocorre quando você excluir ou substituir acidentalmente vários arquivos em disco. Quando você passar o /force opção, Team Foundation Server substitui todos os check-out de itens no espaço de trabalho com a versão mais recente do servidor, a menos que você forneça uma versão específica.
Quando você executa um get operação, Team Foundation Server exclui quaisquer arquivos com check-in do espaço de trabalho local que tiverem sido excluídos do servidor após a última vez que você sincronizou o seu espaço de trabalho para a versão do servidor. Os arquivos que tenham sido renomeados ou movidos no servidor são realocados no disco para coincidir com as alterações no servidor.
Você pode usar o /preview a opção de problema de get comando sem fazer atualizações no espaço de trabalho local para ver o que ocorreria se você fosse executar Obtenha um real de operação.
A operação de check-out não executa uma operação mais recente de get para check-out de arquivos
Como um desenvolvedor trabalhando em um espaço de trabalho, são isolados das alterações que foram feitas por outros desenvolvedores. Controle de quando você aceita as alterações de outros desenvolvedores, realizando uma operação get, conforme apropriado. Idealmente, você pode atualizar a configuração completa de arquivos com controle de versão e não apenas um ou dois arquivos porque alterações em um arquivo normalmente dependem as alterações correspondentes para outros arquivos. Você deve certificar-se de que você tenha um instantâneo consistente dos arquivos de controle de versão que podem ser criados e testados.
Portanto a operação de check-out não executar get mais recentes nos arquivos de check-out. Check-out de um arquivo de atualização violaria o instantâneo consistente e poderia dar a você uma configuração de arquivos com controle de versão que não podem ser criados ou testados. Como alternativa Team Foundation Server obriga você a realizar a operação mais recente em algum momento antes de você check-in suas alterações para que, quando tentar fazer check-in suas alterações, e você não tem a cópia mais recente, é solicitado com a caixa de diálogo do resolver os conflitos.
Você também pode configurar Team Foundation Server para obter automaticamente mais recentes em check-out. For more information, see Definir configurações de Check-Out..
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.
O processo de Get
Quando você emite uma get comando de um item do servidor e que já check-out no seu espaço de trabalho e a versão do servidor foi alterado, você precisará resolver os conflitos de arquivo entre o espaço de trabalho e recuperadas server versão. Para obter mais informações, consulte o Resolver o comando.
Examples
O exemplo a seguir recupera a versão mais recente do sistema de coordenadas de 314. do servidor. Se você tiver pendentes alterações de 314.cs, Team Foundation Server inicia o processo de resolução que o ajuda a decidir como lidar com conflitos.
C:\projects>tf get 314.cs
O exemplo a seguir recupera a versão 8 do 1256.cs do servidor.
| Observação |
|---|
Usar o 1256.cs;8 é equivalente a usar o 1256.cs;C8. Por padrão, a versão do changeset é usada se você especificar apenas um número após o ponto e vírgula. |
C:\>tf get 1256.cs;8
O exemplo a seguir recupera as versões mais recentes de todos os itens desencobertos da pasta do servidor e de subpastas para a pasta C:\projects e cria as pastas locais onde são necessárias. Para obter mais informações sobre como encobrir e desencobrir pastas, consulte Comando workfold.
C:\projects>tf get
Os exemplos a seguir oferecem maneiras alternativas de recuperar a versão do 1256.cs que foi verificada com o conjunto de alterações de 1999.
c:\projects>tf get /version:C1999 1256.cs
—or—
c:\projects>tf get 1256.cs;C1999
O exemplo a seguir recupera a versão de todos os itens desencobertos do servidor, como eram no servidor quando changeset 271 foi criado.
c:\projects>tf get /version:C271
O exemplo a seguir recupera o build42, rotulado como "build42". Isso corresponde ao seu espaço de trabalho para o rótulo como existem alterações pendentes. Todos os arquivos não no rótulo são removidos do disco local.
c:\projects>tf get /version:Lbuild42
O exemplo a seguir recupera a versão no servidor a partir de uma data e hora específicas.
c:\projects>tf get /version:D2008-01-21T16:00
Consulte também
Tarefas
Obter o código-fonte para o projeto de equipe
Encobrir e desencobrir pastas em um espaço de trabalho.