Comando Changeset
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Exibe informações sobre e permite alterar os atributos, como comentários e anotações de check-in, associados a um conjunto de alterações.
Pré-requisitos
Para usar o comando changeset
, tenha a permissão Ler 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 anotaçõ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 o Revisar as alterações de outros usuários permissão global.
Para obter mais informações, consulte permissões TFVC padrão.
Sintaxe
tf changeset [/comment:("comment"|@commentfile)]
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]]
[changesetnumber | /latest][/login:username,[password]]
Parâmetros
Argumento
de argumento |
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 o check-in. |
<NoteFieldName>=<NoteFieldValue> |
Define o valor do campo de anotação de check-in. Você pode fornecer várias expressões field=value separadas por ponto-e-vírgula. |
@<notefile> |
Fornece o caminho de um arquivo no disco que contém nomes e valores de campo de anotação de check-in no formato de field=value com um por linha. |
<TeamProjectCollectionUrl> |
A URL da coleção de projetos que contém um conjunto de alterações sobre o qual você deseja exibir informações ou cujos atributos você deseja modificar, por exemplo, http://myserver:8080/tfs/DefaultCollection . |
<username> |
Fornece 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 anotaçõ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 qualquer solicitação de entrada de você. |
/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. |
Observações
Um conjunto de alterações é um conjunto de revisões de arquivo e pasta 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 Trabalhando com conjuntos de alterações.
Você pode usar o comando changeset
para exibir os atributos de um conjunto de alterações e modificar suas propriedades. Você pode usar o comando history
para determinar sobre qual conjunto de alterações deseja obter informações. Para obter mais informações, consulte de Comando de Histórico.
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
O exemplo a seguir exibe informações detalhadas sobre 8675309 de conjunto de alterações em um formato editável na caixa de diálogo Detalhes do do Visual Studio para Conjunto de Alterações 8675309 – Arquivos de Origem 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 8675309 do do Visual Studio – Arquivos de Origem, selecione Salvar para associar o comentário ao conjunto de alterações.
O exemplo a seguir fornece duas notas de check-in a serem associadas ao conjunto de alterações.
c:\projects>tf changeset /notes:reviewer=Jo;Security = checked 8675309
O exemplo a seguir fornece duas notas 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 notas de check-in incluídas no arquivo notes.txt ao conjunto de alterações 8675309.
c:\projects>tf changeset /notes:@notes.txt 8675309
Onde 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 8675309 do conjunto de alterações 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
Artigos relacionados
- de comando check-in
- check-out e editar comandos
- de comando
shelve - do Comando de Histórico do
- configurar de comando
- trabalhando com conjuntos de alterações