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.

[IBM i][IBM i]Der Scripting-Client wsadmin wird über die Qshell ausgeführt. [IBM i]Weitere Informationen finden Sie unter Qshell für die Ausführung von WebSphere-Scripts mit wsadmin-Scripting konfigurieren.

Für die SIB-Befehle wird jeweils eine Befehlszeilenhilfe bereitgestellt:
  • 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')

Speichern Sie Ihre Änderungen nach der Ausführung des Befehls in der Masterkonfiguration. Verwenden Sie hierfür beispielsweise den folgenden Befehl:

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]')

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjr_add_usr_dest_role
Dateiname:rjr_add_usr_dest_role.html