AddUnixProfile

Adds a new UNIX group profile to a zone.

Syntax

IGroupUnixProfile AddUnixProfile(IZone zone, int gid, string name)
IGroupUnixProfile AddUnixProfile(IZone zone, long gid, string name)

Parameters

Specify the following parameters when using this method.

Parameter Description

zone

The individual zone to which you are adding a new UNIX group profile.

gid

The GID of the new UNIX group profile.

name

The name of the new UNIX group profile.

Return value

The UNIX group object created.

Discussion

The UNIX group profile includes the group name and the numeric group identifier (GID).

Note:   There are two versions of this method: one designed for COM-based programs that supports a 32-bit signed number for the gid argument and one designed for .NET-based programs that allows a 64-bit signed number for the gid argument.

Exceptions

AddUnixProfile may throw one of the following exceptions:

  • ArgumentNullException if the zone parameter value is null.
  • NotSupportedException if the specified zone has an unrecognized schema.

Example

The following code sample illustrates using AddUnixProfile in a script:

...
if (objGroup.UnixProfiles.Find(objZone) == null)
{
    long next_gid = 10000; // use 10000 as default gid
// Get the next available GID for this zone
if (objZone.NextAvailableGID >= 0)
{
    next_gid = objZone.NextAvailableGID;
}
// Add this zone to the group
objGroupUnixProfile = objGroup.AddUnixProfile(objZone, next_gid, strUnixGroup);
// Save
objGroupUnixProfile.Commit();
...