Use este comando para procurar usuários.
Finalidade
Use o comando
searchUsers para
localizar usuários no gerenciador de membro virtual que correspondam a determinados
critérios.
Por exemplo, é possível usar o comando
searchUsers para
localizar todos os usuários com um uid que começa com a letra 'd'.
Se bem-sucedido, o
comando searchUsers retorna uma lista de nomes exclusivos de todos os
usuários 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
searchUsers { {-cn commonname –sn surname -principalName principalName -uid uid
-mail mail} [-timeLimit tlimit] [-countLimit countlimit] [-clearCache clearCacheMode] [-securityDomainName domainName] }
Exatamente
um dos parâmetros (cn, sn, principalName, uid ou mail) deve ser especificado. Se nenhum
ou mais de um for especificado, uma exceção ocorrerá.
Parâmetros
- -cn commonname
- Especifica o nome do usuário. Esse parâmetro é mapeado para a propriedade cn no
gerenciador de membro virtual.
- -sn surname
- Especifica o sobrenome do usuário. Esse parâmetro é mapeado para a propriedade sn no
gerenciador de membro virtual.
- -principalName principalName
- Especifique o nome do principal do usuário que é utilizado como ID de logon para o
usuário no sistema. Esse parâmetro é mapeado para a propriedade principalName no
gerenciador de membro virtual.
- -uid uid
- Especifica o valor de ID exclusivo para o usuário que você deseja procurar. Esse
parâmetro é mapeado para a propriedade uid no 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 usuários 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 usuários.
- 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.
Nota: Se você definir várias propriedades
de login, a primeira será mapeada programaticamente para a propriedade
principalName de repositórios associados. Por exemplo, se você
configurar uid;mail como as propriedades de login, o atributo LDAP
uid será mapeado para a propriedade
principalName de repositórios associados.
Exemplo
Para procurar todos os usuários que tenham um nome de
principal, emita este comando:
$AdminTask searchUsers {-principalName *}
Para
procurar todos os usuários que tenham um uid que começa com a letra 'd', emita este
comando:
$AdminTask searchUsers {-uid d*}