Comando Conjunto de alterações

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Exibe informações e permite alterar os atributos, como comentários e observação de check-in, associados a um conjunto de alterações.

Pré-requisitos

Para usar o comando changeset, você deve ter a permissão Leitura definida como Permitir para arquivos ou pastas no conjunto de alterações para o qual você deseja exibir informações completas. Os únicos usuários que podem modificar as observações e comentários associados a um conjunto de alterações são os usuários que criaram o conjunto de alterações ou um usuário que tem a permissão global Revisar alterações de outro usuário.

Para saber mais, consulte Permissões padrão do TFVC.

Sintaxe

tf changeset [/comment:("comment"|@commentfile)] 
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]] 
[changesetnumber | /latest][/login:username,[password]]

Parâmetros

Argumento

Argument Descrição
comment Fornece um comentário sobre o check-in.
@<commentfile> Especifica um caminho de um arquivo no disco que contém o comentário usado para check-in.
<NoteFieldName>=<NoteFieldValue> Define o valor do campo Observação de check-in. Você pode fornecer várias expressões separadas por ponto e vírgula field=value.
@<notefile> Fornece o caminho de um arquivo no disco que contém valores e nomes do campo Observação de check-in no formato de field=value com um por linha.
<TeamProjectCollectionUrl> O URL da coleção de projetos que contém um conjunto de alterações sobre o qual deseja exibir informações ou cujos atributos deseja modificar, por exemplo, http://myserver:8080/tfs/DefaultCollection.
<username> Mostra um valor para a opção /user. Você pode especificar esse argumento como Domain\username ou username.
<changesetnumber> Identifica o conjunto de alterações a ser revisado ou modificado. Não pode ser usado com /latest.

Opção

Opção Descrição
/comment Substitui o comentário do conjunto de alterações que foi criado durante o processo de check-in por um novo comentário.
/notes Fornece uma ou mais observações de check-in para associar ao conjunto de alterações.
/latest Especifica o conjunto de alterações mais recente. Não pode ser usado com <changesetnumber>.
/noprompt Suprime quaisquer prompts de entrada.
/collection Especifica a coleção de projetos.
/login Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps.

Comentários

Um conjunto de alterações é um conjunto de revisões de arquivos e pastas que foram confirmadas no servidor de controle de versão do Team Foundation como parte do mesmo evento de check-in. Para obter mais informações, consulte Trabalhar com conjunto de alterações.

É possível usar o comando changeset para exibir os atributos de um conjunto de alterações e modificar suas propriedades. É possível usar o comando history para determinar sobre qual conjunto de alterações queira obter informações. Para obter mais informações, consulte Comando Histórico.

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

Exemplos

O exemplo a seguir exibe informações detalhadas sobre o conjunto de alterações 8675309 em um formato editável na caixa de diálogo Detalhes do Conjunto de Alterações 8675309 – Arquivos de Origemno Visual Studio e substitui o comentário existente por Este é um novo comentário.

c:\projects>tf changeset /comment:"This is a new comment." 8675309

Depois de inserir o comando, na caixa de diálogo Detalhes do Conjunto de Alterações 8675309 – Arquivos de Origemno Visual Studio, selecione Salvar para associar o comentário ao conjunto de alterações.

O exemplo a seguir mostra duas observações de check-in para associar ao conjunto de alterações.

c:\projects>tf changeset /notes:reviewer=Jo;Security = checked 8675309

O exemplo a seguir mostra duas observações de check-in que incluem espaços nos valores e nomes a serem associados ao conjunto de alterações.

c:\projects>tf changeset /notes:"Code Reviewer"="John Smith";"Security Reviewer"="Chen Yang" 8675309

O exemplo a seguir associa as observações de check-in incluídas no arquivo notes.txt ao conjunto de alterações 8675309.

c:\projects>tf changeset /notes:@notes.txt 8675309

Quando o notes.txt pode estar no seguinte formato:

field1=value1;
field2=value that
spans multiple
lines;
field3 = value3;

O exemplo a seguir substitui o comentário existente para o conjunto de alterações 8675309 e exibe informações sobre o conjunto de alterações na janela do prompt de comando. Este exemplo não abre a caixa de diálogo Conjunto de alterações do Visual Studio.

c:\projects>tf changeset /comment:"This is an automatically generated comment." /noprompt 8675309

O exemplo a seguir exibe informações não editáveis sobre o conjunto de alterações 8675309 na janela do prompt de comando.

c:\projects>tf changeset 8675309 /noprompt

Saída de exemplo:

Changeset: 8675309
User: DOMAIN\JohnG
Date: 01/21/2004 21:03:45
Comment:  This check-in fixes issues in several features.  I also refactored some items in buf.c into a new file named bif.c because buf.c was too hard to parse.
Items:
    $/baz/proj/bif.c           Added
    $/baz/proj/buf.c          Modified, Renamed
Work Items:
    34527     The "Access Denied" message isn't descriptive enough.
    35628     The UI flickers when I press the '8', 'y', 'Ctrl', and 'End' buttons at the same time.
Check-in Notes:
    Code Reviewer:  ShellM
    Performance Reviewer: ShellM
    Security Reviewer: ShellM