addGroupToTopicSpaceRootRole コマンド
addGroupToTopicSpaceRootRole コマンドは、トピック・スペース・ルートのトピック・スペース・ロールにグループを追加するために使用します。
コマンドを実行するには、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()
目的
addGroupToTopicRootSpaceRole コマンドは、Sender ロールおよび Receiver ロールでトピック・スペース・ルートにアクセスする許可をグループに付与するために使用します。トピック・スペースのトピックに付与されたアクセス許可に追加されます。
このコマンドを使用して、まだ存在しない トピックのアクセス制御ポリシーを定義することができます。 アクセス制御ポリシーをまず定義することによって、トピックが作成されたときから保護されるようにすることができます。ターゲット・オブジェクト
なし。
必須パラメーター
- -bus busName
- ローカル・バスの名前。listSIBuses コマンドを使用して、既存のバスの名前をリストすることができます。
- -topicSpace topicSpaceName
- トピック・スペースの名前。
- -role roleName
- トピックに Sender または Receiver のロールを指定することができます。
- -group groupName
- トピック・スペース・ルートの Sender または Receiver ロールに追加するグループの名前。グループ名、または以下の特殊グループ名のいずれかを指定することができます。
- サーバー
- このグループにはアプリケーション・サーバーが含まれます。
- AllAuthenticated
- このグループには認証されたユーザーのみが含まれます。
- 全員
- このグループにはすべてのユーザーが含まれます。各ユーザーは匿名です。
条件付きパラメーター
なし。
オプション・パラメーター
- -uniqueName uniqueName
- ユーザー・レジストリーでグループを固有に定義する名前を指定します。LDAP ユーザー・レジストリーを使用中の場合、この固有名はグループの識別名 (DN) です。-uniqueName と -group の両方に値を指定できますが、必ず、それらが同じグループを識別するようにします。このコマンドでは、値が一致するかどうかの検査は行いません。
例
以下の例では、Bus1 という名前のローカル・バスにある、Sport という名前のトピック・スペースで、 トピック・スペース・ルートの Sender ロールに、グループ名が Group1 で固有の名前が SalesGroup であるグループを追加します。
AdminTask.addGroupToTopicSpaceRootRole ('[-bus Bus1 -topicSpace Sport
-role Sender -group Group1 uniqueName SalesGroup]')