Comando searchGroups

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*}


Termos de uso | Feedback