new_zone_user command to create a new zone user in the current zone based on an existing Active Directory user. If the command is successful, the new zone user becomes the currently selected zone user stored in memory.
new_zone_user command does not set any field values or save the new zone user to Active Directory. Before you can save the new zone user, you must first set at least one field value using the
set_zone_user_field command. You can then save the zone user profile using the
Note: If the currently selected zone is a classic zone, you must set all fields for the new zone user before saving the user profile.
If you don’t save a new zone user, it will disappear when you select another zone user or end the ADEdit session.
You can create more than one zone user within a zone based on a single Active Directory user. The first zone user you create uses the Active Directory user’s user principal name (UPN), for example,
email@example.com. Any other zone users you create for the same Active Directory user must use aliases. An alias is the Active Directory user’s UPN with “
+n” appended where
n is a positive integer that is unique for this Active Directory user in this zone. For example,
firstname.lastname@example.org+1 is an alias, as is
email@example.com+5. Alias integers need not be consecutive or in order. (Note that SFU zones do not support user aliases.)
new_zone_user command requires you to specify Active Directory user name. The command will search for the user first by the supplied UPN in the specified domain, then by the
sAMAccountname in the specified domain, then by the supplied UPN in any bound domain. If the user name cannot be found, the new zone user is not created.
Classic and hierarchical
This command takes no options.
This command takes the following argument:
Required. Specifies the user principal name (UPN) of an Active Directory user. If you are specifying an alias, append the UPN with “+” followed by a positive integer that is unique for this user and the zone.
This command returns nothing if it runs successfully.
This example creates a new zone user based on the Active Directory user
firstname.lastname@example.org in the current zone.
Before you use this command, you must have a currently selected zone stored in memory. The following commands enable you to view and select a zone user:
- get_zone_users returns a Tcl list of the Active Directory names of all zone users in the current zone.
- list_zone_users lists to
stdoutthe zone users and their NSS data in the current zone.
- select_zone_user retrieves a zone user from Active Directory and stores it in memory.
After you have a zone user stored in memory, you can use the following commands to work with that zone user:
- delete_zone_user deletes the selected zone user from Active Directory and from memory.
- get_zone_user_field reads a field value from the currently selected zone user.
- save_zone_user saves the selected zone user with its current settings to Active Directory.
- set_zone_user_field sets a field value in the currently selected zone user.