When information about an external member, such as an e-mail address, changes in the user directory, use the qptool updatemember
command to update the information in places.
About this task
updates the following information:
- E-mail address (external users)
- First name (external users)
- Last name (external users)
- Phone number (external users)
- Display name (external users)
- Display name (external groups)
does not operate on local members.
The command does not change an external member's distinguished name stored internally in places and used for access control. If external members' distinguished names change in the user directory, use the qptool changemember
or qptool changehierarchy
command to update the distinguished names in places.
To update external member information in places, enter the following command at the server console:
load qptool updatemember arguments
are described in Table 1 .
Specify names exactly, remembering to include any spaces and to use the exact character case. If a name contains spaces, put quotation marks (") around it.
Table 1. Arguments for the qptool updatemember command
|-?||Prints help on the command.|
|-dn name ||Specifies the name of an external user or group whose member information has changed in the user directory, for example:. "cn=Connor Jones,ou=Sales,o=Acme"|
If you use this argument, do not use -allmembers.
|-allmembers||Updates all external member information in the specified place(s). If you use this argument, do not use -dn name. |
You can run qptool updatemember -allmembers -a on a schedule. How often you should run it depends on how often the contents of your user directory changes.
|-g ||Indicates that a name specified for the -dn argument is the name of a group.|
|-a||Updates external member information in all places|
|-p place(s) ||Updates external member information in 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 update external member information.|
|-o outputfilename ||XML output file that logs the results of the command. By default the command logs results to qptool.updatemember.xml in the server program directory.|
Table 2 provides examples of the qptool updatemember
Table 2. Examples of qptool updatemember
|Update the member information for the user cn=Connor Jones,ou=Sales,o=Acme in all places||load qptool updatemember -dn "cn=Connor Jones,ou=Sales,o=Acme" -a|
|Use the notes.ini file to update all member information in all places daily at 3 AM.||ServerTasksAt3=qptool updatemember -allmembers -a|
|Update the member information for the group cn=Adminstrators,o=Acme in all places||load qptool updatemember -dn cn=Administrators,o=Acme -g -a|
Parent topic: Managing place membership