Condividi tramite

Comando Set di modifiche

  • Articolo

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

Visual Studio 2019 | Visual Studio 2022

Visualizza informazioni su e consente di modificare gli attributi, ad esempio commenti e note di archiviazione, associati a un insieme di modifiche.

Prerequisiti

Per usare il comando changeset, disporre dell'autorizzazione Lettura impostata su Consenti per qualsiasi file o cartelle nel set di modifiche per cui si desidera visualizzare informazioni complete. Gli unici utenti che possono modificare le note e i commenti associati a un insieme di modifiche sono gli utenti che hanno creato il set di modifiche o un utente che ha la Rivedere le modifiche di altri utenti autorizzazione globale.

Per altre informazioni, vedere autorizzazioni TFVC predefinite.

Sintassi

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

Parametri

Discussione

argomento Descrizione
comment Fornisce un commento sull'archiviazione.
@<commentfile> Specifica un percorso di un file su disco contenente il commento utilizzato per l'archiviazione.
<NoteFieldName>=<NoteFieldValue> Imposta il valore del campo della nota di archiviazione. È possibile specificare più espressioni separate da punto e virgola field=value.
@<notefile> Fornisce il percorso di un file su disco che contiene i nomi e i valori dei campi delle note di archiviazione nel formato di field=value con una riga per riga.
<TeamProjectCollectionUrl> URL della raccolta di progetti contenente un insieme di modifiche su cui si desidera visualizzare informazioni o i cui attributi si desidera modificare, ad esempio, http://myserver:8080/tfs/DefaultCollection.
<username> Fornisce un valore all'opzione /user. È possibile specificare questo argomento come Domain\username o username.
<changesetnumber> Identifica il set di modifiche da rivedere o modificare. Non è possibile usare con /latest.

Opzione

di opzione Descrizione
/comment Sostituisce il commento del set di modifiche creato durante il processo di archiviazione, con un nuovo commento.
/notes Fornisce una o più note di archiviazione da associare al set di modifiche.
/latest Specifica il set di modifiche più recente. Non è possibile usare con <changesetnumber>.
/noprompt Elimina eventuali richieste di input da parte dell'utente.
/collection Specifica la raccolta di progetti.
/login Specifica il nome utente e la password per autenticare l'utente con Azure DevOps.

Osservazioni

Un set di modifiche è un set di revisioni di file e cartelle di cui è stato eseguito il commit nel server di controllo della versione di Team Foundation come parte dello stesso evento di archiviazione. Per altre informazioni, vedere Uso dei set di modifiche.

È possibile usare il comando changeset per visualizzare gli attributi di un insieme di modifiche e modificarne le proprietà. È possibile usare il comando history per determinare il set di modifiche su cui si desidera ottenere informazioni. Per altre informazioni, vedere Cronologia.

Per altre informazioni su come usare l'utilità della riga di comando tf, vedere Usare i comandi di controllo della versione di Team Foundation.

Esempi

Nell'esempio seguente vengono visualizzate informazioni dettagliate sul set di modifiche 8675309 in un formato modificabile nella finestra di dialogo Dettagli del set di modifiche di Visual Studio 8675309 - File di origine e sostituisce il commento esistente con Questo è un nuovo commento.

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

Dopo aver immesso il comando, nella finestra di dialogo Dettagli del set di modifiche 8675309 - File di origine selezionare Salva per associare il commento al set di modifiche.

Nell'esempio seguente vengono fornite due note di archiviazione da associare al set di modifiche.

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

Nell'esempio seguente vengono fornite due note di archiviazione che includono spazi nei valori e nei nomi da associare al set di modifiche.

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

Nell'esempio seguente le note di archiviazione incluse nel file notes.txt vengono associate al set di modifiche 8675309.

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

Dove il notes.txt può essere nel formato seguente:

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

Nell'esempio seguente viene sostituito il commento esistente per il set di modifiche 8675309 e vengono visualizzate informazioni sul set di modifiche nella finestra del prompt dei comandi. In questo esempio non viene aperta la finestra di dialogo set di modifiche di Visual Studio .

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

Nell'esempio seguente vengono visualizzate informazioni non modificabili sul set di modifiche 8675309 nella finestra del prompt dei comandi.

c:\projects>tf changeset 8675309 /noprompt

Output di esempio:

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