Elencare gli oggetti del repository
Scopo
Il sottocomando scm list elenca gli oggetti, inclusi le aree progetto, le aree team, i flussi, gli spazi di lavoro, i file e i contributori (utenti) nel repository specificato. L'alias per scm list è scm ls.
Sintesi
- Per eseguire scm list dopo aver usato il comando scm login per creare credenziali archiviate:
scm list [ -r
| --repository-uri ] nome alternativo o URI del repository { [ -c | --contrib ] nome [ -v | --verbose ] --depth livelli} tipo di oggetto {opzioni specifiche per il tipo di oggetto}
- Per eseguire scm list fornendo le credenziali nella riga di comando:
scm list [ -r | --repository-uri ] URI del repository [ -u | --username ] ID utente nel repository [ -P | --password ] password l'ID utente nel repository { [ -c | --contrib ] nome [ -v | --verbose ] --depth livelli } tipo di oggetto {opzioni specifiche per il tipo di oggetto}
Opzioni ed argomenti
- [ -c | --contrib ] nome
- Un ID utente valido nel repository specificato. Se si inserisce questa opzione, l'elenco di item type è limitato agli oggetti posseduti dal contributore specificato. Se questa opzione viene omessa, nome viene impostato in via predefinita con l'ID utente dell'utente che esegue il comando scm list.
Non è applicabile quando si elencano aree progetto, contributori, componenti e file remoti.
- --depth livelli
- Quando si elencano file remoti, livelli specifica
la profondità massima della ricursione. Se non specificata, livelli viene impostata in via predefinita a 3, elencando i primi tre livelli dei contenuti delle cartelle nel componente specificato. Specificando levels come – elenca tutti i file remoti nel componente specificato. Non applicabile per altri tipi di oggetto.
- [ -P | --password ] password l'ID utente nel repository
- La password per l'ID utente specificato nel repository considerato. Se non viene inclusa questa opzione nella riga di comando, viene richiesta una password. Questa opzione viene ignorata se è stato specificato un nome alternativo o un URI del repository per il quale sono state archiviate le credenziali tramite il comando scm login.
- [ -r | --repository-uri ] URI del repository
- Specifica il repository in cui eseguire questa azione. Se sono state archiviate credenziali del repository usando il comando scm login, è possibile usare il nome alternativo fornito per tali credenziali archiviate
- [ -u | --username ] ID utente nel repository
- Specifica un ID utente presente nel repository considerato. Questa opzione viene ignorata se è stato specificato un nome alternativo o un URI del repository per il quale sono state archiviate le credenziali tramite il comando scm login.
- [ -v | --verbose ]
- Fornisce messaggi informativi supplementari mentre si lavora. Quando si elencano i componenti, mostrare anche le baseline.
- tipo di oggetto
- Il tipo di oggetto da elencare. Uno tra:
- components
- Elenca tutti i componenti a cui il contributore specificato ha accesso.
- contributors
- Elenca gli ID utente di tutti i contributori che posseggono degli account nel repository specificato.
- project-areas
- Elenca tutte le aree progetto nel repository.
- streams
- Elenca i flussi in tutte le aree team di cui il contributore specificato è membro.
- remotefiles
- Elenca i file remoti in uno spazio di lavoro, componente o progetto. Opzioni specifiche per il tipo di oggetto sono:
- componente dello spazio di lavoro
- Il nome di uno spazio di lavoro e un componente in quello spazio di lavoro. Separare i nomi con uno spazio. Il componente denominato deve esistere nello spazio di lavoro denominato.
- remotePath
- Un nome di percorso all'interno del componente specificato.
Questa opzione è facoltativa. Usarla per restringere l'elenco dei percorsi remoti a quelli di un componente.
- team-areas
- Elenca tutte le aree team di cui il contributore specificato è membro.
- workspaces
- Elenca tutti gli spazi di lavoro del contributore specificato.
Esempi
Elencare gli spazi di lavoro posseduti dall'utente associato alle credenziali archiviate per il repository con nome alternativo jazzhost:
C:\>scm list workspaces -r jazzhost
(1000) "Community Site Workspace"
(1101) "HelloJazz"
(1068) "UA-CLI"
(1113) "HelloJazz2"
(1109) "REST-svc-dev"
(1141) "Rob's test workspace"
Elencare gli spazi di lavoro posseduti dall'utente brc nel repository con nome alternativo jazzhost:
C:\>scm list workspaces -c brc -r jazzhost
(1141) "Rob's test workspace"
(1109) "REST-svc-dev"