addUserToDestinationRole コマンド
addUserToDestinationRole コマンドは、ローカルまたは外部バスの宛先ロールにユーザーを追加するために使用します。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは Qshell から実行されます。.
詳しくは、wsadmin スクリプトを使用した WebSphere スクリプトを実行するための Qshell の構成.
- Jython で使用可能なサービス統合バス・セキュリティー・コマンドのリストと、各コマンドの簡単な説明を見るには、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('SIBAdminBusSecurityCommands')
- 特定のコマンドの概要ヘルプの場合は、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('command_name')
AdminConfig.save()
目的
addUserToDestinationRole コマンドは、指定したロールのローカル・バス宛先へのアクセスをユーザーに付与します。 指定できるロールは、宛先のタイプにより異なります。
ターゲット・オブジェクト
なし。
必須パラメーター
- -type destinationType
- 以下のいずれかの宛先タイプを指定することができます。
- キュー
- ポート
- TopicSpace
- ForeignDestination
- 別名
宛先に指定できるロールは、宛先ロールの管理で定義した宛先の種類によって決まります。
destinationType に foreignDestination または alias のいずれかを指定する場合は、宛先をホスティングしている外部バスの名前を、外部バス名に指定する必要があります。
キューまたはトピックの destinationType を指定した場合、外部バス名は無視されます。 許可は、ローカル・バスの宛先に対して付与されます。
- -bus busName
- ローカル・バスの名前。listSIBuses コマンドを使用して、既存のバスの名前をリストすることができます。
- -role roleType
- 指定した -type に応じて、以下のいずれかのロール・タイプを指定することができます。
- Sender
- このロール・タイプは、メッセージをローカル・バスの宛先に送信できます。
- Receiver
- このロール・タイプは、メッセージをローカル・バスの宛先から受信できます。
- Browser
- このロール・タイプは、ローカル・バスの宛先のメッセージを参照できます。
- -user userName
- ローカル・バスの宛先ロール・タイプに追加するユーザーの名前。
条件付きパラメーター
なし。
オプション・パラメーター
- -foreignBus foreignBusName
- 外部バスの名前を指定します。外部宛先または別名の宛先にユーザーを追加する場合は、外部宛先または別名をホストする外部バスの名前を指定する必要があります。
- -uniqueName uniqueName
- このパラメーターが有効なのは 、WebSphere® Application Server バージョン 7.0 以降 のアプリケーション・サーバーで使用される場合のみです。 これより前のバージョンでは使用しないでください。ユーザー・レジストリーでユーザーを固有に定義する名前を指定します。LDAP ユーザー・レジストリーを使用中の場合、この固有名はユーザーの識別名 (DN) です。-uniqueName と -user の両方に値を指定できますが、必ず、それらが同じユーザーを識別するようにします。このコマンドでは、値が一致するかどうかの検査は行いません。
例
以下の例では、Bus1 という名前のローカル・バスにある、Queue1 という名前のキュー・タイプ宛先の Sender ロールに User1 という名前のユーザーを追加します。
Admintask.addUserToDestinationRole ('[-type queue -bus Bus1
-destination Queue1 -role Sender -user User1]')
以下の例では、 Bus1 という名前のローカル・バスにある、Queue2 という名前のキュー・タイプ宛先の Receiver ロールに User2 という名前のユーザーを追加します。
Admintask.addUserToDestinationRole ('[-type queue -bus Bus1
-destination Queue2 -role Receiver -user User2]')