NextAvailableUID

Returns or sets the next available value for the user identifier (UID) in the zone.

Syntax

int nextAvailableUID {get; set;}

Property value

The numeric value of the next available UID for the zone.

Discussion

This method returns or sets the next available UID to be used as the default UID assignment for the next user given access the zone. If you are setting this property as part of creating a new zone, use this value to define the starting UID for all users in the zone. In most cases, this value is incremented automatically each time a new user is enabled for the zone. If you are creating new users programmatically, you can use this property to read the current value.

There are two versions of this property: one designed for COM-based programs (nextAvailableUID) that supports a 32-bit signed number for the UID and one designed for .NET-based programs (NextUID) that allows a 64-bit signed number for the UID. You can use either method.

Example

The following code sample illustrates setting this property in a script:

...  
'Specify the zone you want to work with  
set objZone = cdc.GetZone("ajax.org/UNIX/Zones/ea_central")  
'Reset the next available UID for the zone  
objZone.nextAvailableUID = 5000  
zone.Commit()  
...