When you invoke the command-line management utility, it will be set to
manage the default user domain. To manage a different user
domain, you need to issue a SET DOMAIN command. This command tells the
utility that all further commands will affect the specified user
domain. For instance, to manage the frob.org domain, issue
the command
popstore> SET DOMAIN frob.orgIf you are logged in to a privileged management account at the time you issue the SET DOMAIN command, then you will automatically be logged out unless the management account was in the
default user
domain and not in any management group. This is a reflection of the
management policy that only privileged accounts in the
default user domain and in no management group may manage
all accounts in all user domains.
Once the user domain has been selected, all subsequent commands will
affect accounts in only that user domain. The default user
domain can be re-selected with either the command "SET DOMAIN
default" or, more succinctly, SET DOMAIN (no domain name
parameter). The currently selected user domain may be shown by issuing
the SET command without any parameters:
popstore> SET Using the "default" user domain ... popstore> SET DOMAIN frob.org popstore> SET Using the "frob.org" user domain ...
Note that presently, no commands are provided to copy or rename an account between user domains. The popstore API does, however, provide this functionality via the POPSTORE_user_copy_d subroutine.