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();
...
Doc Feedback