ユーザーを検索するにはこのコマンドを使用します。
目的
Virtual member manager の特定の基準に合ったユーザーを見つけるには、
searchUsers
コマンドを使用します。例えば、
searchUsers コマンドを使用して、uid が文字 d で始まるすべてのユーザーを見つけることができます。
正常に実行されると、searchUsers コマンドは検索基準と
一致したすべてのユーザーの固有名のリストを返します。
注: ユーザー・レルム用に「グローバル・セキュリティー設定を使用する」オプションが選択されている場合、または指定されたドメインのレルム・タイプとして「グローバル統合リポジトリー」オプションが選択されている場合は、このコマンドは管理ドメインの統合リポジトリーで実行されます。ただし、ドメイン上で実行される構成の変更は、セキュリティー・ドメイン固有の構成に適用されます。
構文
searchUsers { {-cn commonname –sn surname -principalName principalName -uid uid
-mail mail} [-timeLimit tlimit] [-countLimit countlimit] [-clearCache clearCacheMode] [-securityDomainName domainName] }
正確にパラメーターの 1 つ
(cn、sn、principalName、uid、または mail) が指定されなければなりません。
1 つも指定しないか、複数のパラメーターを指定した場合には、例外が発生します。
パラメーター
- -cn commonname
- ユーザーのファーストネームを指定します。
このパラメーターは、Virtual member manager の cn プロパティーにマップされます。
- -sn surname
- ユーザーのラストネームを指定します。
このパラメーターは、Virtual member manager の sn プロパティーにマップされます。
- -principalName principalName
- システムでユーザーのログオン ID として使用されるユーザーのプリンシパル名を
指定します。このパラメーターは、Virtual member manager の principalName プロパティーにマップされます。
- -uid uid
- 検索対象のユーザーの固有 ID 値を指定します。
このパラメーターは、Virtual member manager の uid プロパティーにマップされます。
- –timeLimit tlimit
- 検索を実行する最大時間 (ミリ秒) を指定します。デフォルトは時間制限なしです。
- –countLimit countlimit
- 検索で受け取りたい結果の最大数を指定します。デフォルトでは、検索で見つかった
すべてのユーザーが返されます。
- -clearCache clearCacheMode
- ユーザーの検索操作を実行する前に、リポジトリー・アダプター・キャッシュを
クリアするかどうかを指定します。
- 有効な値は clearAll で、リポジトリー・アダプター内の
キャッシュ情報をすべてクリアします。
この値では大/小文字が区別されません。
このパラメーターにはデフォルト値はありません。
値を指定しないか、clearAll 以外の
値を指定すると、エラー・メッセージが表示されます。
問題の回避: 頻繁にこのパラメーターを使用してキャッシュをクリアすると、
パフォーマンスが低下する可能性があります。
キャッシュをクリアすると、後続の操作はリポジトリーから
詳細を取得し、この新たに取得したデータでキャッシュを更新しなければなりません。そのため、
後続の操作が完了するまでにかかる時間が長くなります。
- -securityDomainName domainName
- セキュリティー・ドメインを一意に識別する名前を指定します。
このパラメーターが指定されていない場合、
コマンドはグローバル統合リポジトリーを使用します。
注: 複数のログイン・プロパティーを定義する場合、1 番目のログイン・プロパティーは統合リポジトリーの principalName プロパティーにプログラマチックにマップされます。例えばログイン・プロパティーとして uid;mail を設定すると、LDAP 属性 uid が統合リポジトリーの principalName プロパティーにマップされます。
サンプル
プリンシパル名を持つすべてのユーザーを検索するには、次のコマンドを実行します。
$AdminTask searchUsers {-principalName *}
文字 d で始まる uid を持つすべてのユーザーを検索するには、次のコマンドを実行します。
$AdminTask searchUsers {-uid d*}