2.2.1.13.1 Element-Specific Attributes

  • Article

Attribute name

Description

action

(optional) If specified, the value MUST be C, D, R, or U, corresponding to Create, Delete, Replace, and Update. If unspecified, the default value is U.

  • Create: This action MUST be used to create a new share for computers.

  • Delete: This action MUST be used to remove (unshare) a share from computers.

  • Replace: This action MUST be used to delete and re-create a share. The net result of the Replace action MUST be to overwrite all existing settings associated with the share. If the share does not exist, then the Replace action MUST create a new share.

  • Update: This action MUST be used to modify settings of a share. This action differs from Replace in that it MUST update only settings defined within the preference item. All other settings MUST remain as configured on the share. If the share does not exist, then the Update action MUST create a new share.

name

MUST be a name for the share.

path

MUST be a path to an existing local filesystem path that the share will point to.

comment

MUST be text to appear in the Comment field of the share.

allRegular

(optional) MUST be set to 1 to modify or delete all shares that are not hidden (have a name ending in $) or special (SYSVOL and NETLOGON).

allHidden

(optional) MUST set to 1 to modify or delete all hidden shares except administrative drive-letter shares, ADMIN$, FAX$, IPC$, and PRINT$.

allAdminDrive

(optional) MUST set to 1 to modify or delete all administrative drive-letter shares (named with a drive letter followed by $).

limitUsers

(optional) To restrict the number of users, MUST be set to SET_LIMIT. To make the number of users unrestricted, MUST be set to MAX_ALLOWED. To leave the allowed number of users unchanged when updating a share, MUST be set to NO_CHANGE.

userLimit

 (optional) if limitUsers is set to "SET_LIMIT", specified the number of user to limit.

abe

(optional) Access-based enumeration: Configures the visibility of folders within the share. To make folders within the share visible only to those who have read access, MUST be set to ENABLE. To make folders within the share visible to all users, MUST be set to DISABLE. To leave the visibility of folders within the share unchanged when updating a share, MUST be set to NO_CHANGE.