list (SCM-Unterbefehl)

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

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 scm 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 im repository
Das Kennwort für die angegebene Benutzer-ID im genannten Repository. Wenn diese Option in der Befehlszeile nicht angegeben wird, werden Sie zur Eingabe eines Kennworts aufgefordert. Wenn Sie einen 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 auszuführen ist. Wenn Sie Berechtigungsnachweise für das Repository mithilfe des Befehls scm login gespeichert haben, können Sie den Kurznamen verwenden, den Sie für diese gespeicherten Berechtigungsnachweise angegeben haben.
-u  |  --username ] benutzer-id im repository
Gibt eine Benutzer-ID an, die in dem genannten Repository vorhanden ist. Wenn Sie einen 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"


Feedback

War dies eine Hilfe? Sie können Ihr Feedback bei Jazz.net (Registrierung erforderlich) geben: Geben Sie Ihre Kommentare in den Foren oder senden Sie einen Bug.