Listet Repository-Objekte auf.
Zweck
Der scm-Unterbefehl list listet Objekte wie
Projektbereiche, Teambereiche, Datenströme, Arbeitsbereiche, Dateien und Kontributoren (Benutzer)
im angegebenen Arbeitsbereich auf. Der Aliasname für scm list ist scm ls.
Übersicht
- Verwenden Sie die folgende Syntax, um den Befehl scm list auszuführen, nachdem Sie den Befehl
scm login zur Erstellung gespeicherter Berechtigungsnachweise verwendet haben:
scm list [ -r | --repository-uri ] repository-uri_oder_kurzname { [ -c | --contrib ] name [ -v | --verbose ] --depth ebenen} objekttyp {objekttypspezifische optionen}
- Verwenden Sie die folgende Syntax, um den Befehl scm list unter Angabe von Berechtigungsnachweisen
in der Befehlszeile auszuführen:
scm list [ -r | --repository-uri ] repository-uri [ -u | --username ] benutzer-id_in_repository [ -P | --password ] kennwort_für_benutzer-id_in_repository { [ -c | --contrib ] name [ -v | --verbose ] --depth ebenen } objekttyp {objekttypspezifische optionen}
Optionen und Argumente
- [ -c | --contrib ] name
- Eine Benutzer-ID, die im angegebenen Repository gültig ist. Wenn diese Option angegeben wird, wird
die Liste der Objekttypen (objekttyp) auf die Elemente begrenzt, deren Eigner
der angegebene Kontributor ist. Wenn diese Option nicht angegeben wird, enthält name
standardmäßig die Benutzer-ID des Benutzers, der den Befehl ccc list ausführt. Kann
nicht verwendet werden, wenn Projektbereiche, Kontributoren, Komponenten und ferne Dateien aufgelistet
werden.
- --depth ebenen
- Wenn ferne Dateien aufgelistet werden, gibt der Wert ebenen die maximale
Rekursionstiefe an. Wenn diese Option nicht angegeben wird, gilt für ebenen der
Standardwert 3, der die ersten drei Ebenen von Ordnerinhalten in der angegebenen Komponente auflistet. Wenn für ebenen der Wert '–' angegeben wird, werden alle fernen Dateien in der
angegebenen Komponente aufgelistet. Kann für andere Objekttypen nicht verwendet werden.
- [ -P | --password ] kennwort_für_benutzer-id_in_repository
- Das Kennwort für die angegebene Benutzer-ID im benannten Repository. Wenn diese Option in der
Befehlszeile nicht angegeben wird, werden Sie zur Eingabe eines Kennworts aufgefordert. Wenn Sie eine Repository-URI oder einen Kurznamen angegeben haben, für den Sie Berechtigungsnachweise
mithilfe des Befehls scm login gespeichert haben, wird diese Option ignoriert.
- [ -r | --repository-uri ] repository-uri
- Gibt das Repository an, in dem diese Aktion ausgeführt werden soll. Wenn Sie
Berechtigungsnachweise für das Repository mit dem Befehl scm login gespeichert haben,
können Sie den Kurznamen verwenden, den Sie für diese gespeicherten Berechtigungsnachweise angegeben haben.
- [ -u | --username ] benutzer-id_in_repository
- Gibt eine Benutzer-ID an, die in dem genannten Repository vorhanden ist. Wenn Sie eine Repository-URI oder einen Kurznamen angegeben haben, für den Sie Berechtigungsnachweise
mithilfe des Befehls scm login gespeichert haben, wird diese Option ignoriert.
- [ -v | --verbose ]
- Stellt zusätzliche Informationsnachrichten während der Operation bereit. Bei der Auflistung von Komponenten werden zusätzlich
Referenzkonfigurationen angezeigt.
- objekttyp
- Der Typ der aufzulistenden Elemente. Eine der folgenden Angaben:
- components
- Listet alle Komponenten auf, auf die der angegebene Kontributor Zugriff hat.
- contributors
- Listet die Benutzer-IDs aller Kontributoren auf, die Accounts im angegebenen Repository besitzen.
- project-areas
- Listet alle Projektbereiche im Repository auf.
- streams
- Listet die Datenströme in allen Teambereichen auf, in denen der angegebene Kontributor Mitglied ist.
- remotefiles
- Listet die fernen Dateien in einem Arbeitsbereich, einer Komponente oder einem Projekt auf. Die folgenden
objekttypspezifischen Optionen für diesen Objekttyp sind verfügbar:
- arbeitsbereich komponente
- Der Name eines Arbeitsbereichs und einer Komponente in diesem Arbeitsbereich. Trennen Sie die Namen durch
ein Leerzeichen. Die angegebene Komponente (komponente) muss im angegebenen Arbeitsbereich
(arbeitsbereich) enthalten sein.
- ferner pfad
- Ein Pfadname innerhalb der angegebenen Komponente (komponente).
Diese Option ist
optional. Mit dieser Option können Sie die Liste auf ferne Pfade für eine Komponente
(komponente) begrenzen.
- team-areas
- Listet alle Teambereiche auf, in denen der angegebene Kontributor Mitglied ist.
- workspaces
- Listet alle Arbeitsbereiche auf, deren Eigner der angegebene Kontributor ist.
Beispiele
Der folgende Befehl listet die Arbeitsbereiche auf, deren Eigner der Benutzer ist,
dem die gespeicherten Berechtigungsnachweise für das Repository mit dem Kurznamen 'jazzhost' zugeordnet sind:
C:\>scm list workspaces -r jazzhost
(1000) "Community-Site-Arbeitsbereich"
(1101) "HelloJazz"
(1068) "UA-CLI"
(1113) "HelloJazz2"
(1109) "REST-svc-dev"
(1141) "Robs Testarbeitsbereich"
Der folgende Befehl listet die Arbeitsbereiche,
deren Eigner der Benutzer 'brc' ist, im Repository mit dem Kurznamen 'jazzhost' auf:
C:\>scm list workspaces -c brc -r jazzhost
(1141) "Robs Testarbeitsbereich"
(1109) "REST-svc-dev"