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