Befehl "addUserToDestinationRole"
Verwenden Sie den Befehl addUserToDestinationRole, um einen Benutzer 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 addUserToDestinationRole, um einem Benutzer den Zugriff auf lokale Busziele für die angegebenen Rollen 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
- Dieser Rollentyp ist berechtigt, Nachrichten an Ziele im lokalen Bus zu senden.
- Receiver
- Dieser Rollentyp ist berechtigt, Nachrichten von Zielen im lokalen Bus zu empfangen.
- Browser
- Dieser Rollentyp ist berechtigt, Nachrichten an Zielen im lokalen Bus anzuzeigen.
- -user Benutzername
- Der Name des Benutzers, den Sie dem Zielrollentyp für den lokalen Bus hinzufügen möchten.
Vorgegebene Parameter
Ohne.
Optionale Parameter
- -foreignBus Name_des_fremden_Busses
- Geben Sie den Namen des fremden Busses an. Wenn Sie einen Benutzer eines Ziels 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 den Benutzer in der Benutzerregistry eindeutig definiert. Wenn eine LDAP-Benutzerregistry verwendet wird, ist der eindeutige Name der definierte Name (DN) des Benutzers. Sie können Werte für -uniqueName und -user angeben, müssen aber sicherstellen, dass sie denselben Benutzer identifizieren. Der Befehl prüft nicht, ob die Werte übereinstimmen.
Beispiele
Der folgende Beispielbefehl fügt einen Benutzer mit dem Namen User1 der Rolle "Sender" einem Ziel des Typs "Warteschlange" mit dem Namen Queue1 in einem lokalen Bus mit dem Namen Bus1 hinzu.
Admintask.addUserToDestinationRole ('[-type queue -bus Bus1
-destination Queue1 -role Sender -user User1]')
Der folgende Beispielbefehl fügt einen Benutzer mit dem Namen User2 der Rolle "Receiver" einem Ziel des Typs "Wartschlange" mit dem Namen Queue2 in einem lokalen Bus mit dem Namen Bus1 hinzu.
Admintask.addUserToDestinationRole ('[-type queue -bus Bus1
-destination Queue2 -role Receiver -user User2]')