Lista objetos de repositório
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 essa opção for omitida, nome assumirá o padrão
do ID do usuário que está executando ccc 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 ]
- Fornecer 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
Lista espaços de trabalho de propriedade do usuário associado às
credenciais armazenadas para o repositório apelidado de jazzhost:
C:\>scm list workspaces
-r jazzhost
(1000) "Espaço de Trabalho do Site da Comunidade"
(1101) "HelloJazz"
(1068) "UA-CLI"
(1113) "HelloJazz2"
(1109) "REST-svc-dev"
(1141) "Espaço de trabalho de teste do Rob"
Listar espaços de trabalho de
propriedade do usuário brc no repositório apelidado de jazzhost:
C:\>scm list workspaces
-c brc -r jazzhost
(1141) "Espaço de trabalho de teste do Rob"
(1109) "REST-svc-dev"