searchUsers コマンド

ユーザーを検索するにはこのコマンドを使用します。

目的

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


利用条件 | フィードバック