Befehl "addGroupToDestinationRole"
Verwenden Sie den Befehl addGroupToDestinationRole, um eine Gruppe den Zielrollen für einen lokalen oder einen fremden Bus hinzuzufügen.
Verwenden Sie zum Ausführen des Befehls das Objekt AdminTask des Scripting-Clients wsadmin.
Der Scripting-Client wsadmin wird über die Qshell ausgeführt.
Weitere Informationen finden Sie unter Qshell für die Ausführung von WebSphere-Scripts mit wsadmin-Scripting konfigurieren.
- Geben Sie den folgenden Befehl an der wsadmin-Eingabeaufforderung ein, um eine Liste der verfügbaren SIB-Befehle für die Sicherheit in Jython und eine Kurzbeschreibung jedes einzelnen Befehls
anzuzeigen:
print AdminTask.help('SIBAdminBusSecurityCommands')
- Zum Anzeigen einer übersichtlichen Hilfe zu einem bestimmten Befehl geben Sie an der
wsadmin-Eingabeaufforderung den folgenden Befehl ein:
print AdminTask.help('Befehlsname')
AdminConfig.save()
Zweck
Verwenden Sie den Befehl addGroupToDestinationRole, um lokalen Buszielen für die angegebenen Rollen einen Gruppenzugriff zu erteilen. Welche Rollen Sie angeben können, richtet sich nach dem Zieltyp.
Zielobjekt
Ohne.
Erforderliche Parameter
- -type Zieltyp
- Sie können einen der folgenden Zieltypen angeben:
- Queue
- Port
- TopicSpace
- ForeignDestination
- Alias
Die zulässigen Rollen für ein Ziel richten sich nach dem Zieltyp. Informationen hierzu finden Sie im Artikel Rollen für Ziele verwalten.
Wenn Sie als Zieltyp "foreignDestination" oder "alias" angeben, muss der Name des fremden Busses, den Sie angeben, der Name des fremden Busses sein, in dem sich das Ziel befindet.
Wenn Sie "Warteschlange" oder "Topic" als Zieltyp angeben, wird der Name des fremden Busses ignoriert. Die Berechtigung wird dem Ziel im lokalen Bus erteilt.
- -bus Busname
- Der Name des lokalen Busses. Mit dem Befehl listSIBuses können Sie die Namen vorhandener Busse auflisten.
- -role Rollentyp
- Sie können einen der folgenden Rollentypen angeben. Der Typ richtet sich nach dem angegebenen Wert für -type.
- Sender
- (Senden) Dieser Rollentyp gilt für die Zieltypen Aliasziel, fremdes Ziel, Portziel, Warteschlangenziel und Topicbereichsziel.
- Receiver
- (Empfang) Dieser Rollentyp gilt für die Zieltypen Aliasziel, Portziel, Warteschlangenziel und Topicbereichsziel.
- Browser
- (Anzeige) Dieser Rollentyp gilt für die Zieltypen Aliasziel, Portziel und Warteschlangenziel.
- -group Gruppenname
- Der Name der Gruppe, die Sie dem Zielrollentyp für den lokalen Bus hinzufügen möchten. Sie können einen Gruppennamen oder eine der folgenden Sondergruppen angeben:
- Server
- Diese Gruppe enthält Anwendungsserver.
- AllAuthenticated
- Diese Gruppe enthält ausschließlich authentifizierte Benutzer.
- Everyone
- Diese Gruppe enthält alle Benutzer. Jeder Benutzer ist anonym.
Vorgegebene Parameter
Ohne.
Optionale Parameter
- -foreignBus Name_des_fremden_Busses
- Geben Sie den Namen des fremden Busses an. Wenn Sie eine Gruppe einem Ziel an einem fremden Ziel oder einem Aliasziel hinzufügen, müssen Sie den Namen des fremden Busses angeben, der das fremde Ziel bzw. das Aliasziel enthält.
- -uniqueName eindeutiger_Name
- Dieser Parameter ist nur gültig, wenn er mit Anwendungsservern von WebSphere Application Server Version 7.0 oder höher verwendet wird. Verwenden Sie diesen Befehl nicht in früheren Versionen. Geben Sie den Namen an, der die Gruppe in der Benutzerregistry eindeutig definiert. Wenn eine LDAP-Benutzerregistry verwendet wird, ist der eindeutige Name der definierte Name (DN) der Gruppe. Sie können Werte für -uniqueName und -group angeben, müssen aber sicherstellen, dass sie dieselbe Gruppe identifizieren. Der Befehl prüft nicht, ob die Werte übereinstimmen.
Beispiele
Der folgende Beispielbefehl fügt eine Gruppe mit dem Gruppennamen Group1 und dem eindeutigen Namen SalesGroup der Rolle "Sender" an einem Ziel des Typs "Warteschlange" mit dem Namen Queue1 in einem lokalen Bus mit dem Namen Bus1 hinzu.
AdminTask.addGroupToDestinationRole ('[-type queue -bus Bus1
-destination Queue1 -role Sender -group Group1 -uniqueName SalesGroup]')
Im folgenden Beispiel wird eine Gruppe mit dem Namen Group2 der Rolle "Receiver" an einem Warteschlangenziel mit dem Namen Queue2 in einem lokalen Bus mit dem Namen Bus1 hinzugefügt.
AdminTask.addGroupToDestinationRole ('[-type queue -bus Bus1
-destination Queue2 -role Receiver -group Group2]')