Vypsání objektů úložiště
Účel
Podpříkaz scm list vypíše objekty, včetně oblastí projektu, oblastí týmu, proudů, pracovních prostorů, souborů a přispěvatelů (uživatelů) v zadaném úložišti. Alias podpříkazu scm list je scm ls.
Stručný přehled
- Spuštění podpříkazu scm list po použití podpříkazu scm login k vytvoření uloženého pověření:
scm list [ -r | --repository-uri ] identifikátor URI nebo přezdívka úložiště { [ -c | --contrib ] název [ -v | --verbose ] --depth úrovně} typ objektu {volby specifické pro typ objektu}.
- Spuštění podpříkazu scm list s dodáním pověření v příkazovém řádku:
scm list [ -r | --repository-uri ] identifikátor URI úložiště [ -u | --username ] ID uživatele v úložišti [ -P | --password ] heslo pro ID uživatele v úložišti { [ -c | --contrib ] název [ -v | --verbose ] --depth úrovně } typ objektu {volby specifické pro typ objektu}.
Volby a argumenty
- [ -c | --contrib ] název
- ID uživatele platné v zadaném úložišti. Pokud je tato volba uvedená, je seznam typů položek omezen na položky, které vlastní zadaný přispěvatel. Pokud je tato volba vynechaná, pro parametr název se standardně použije ID uživatele, který spustí podpříkaz scm list.
Nelze použít při vypisování oblastí projektu, přispěvatelů, komponent a vzdálených souborů.
- --depth úrovně
- Při vypisování vzdálených souborů určuje parametr úrovně maximální hloubku
rekurze. Pokud není uveden, pro parametr úrovně se standardně použije hodnota
3. To znamená, že se vypíšou první tři úrovně obsahu složek v zadané komponentě. Když je jako parametr úrovně zadán znak –, vypíší se všechny vzdálené soubory v zadané komponentě. Nelze použít pro jiné typy objektu.
- [ -P | --password ] heslo pro ID uživatele v úložišti
- Heslo pro zadané ID uživatele v uvedeném úložišti. Pokud tato volba není uvedena v příkazovém řádku, budete vyzváni k zadání hesla. Pokud jste zadali identifikátor URI nebo přezdívku, pro kterou jste uložili pověření pomocí příkazu scm login, bude tato volba ignorovaná.
- [ -r | --repository-uri ] identifikátor URI úložiště
- Určuje úložiště, ve kterém se má tato akce provést. Pokud jste pověření k úložišti uložili pomocí příkazu scm login,
můžete použít přezdívku, kterou jste zadali pro toto uložené pověření
- [ -u | --username ] ID uživatele v úložišti
- Určuje ID uživatele existující v uvedeném úložišti. Pokud jste zadali identifikátor URI nebo přezdívku, pro kterou jste uložili pověření pomocí příkazu scm login, bude tato volba ignorovaná.
- [ -v | --verbose ]
- Poskytovat další informativní zprávy po dobu provádění operací. Při vypisování komponent zobrazit také úrovně baseline.
- typ objektu
- Typ položky, která se má vypsat. Jedna z možností:
- components
- Vypsání všech komponent, ke kterým má zadaný přispěvatel přístup.
- contributors
- Vypíše ID uživatele všech přispěvatelů, kteří mají účty v zadaném úložišti.
- project-areas
- Vypsání všech oblastí projektu v úložišti.
- streams
- Vypsání proudů ve všech oblastech týmu, jejichž je zadaný přispěvatel členem.
- remotefiles
- Vypsání vzdálených souborů v pracovním prostoru, komponentě nebo projektu. Volby specifické pro typ objektu pro tento typ objektu:
- komponenta pracovního prostoru
- Název pracovního prostoru a komponenty v tomto pracovním prostoru. Názvy oddělte mezerou. Uvedená komponenta musí v uvedeném pracovním prostoru existovat.
- vzdálenáCesta
- Název cesty v rámci zadané komponenty.
Tato volba je volitelná. Používá se k omezení seznamu vzdálených cest uvedených pro komponentu.
- team-areas
- Vypsání všech oblastí týmu, jejichž je zadaný přispěvatel členem.
- workspaces
- Vypsání všech pracovních prostorů, které vlastní zadaný přispěvatel.
Příklady
Vypsání pracovních prostorů, které vlastní uživatel přidružený k uloženému pověření pro úložiště s přezdívkou 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"
Vypsání pracovních prostorů, které vlastní uživatel brc v úložišti s přezdívkou jazzhost:
C:\>scm list workspaces -c brc -r jazzhost
(1141) "Rob's test workspace"
(1109) "REST-svc-dev"