addGroupToForeignBusRole コマンド
addGroupToForeignBusRole コマンドは、Sender ロールで、ローカル・バスから外部バスにアクセスする許可をグループに付与するために使用します。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは Qshell から実行されます。.
詳しくは、wsadmin スクリプトを使用した WebSphere スクリプトを実行するための Qshell の構成.
このコマンドが有効なのは 、WebSphere® Application Server バージョン 7.0 以降 のアプリケーション・サーバーで使用される場合のみです。 これより前のバージョンでは使用しないでください。
サービス統合バスのコマンドには、コマンド行ヘルプが用意されています。
- Jython で使用可能なサービス統合バス・セキュリティー・コマンドのリストと、各コマンドの簡単な説明を見るには、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('SIBAdminBusSecurityCommands')
- 特定のコマンドの概要ヘルプの場合は、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('command_name')
コマンドの使用後に、マスター構成に変更を保存します。次のコマンドを使用します。
AdminConfig.save()
目的
addGroupToForeignBusRole コマンドは、ローカル・バスから外部バスにメッセージを送信する許可をグループに付与するために使用します。
ターゲット・オブジェクト
なし。
必須パラメーター
- -bus busName
- ローカル・バスの名前。listSIBuses コマンドを使用して、既存のバスの名前をリストすることができます。
- -foreignBus foreignBusName
- 外部バスの名前。
- -role Sender
- 外部バスには、Sender ロールのみを指定できます。
- -group groupName
- 外部バスの Sender ロールに追加するグループの名前。グループ名、または以下の特殊グループ名のいずれかを指定することができます。
- サーバー
- このグループにはアプリケーション・サーバーが含まれます。
- 全認証者
- このグループには認証されたユーザーのみが含まれます。
- 全員
- このグループにはすべてのユーザーが含まれます。各ユーザーは匿名です。
条件付きパラメーター
なし。
オプション・パラメーター
- -uniqueName uniqueName
- ユーザー・レジストリーでグループを固有に定義する名前を指定します。LDAP ユーザー・レジストリーを使用中の場合、この固有名はグループの識別名 (DN) です。-uniqueName と -group の両方に値を指定できますが、必ず、それらが同じグループを識別するようにします。このコマンドでは、値が一致するかどうかの検査は行いません。
例
以下の例では、グループ名が Group1 で固有の名前が SalesGroup であるグループを、ForeignBus1 という名前の外部バスの Sender ロールに追加します。 ローカル・バスの名前は、Bus1 です。
AdminTask.addGroupToForeignBusRole ('[-bus Bus1 -ForeignBus ForeignBus1
-role Sender -group Group1 -uniqueName SalesGroup]')