list, ls (SCM-Unterbefehl)

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 im repository [ -P  |  --password ] kennwort für benutzer-id im 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 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