Partilhar via

Comando Reconcile (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) tf reconcile compara o estado atual do espaço de trabalho no disco com a exibição do servidor, seja para limpar o espaço de trabalho ou para promover alterações locais não corrigidas.

Pré-requisitos

Consulte Permissões padrão do TFVC.

Sintaxe

tf reconcile [itemspec]
/clean [/diff] [/noprompt] [/preview] [/recursive] [/ignore]
[/unmapped] [/exclude:itemspec1,itemspec2,...] 

tf reconcile [itemspec]
/promote [/adds] [/deletes] [/diff] [/noprompt] [/preview]
[/recursive] [/noignore] [/exclude:itemspec1,itemspec2,...]

Parâmetros

Argumentos

Argumento

Descrição

<itemspec>

Identifica o arquivo ou pasta para o qual aplicar o comando reconcile. Se omitido, todos os itens adequados são incluídos. Para obter mais informações sobre como o TFVC analisa um itemspec para determinar quais itens estão dentro do escopo, consulte Usar comandos de controle de versão do Team Foundation.

Observação

Você pode especificar mais de um itemspec argumento.

Opções

Opção

Descrição

/clean

Atualiza itens locais no disco para corresponder à estrutura do servidor. Remove itens que não estão presentes no controle de versão e adiciona itens que estão ausentes no disco, mas presentes no controle de versão.

/promote

Promove alterações de arquivo local no controle de versão. Adiciona itens criados localmente ao controle de versão, semelhante ao tf add, e remove itens excluídos localmente.

Observação

Especifique /adds e/ou /deletes ao usar com /noprompt.

/adds

Promove arquivos e pastas adicionados localmente ao controle de versão.

Observação

Pode usar apenas com /promote.

/deletes

Promove arquivos e pastas excluídos para controle de versão.

Observação

Pode usar apenas com /promote.

/exclude

Ignora itens separados por vírgulas especificados nesta opção.

Observação

Esta opção substitui as opções /ignore, /noignoree /unmapped em caso de interseções.

/unmapped

Substitui o padrão e limpa itens não mapeados e encobertos. Por padrão, itens não mapeados e encobertos não são afetados pelo comando /clean. Para obter mais informações, consulte Mapeamentos (espaço de trabalho).

Observação

Pode usar apenas com /clean.

/diff

Compara itens com controle de origem usando hashes MD5. Use esta opção para detetar itens que são diferentes da versão do espaço de trabalho, mas ainda têm seus bits somente leitura definidos (+R).

/preview

Exibe o que ocorreria, sem realmente fazer a operação reconcile.

/ignore

Substitui o padrão e não altera itens ignorados. Por padrão, o /clean atualiza todos os itens com base no estado atual do servidor, incluindo itens ignorados pelo controle de versão. Use esta opção para evitar alterar os itens ignorados.

Você pode configurar quais itens são ignorados usando um arquivo de .tfignore. Para obter mais informações, consulte Personalizar quais arquivos o controle de versão ignora.

Observação

Pode usar apenas com /clean.

/noignore

Substitui o padrão e promove itens ignorados. Por padrão, /promote promove todos os itens, exceto os itens que são ignorados pelo controle de versão. Use essa opção para promover os itens ignorados também. Esta opção é semelhante ao uso de /noignore no comando tf add.

Observação

Pode usar apenas com /promote.

/recursive

Reconcilia itens no diretório e subdiretórios específicos.

/noprompt

Suprime a exibição de janelas e caixas de diálogo e redireciona os dados de saída para o prompt de comando. Consulte Usar comandos de controle de versão do Team Foundation.

Observações

Você pode usar o comando reconcile para sincronizar o estado do espaço de trabalho local com o estado do servidor.

  • Use /clean para atualizar o espaço de trabalho local de acordo com o estado do servidor.
  • Use /promote para promover itens adicionados e excluídos localmente para alterações pendentes no controle de versão.

Para obter mais informações sobre como usar o utilitário de linha de comando tf, consulte Usar comandos de controle de versão do Team Foundation.

Exemplos

Limpeza

O exemplo a seguir abre a caixa de diálogo Visual Studio Clean Workspace, para que você possa especificar itens locais que devem ser excluídos ou baixados novamente do servidor.

tf reconcile /clean

O exemplo a seguir limpa todos os itens locais, exceto os itens que são ignorados pelo controle de versão.

tf reconcile /clean /ignore

O exemplo a seguir limpa todos os itens locais, incluindo itens não mapeados e encobertos.

tf reconcile /clean /unmapped

O exemplo a seguir limpa todos os itens, exceto file1.txt e dir1 com todo o seu conteúdo, e não exibe a caixa de diálogo Espaço de Trabalho Limpo.

tf reconcile /clean /noprompt /recursive /exclude:file1.txt,dir1

Promova

O exemplo a seguir abre a caixa de diálogo Visual Studio Promote Candidate Changes, para que você possa especificar quais itens devem ser promovidos para alterações pendentes.

tf reconcile /promote

O exemplo a seguir promove todos os itens, incluindo itens ignorados pelo controle de versão, exceto o arquivo myLib.dll.

tf reconcile /promote /noignore /exclude:myLib.dll

O exemplo a seguir adiciona todos os itens criados localmente às alterações pendentes do controle de versão, sem abrir a caixa de diálogo Promover alterações candidatas. Este comando é semelhante ao comando tf add /noprompt.

tf reconcile /promote /adds /noprompt

O exemplo a seguir adiciona todos os itens excluídos localmente às alterações pendentes do controle de versão, sem abrir a caixa de diálogo Promover alterações candidatas.

tf reconcile /promote /deletes /noprompt