list, ls

Finalidad

El submandato scm list lista objetos, incluidas áreas de proyecto, áreas de equipo, corrientes, espacios de trabajo, archivos y colaboradores (usuarios) del repositorio especificado. El alias de scm list es scm ls.

Sinopsis

• Para ejecutar scm list después de haber utilizado scm login para crear credenciales almacenadas:

  scm list [ -r  |  --repository-uri ] URI de repositorio o apodo { [ -c  |  --contrib ] nombre [ -v  |  --verbose ] --depth niveles} tipo de objeto {opciones específicas de tipo de objeto}

• Para ejecutar scm list facilitando credenciales en la línea de mandatos:

  scm list [ -r  |  --repository-uri ] URI de repositorio [ -u  |  --username ] ID de usuario de repositorio [ -P  |  --password ] contraseña de ID de usuario de repositorio { [ -c  |  --contrib ] nombre [ -v  |  --verbose ] --depth niveles }  tipo de objeto {opciones específicas de tipo de objeto}

Opciones y argumentos

[ -c  |  --contrib ] nombre

Un ID de usuario válido en el repositorio especificado. Si se facilita esta opción, la lista de tipos de elemento se limita a elementos que son propiedad del colaborador especificado. Si se omite esta opción, el valor predeterminado de nombre es el ID de usuario del usuario que ejecuta scm list. No se aplica si se listan áreas de proyecto, colaboradores, componentes y archivos remotos.

--depth niveles

Si se listan archivos remotos, niveles especifica la profundidad máxima de recurrencia. Si no se especifica, el valor predeterminado de niveles es 3, listando los tres primeros niveles de contenido de carpetas del componente especificado. Al especificar niveles como – se listan todos los archivos remotos del componente especificado. No se aplica a otros tipos de objeto.

[ -P  |  --password ] contraseña de ID de usuario de repositorio

La contraseña del ID de usuario especificado en el repositorio nombrado. Si esta opción no se incluye en la línea de mandatos, se le solicita una contraseña. Si ha especificado un URI de repositorio o apodo para el cual ha almacenado credenciales mediante el mandato scm login, se ignora esta opción.

[ -r  |  --repository-uri ] URI de repositorio

Especifica el repositorio en el que se debe llevar a cabo esta acción. Si ha almacenado credenciales de repositorio mediante el mandato scm login, puede utilizar el apodo que facilitó para estas credenciales almacenadas

[ -u  |  --username ] ID de usuario de repositorio

Especifica un ID de usuario que existe en el repositorio nombrado. Si ha especificado un URI de repositorio o apodo para el cual ha almacenado credenciales mediante el mandato scm login, se omite esta opción.

[ -v  |  --verbose ]

Proporcionar mensajes informativos adicionales al operar. Al listar componentes, mostrar también las líneas base.

tipo de objeto

El tipo de elemento que se debe listar. Uno de:

components

Listar todos los componentes a los que tiene acceso el colaborador especificado.

contributors

Listar los ID de usuario de todos los colaboradores que tienen cuentas en el repositorio especificado.

project-areas

Listar todas las áreas de proyecto del repositorio.

streams

Listar las corrientes de todas las áreas de equipo a las que pertenece el colaborador especificado.

remotefiles

Listar los archivos remotos de un espacio de trabajo, componente o proyecto. Las opciones específicas de tipo de objeto para este tipo de objeto son:

componente de espacio de trabajo

El nombre de un espacio de trabajo y un componente en ese espacio de trabajo. Separe los nombres por un espacio. El componente especificado debe existir en el espacio de trabajo especificado.

vía de acceso remota

Un nombre de vía de acceso dentro del componente especificado. Esta opción es opcional. Utilícela para restringir la lista de vías de acceso remotas que figuran en un componente.

team-areas

Listar todas las áreas de equipo a las que pertenece el colaborador especificado.

workspaces

Listar todos los espacios de trabajo propiedad del colaborador especificado.

Ejemplos