Comando searchUsers

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


Termos de uso | Feedback