Use este comando para procurar grupos.
Finalidade
Use o comando
searchGroups para
localizar grupos no gerenciador de membro virtual que correspondam a determinados
critérios.
Por exemplo, é possível usar o comando
searchGroups para
localizar todos os grupos com um cn que começa com IBM.
Se bem-sucedido, o comando
searchGroups retorna uma lista de nomes exclusivos de todos os grupos
que correspondem aos critérios de procura.
Nota: Se
a opção Usar Configurações de Segurança Global estiver selecionada
para a região do usuário, ou a opção Repositórios Associados
Globais estiver selecionada como tipo de região para o domínio especificado,
esse comando será executado no repositório associado do domínio admin. Entretanto, as mudanças na
configuração que são executadas no domínio são aplicadas à configuração do domínio de
segurança específico.
Sintaxe
searchGroups { -cn commonname –description description [-timeLimit tlimit]
[-countLimit countlimit] [-clearCache clearCacheMode] [-securityDomainName domainName] }
Parâmetros
- -cn commonname
- Especifica o nome comum usado para o grupo. Esse parâmetro é mapeado para a
propriedade cn no gerenciador de membro virtual.
- -description description
- Especifica informações sobre o grupo. Esse parâmetro é mapeado para a entidade de
descrição em um objeto do gerenciador de membro virtual.
- –timeLimit tlimit
- Especifica o tempo máximo em milissegundos que a procura pode ser executada. O padrão
é sem limite de tempo.
- –countLimit countlimit
- Especifica o número máximo de resultados que você deseja retornar da procura. Por
padrão, todos os grupos encontrados na procura são retornados.
- -clearCache clearCacheMode
- Especifica se o cache do adaptador de repositório deve ser limpo antes de executar a operação de procura para grupos.
- O valor válido é clearAll, que limpa todas as informações armazenadas em cache no adaptador de repositório. O valor não faz distinção entre maiúsculas e minúsculas. Não há
valor padrão para esse parâmetro.
Caso não especifique um valor ou especifique um valor que não seja clearAll,
aparecerá uma mensagem de erro.
Evite problema: O uso frequente desse parâmetro para limpar o cache pode resultar em degradação do desempenho.
Quando o cache é limpo, a operação subsequente precisa obter detalhes do repositório e atualizar o cache com esses novos dados recuperados; assim, a operação subsequente leva mais tempo para ser concluída.
- -securityDomainName domainName
- Especifica o nome que identifica exclusivamente o domínio de segurança.
Se você não especificar este parâmetro, o comando usa o repositório federado global.
Exemplo
Para procurar todos os grupos que tenham uma descrição
especificada, emita este comando:
$AdminTask searchGroups {-description *}
Para
procurar todos os grupos nos quais IBM aparece no nome comum do grupo, emita este
comandos:
$AdminTask searchGroups {-cn *IBM*}