list, ls

Finalidade

O subcomando scm list lista objetos, incluindo áreas de projetos, áreas de equipe, fluxos, espaços de trabalho, arquivos e contribuidores (usuários) no repositório especificado. O alias para scm list é scm ls.

Sinopse

• Para executar scm list depois de ter utilizado scm login para criar credenciais armazenadas:

  scm list [ -r  |
   --repository-uri ] URI do repositório ou apelido { [ -c 
  |
   --contrib ] nome [ -v  |  --verbose ] --depth níveis} tipo
  de objeto {opções específicas do tipo de objeto}

• Para executar scm list fornecendo credenciais na linha de comandos:

  scm list [ -r  |  --repository-uri ] URI do
  repositório [ -u  |  --username ] ID do
  usuário no repositório [ -P  |  --password ] senha para o
  ID do usuário no repositório { [ -c 
  |
   --contrib ] nome [ -v  |  --verbose ] --depth níveis }  tipo
  de objeto {opções específicas do tipo de objeto}

Opções e argumentos

[ -c  |  --contrib ] nome

Um ID de usuário válido no repositório especificado. Se esta opção for fornecida, a lista de tipos de itens é limitada aos itens de propriedade do contribuidor especificado. Se está opção for omitida, o nome assume o padrão para o ID de usuário do usuário executando scm list. Não aplicável quando está listando áreas de projetos, contribuidores, componentes e arquivos remotos.

--depth níveis

Ao listar arquivos remotos, os níveis especificam a profundidade máxima da recursão. Se não for especificada, os níveis assumem o padrão 3, listando os primeiros três níveis de conteúdos de pastas no componente especificado. A especificação de níveis como - lista todos os arquivos remotos no componente especificado. Não aplicável para outros tipos de objetos.

[ -P  |  --password ] senha para o ID do usuário no repositório

A senha para o ID do usuário especificado no repositório nomeado. Se esta opção não estiver incluída na linha de comandos, será solicitada uma senha. Se você especificou uma URI de repositório ou apelido para o qual armazenou credenciais utilizando o comando scm login, esta opção é ignorada.

[ -r  |  --repository-uri ] URI do repositório

Especifica o repositório no qual executar esta ação. Se você armazenou credenciais do repositório utilizando o comando scm login, pode utilizar o apelido que forneceu para estas credenciais armazenadas

[ -u  |  --username ] ID do usuário no repositório

Especifica um ID do usuário que existe no repositório nomeado. Se você especificou uma URI de repositório ou apelido para o qual armazenou credenciais utilizando o comando scm login, esta opção é ignorada.

[ -v  |  --verbose ]

Forneça mensagens informativas adicionais durante a operação. Ao listar componentes, também mostrar as linha de bases.

tipo de objeto

O tipo de item a ser listado. Um de:

components

Lista todos os componentes aos quais o contribuidor especificado possui acesso.

contribuidores

Lista os IDs de usuários de todos os contribuidores que possuem contas no repositório especificado.

áreas de projetos

Listar todas as áreas de projetos no repositório.

fluxos

Listar fluxos em todas as áreas de equipe onde o contribuidor for um membro.

remotefiles

Lista arquivos remotos em um espaço de trabalho, componente ou projeto. Opções específicas de tipo de objeto para este tipo de objeto são:

componente de espaço de trabalho

O nome de um espaço de trabalho e um componente em tal espaço de trabalho. Separe os nomes por um espaço. O componente nomeado deve existir no espaço de trabalho nomeado.

remotePath

Um nome do caminho dentro do componente especificado. Esta opção é opcional. Utilize-a para limitar a lista de caminhos remotos listados para um componente.

áreas de equipe

Listar todas as áreas de equipe das quais o contribuidor especificado é um membro.

espaços de trabalho

Listar todos os espaços de trabalho de propriedades do contribuidor especificado.

Exemplos