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 changeset comando, è necessario disporre dell'autorizzazione Lettura impostata su Consenti per tutti i file o le 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 dispone dell'autorizzazione globale Modifica modifiche di altri utenti.

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

Argomento

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 fornire più espressioni separate field=value da punto e virgola.
@<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 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, http://myserver:8080/tfs/DefaultCollectionad esempio .
<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 può essere usato con /latest.

Opzione

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 può essere usato 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 insieme 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 di insiemi di modifiche.

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

Per altre informazioni su come usare l'utilità della tf riga di comando, 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 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 vengono associate le note di archiviazione incluse nel file notes.txt 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