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 an actual ampersand symbol @. You could also enclose the argument in braces: {sales2@acme.com}.

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.