Comando Shelve
Aggiornamento: novembre 2007
Archivia in Team Foundation Server un insieme di modifiche in sospeso, unitamente alle note di archiviazione in sospeso, a un commento e a un elenco di elementi di lavoro associati senza effettivamente archiviarli nel server del controllo della versione.
Autorizzazioni necessarie
Per utilizzare il comando shelve, è necessario essere proprietario dell'area di sospensione o disporre dell'autorizzazione Amministra modifiche sospese impostata su Consenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
tf shelve [/replace] [/comment:("comment"|@commentfile)] [shelvesetname[;owner] [/validate]
tf shelve [/move] [/replace] [/comment:("comment"|@commentfile)]
[/recursive] shelvesetname[;owner] itemspec [/validate]
tf shelve /delete [/server:servername] shelvesetname[;owner] [/validate]
Parametri
Argomento |
Descrizione |
|---|---|
commentfile |
Indica un percorso di file system di un file in cui devono essere letti i commenti per l'area di sospensione. |
comment |
Indica il commento per l'area di sospensione. |
servername |
Valore fornito dall'utente per l'opzione /server. |
itemspec |
Identifica i file o le cartelle da sospendere. Per impostazione predefinita, se questo parametro non viene specificato, vengono sospese tutte le modifiche in sospeso nell'area di lavoro corrente. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation sui parametri itemspec per determinare gli elementi all'interno dell'ambito, vedere Opzioni della riga di comando. |
shelvesetname |
Indica un nome in base al quale è possibile recuperare l'area di sospensione dal server Team Foundation. È possibile specificare una combinazione esistente di nomeareadisospensione e proprietario, ma solo se si specifica anche /replace . È necessario specificare un valore per questo parametro. |
owner |
Identifica il proprietario corrente o previsto dell'area di sospensione in base al nome utente. Per impostazione predefinita, la proprietà dell'area di sospensione viene assegnata all'utente corrente se non ne viene specificato un altro. |
Opzione |
Descrizione |
|---|---|
/move |
Rimuove le modifiche in sospeso dall'area di lavoro dopo il completamento dell'operazione di sospensione. |
/replace |
Sostituisce l'area di sospensione esistente con lo stesso nome e lo stesso proprietario di quella specificata. |
/delete |
Elimina l'area di sospensione specificata. Questa opzione può essere combinata solo con /server. Se l'opzione /noprompt non viene inclusa, quando si specifica l'opzione /delete viene visualizzato un messaggio di conferma. |
/comment |
Aggiunge un commento specificato in cui sono descritte le modifiche sospese. |
/recursive |
Sospende tutti gli elementi presenti nella cartella dell'area di sospensione specificata, tutte le sottocartelle e tutti i relativi elementi se il parametro itemspec fornito corrisponde a una cartella. |
/server |
Indica il server Controllo della versione di Team Foundation in cui creare, modificare o eliminare l'area di sospensione specificata. |
/noprompt |
Non vengono visualizzati prompt che richiedono l'input da parte dell'utente. |
/validate |
È valida solo se combinata con /noprompt. Questa opzione consente di selezionare la casella di controllo della convalida nella finestra di dialogo Sospendi - file di origine quando viene aperta. Quando si seleziona la casella di controllo di convalida, la finestra di dialogo valuta i criteri di archiviazione e verifica che siano state compilate le note di archiviazione richieste. Questa opzione è utile quando le modifiche vengono inviate a un altro utente per la revisione e l'archiviazione. |
Note
Il comando shelve dell'utilità della riga di comando tf consente di eseguire il backup delle modifiche in sospeso, di un elenco di elementi di lavoro associati, delle note di archiviazione in corso e dei commenti disponibili in un'area di lavoro di Team Foundation Server. Un'area di sospensione è simile a un insieme di modifiche di cui non è stato eseguito il commit sul server. Analogamente a un insieme di modifiche, l'area di sospensione può essere recuperata dal server in un'area di lavoro locale da qualsiasi utente che disponga delle autorizzazioni sufficienti.
La sospensione costituisce un metodo alternativo all'archiviazione delle modifiche in sospeso che non sono state sufficientemente testate. Utilizzare tale metodo quando si desidera interrompere il lavoro per:
Condividere un insieme di file di lavoro con un altro sviluppatore o tester senza archiviare le modifiche nel server del controllo della versione.
Mettere temporaneamente da parte un gruppo di modifiche in sospeso senza archiviarle in modo da potersi dedicare a un lavoro prioritario. Una volta completato il lavoro prioritario, sarà possibile ripristinare le modifiche sospese utilizzando il Comando Unshelve.
Se si include l'opzione /move, il comando shelve consente di ripristinare tutte le revisioni dei file sospesi alle versioni di base dell'area di lavoro, ossia l'ultima versione recuperata dal server nell'area di lavoro corrente. In particolare, con l'opzione /move si verifica quanto segue per tutti gli elementi sospesi:
Utilizza Undo per annullare le modifiche sospese. I file che erano aggiunte in sospeso vengono eliminati dall'area di lavoro.
Le versioni di base dell'area di lavoro di tutti i file per cui esistono edizioni in sospeso vengono recuperate dal server nell'area di lavoro corrente.
Tutti gli elementi presenti nell'area di lavoro corrente vengono contrassegnati come in sola lettura.
Se si include l'opzione /delete , in Team Foundation l'area di sospensione specificata viene rimossa in modo definitivo dal server Team Foundation.
Per ulteriori informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.
Esempi
L'esempio seguente consente di creare una nuova area di sospensione su Team Foundation Server denominata Reflector_BuddyTest, assegnare la proprietà all'utente Hans, quindi riportare tutti gli elementi nell'area di lavoro corrente all'ultima versione scaricata durante l'ultima operazioneget e in stato di sola lettura.
c:\projects> tf shelve Reflector_BuddyTest;Hans /move
L'esempio riportato di seguito consente di eliminare dal server l'area di sospensione esistente "new-feature", creare una nuova area di sospensione con lo stesso nome e mantenere tutte le modifiche in sospeso nell'area di lavoro corrente.
c:\projects> tf shelve new-feature /replace
L'esempio riportato di seguito consente di creare un'area di sospensione denominata HelloWorld_TestMe che include tutte le modifiche in sospeso apportate a tutti i file con estensione cs contenuti nella cartella di lavoro C:\projects e nelle relative sottocartelle.
c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive
Nell'esempio seguente viene eliminata l'area di sospensione HelloWorld_24.
c:\projects> tf shelve HelloWorld_24 /delete
Vedere anche
Attività
Procedura: sospendere e riprendere le modifiche in sospeso
Concetti
Utilizzo delle aree di sospensione per il controllo della versione
Riferimenti
Sintassi della riga di comando (Team System)