Adding external members to placesAdded by IBM on December 16, 2010 | Version 1 (Original)
|You can use the qptool addmember command to add a name from a user directory as a member of a place or places. When you use qptool addmember rather than the user interface, you can add a member to multiple places at once.
You can use the qptool addmember
command to add a name from a user directory as a member of a place or places. When you use qptool addmember
rather than the user interface, you can add a member to multiple places at once.
About this task
Keep the following points in mind:
- When you use the command, you must use the -reader, -author, -editor, -manager, or -owner argument to specify the access the member has to the place's main room. Optionally, you can use the -allrooms argument to apply the member's main room access to all subrooms.
- If you use the user interface to change an existing external member's access to the main room in a place, subrooms do not inherit the access change. To change an existing member's access to all rooms in a place, use the qptool removemember command to delete the member from the place, and then use qptool addmember -allrooms to add the member again with the new access.
- You cannot use the command to add local members.
- You cannot use the command to add members to the LotusQuickr/lotusquickr place used for server administration.
Enter the following command at the server console to add external members to places:
load qptool addmember arguments
are arguments described in
Table 1. Arguments for the qptool addmember command
|-?||Prints help on the command.|
|-dn name ||Specifies the name of an external user or group to add as a member. If the name contains at least one space, include quotation marks (" ") around it. Specify the name exactly as it is defined in the directory, for example: |
Include any spaces in the name. Specify the character case (uppercase or lowercase) correctly.
Note: The server does not look up the name in the user directory to verify the name you specify. Be sure the name you specify is valid.
|-g ||Indicates that a name specified for the -dn argument is the name of a group.|
You must use this argument to add an external group. If you use qptool addmember without the -g argument to add an external group as a member of a place, users who are members of the group can't access the place through the group membership, and the group may not show up in the user interface in some places.
|-reader||Adds the specified name as a Reader of a place.|
|-author||Adds the specified name as an Author of a place.|
|-editor||Adds the specified name as an Editor of a place.|
|-manager||Adds the specified name as a Manager of a place.|
|-owner||Adds the specified name as an Owner of a place.|
|-allrooms||Applies the place access specified for the name to all rooms in a place. If you omit this argument, the name's specified access applies only to a place's main room. |
|-a||Adds the specified name as a member of all places on the server. |
|-p place(s) ||Adds the specified name as a member of a specific place or space-separated list of places.|
|-i inputfilename ||XML input file located in the server program directory that specifies the places in which to add an external member.|
|-o outputfilename ||XML output file that logs the results of the command. By default the command logs results to qptool.addmember.xml in the server program directory.|
Table 2 provides examples of the qptool addmember
Table 2. Examples of the qptool addmember command
|Add the user cn=Connor Jones,ou=Sales,o=Acme as an author of all rooms in Place1||load qptool addmember -dn "cn=Connor Jones,ou=Sales,o=Acme" -author -allrooms -p Place1|
|Add the group cn=Salesgroup,o=Acme as a reader of the main room in all places ||load qptool addmember -dn cn=Salesgroup,o=Acme -g -reader -a|
Parent topic: Managing place membership