Managing SMB Groups (Task Map)

This section describes how to manage SMB groups and privileges for the SMB server.

Note - SMB groups apply only to users that are connected through SMB.

For information about SMB groups and local users, see Local SMB Groups.

The following table points to the tasks that you can use to manage SMB groups through the SMB server.

Task	Description	For Instructions
Create an SMB group.	Create an SMB group to manage users.	How to Create an SMB Group
Add a member to an SMB group.	Add a member to an SMB group by using the `smbadm` command.	How to Add a Member to an SMB Group
Remove a member from an SMB group.	Remove a member from an SMB group by using the `smbadm` command.	How to Remove a Member From an SMB Group
Modify SMB group properties.	An SMB group can grant the following privileges: `backup`. Permit group members to back up file system objects. `restore`. Permit group members to restore file system objects. `take-ownership`. Permit group members to take ownership of file system objects. You can specify a description of the SMB group if you modify the value of the `description` property.	How to Modify SMB Group Properties

You use the smbadm(1M) command to manage SMB groups on the system that runs the SMB server.

How to Create an SMB Group

In order to provide proper identity mapping between SMB groups and Oracle Solaris groups, an SMB group must have a corresponding Oracle Solaris group. This requirement has two consequences. First, the group name must conform to the intersection of the Windows and Oracle Solaris group name rules. Thus, an SMB group name can be up to eight (8) characters long and contain only lowercase characters and numbers. Second, an Oracle Solaris group has to be created before an SMB group can be created. The Oracle Solaris group is created by using the groupadd command. See the groupadd(1M) man page.

Become an administrator, obtain the solaris.smf.value.shares and solaris.smf.manage.shares RBAC authorizations, or use the SMB Management RBAC profile.
For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.
Choose the name of the group to create.
You might choose a name that reflects a common set of tasks that the group can perform or the organization to which the group members belong.
Create the SMB group.
```
# smbadm create-group [-d description] group-name
```
The -d option is used to specify a textual description of the SMB group.
For example, to create a group called wsales, type:
```
# smbadm create-group -d "Sales Force for the Western Region" wsales
```

How to Add a Member to an SMB Group

Become an administrator, obtain the solaris.smf.value.shares and solaris.smf.manage.shares RBAC authorizations, or use the SMB Management RBAC profile.
For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.
Add a user to the SMB group.
```
# smbadm add-member -m member-name [[-m member-name] ...] group-name
```
member-name can be specified as [domain-name\]username or [domain-name/]username. The domain name is the domain in which the user can be authenticated. By default, the domain name is the name of the domain that you joined.
The backslash (\) is a shell special character and must be quoted. For instance, escape the backslash with another backslash: domain\\username. For more information about handling shell special characters, see the man page for your shell.
For example, to add user terry of the sales domain to the wsales group, type:
```
# smbadm add-member -m sales\\terry wsales
```
To add a local user to an SMB group, specify the Oracle Solaris host name rather than the domain name. For example, to add local user terry of the solarsystem host to the wsales group, type:
```
# smbadm add-member -m solarsystem\\terry wsales
```

How to Remove a Member From an SMB Group

Become an administrator, obtain the solaris.smf.value.shares and solaris.smf.manage.shares RBAC authorizations, or use the SMB Management RBAC profile.
For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.
Remove a user from the SMB group.
```
# smbadm remove-member -m member-name [[-m member-name] ...] group-name
```
member-name can be specified as [domain-name\]username or [domain-name/]username. The domain name is the domain in which the user can be authenticated. By default, the domain name is the name of the domain that you joined.
The backslash (\) is a shell special character and must be quoted. For instance, escape the backslash with another backslash: domain\\username. For more information about handling shell special characters, see the man page for your shell.
For example, to remove user terry of the sales domain from the wsales group, type:
```
# smbadm remove-member -m sales\\terry wsales
```
To remove a local user from an SMB group, specify the Oracle Solaris host name rather than the domain name. For example, to remove local user terry of the solarsystem host from the wsales group, type:
```
# smbadm remove-member -m solarsystem\\terry wsales
```

How to Modify SMB Group Properties

Become an administrator, obtain the solaris.smf.value.shares and solaris.smf.manage.shares RBAC authorizations, or use the SMB Management RBAC profile.
For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.
Modify one or more SMB group properties.
```
# smbadm set-group -p property=value [[-p property=value] ...] group-name
```
You can specify one or more property-value pairs on the command line. Each property-value pair must be preceded by the -p option. Valid values for privileges are on or off. The value of the description property is an arbitrary text string.
For example, to grant the backup privilege and to modify the description of the wsales group, type:
```
# smbadm set-group -p backup=on \
-p description="Sales force for the Western region" wsales
```

Skip Navigation Links
Exit Print View
	Managing SMB File Sharing and Windows Interoperability in Oracle Solaris 11.1 Oracle Solaris 11.1 Information Library