new_zone_computer
Use the new_zone_computer
command to create a new zone computer in the current zone and set the new zone computer as the currently selected zone computer in memory. The new zone computer has no field values set.
The new_zone_computer
command does not save the new zone computer to Active Directory. To save the new zone computer, you must use save_zone_computer
. If you don’t save a new zone computer, it will disappear when you select another zone computer or when the ADEdit session ends.
The new_zone_computer
command requires you to specify an Active Directory computer account name. If the computer name you specify is not found in Active Directory, the command does not create the zone computer.
Zone type
Classic and hierarchical
Syntax
new_zone_computer sAMAccountName@domain
Abbreviation
newzc
Options
This command takes no options.
Arguments
This command takes the following argument:
Argument | Type | Description |
sAMAccountName @domain |
string |
Required. Specifies the sAMAccountName of an Active Directory computer followed by @ and the domain name where the computer is located. |
Return value
This command returns nothing if it runs successfully.
Examples
new_zone_computer sales2$@acme.com
This example creates a new zone computer sales2@acme.com
in the current zone. Note that Tcl syntax requires “$@
” to represent a literal “@
”. You could also enclose the argument in braces: {sales2@acme.com}
.
Related commands
Before you use this command, you must have a currently selected zone stored in memory. The following commands enable you to view and manage the zone computers:
- get_zone_computers returns a Tcl list of the Active Directory names of all zone computers in the current zone.
- list_zone_computers lists to
stdout
the zone computers in the current zone. - new_zone_computer creates a new zone computer and stores it in memory.
- select_zone_computer retrieves a zone computer from Active Directory and stores it in memory.
After you have a zone computer stored in memory, you can use the following commands to work with that zone computer:
- delete_zone_computer deletes the zone computer from Active Directory and from memory.
- get_zone_computer_field reads a field value from the currently selected zone computer.
- save_zone_computer saves the zone computer with its current settings to Active Directory.
- set_zone_computer_field sets a field value in the currently selected zone computer.