The tarantella role Command

You use this command to give users specific roles, and to give them assigned applications that apply to that role.

Syntax

tarantella role add_link | add_member | list | list_links | list |
list_members | remove_link | remove_member

Description

The following table shows the available subcommands for this command.

Subcommand Description More Information add_link Adds assigned applications links for occupants of particular roles. tarantella role add_link add_member Adds occupants to particular roles. tarantella role add_member list Lists and describes all available roles. tarantella role list list_links Lists the assigned applications links for occupants of particular roles. tarantella role list_links list_members Lists the occupants of particular roles. tarantella role list_members remove_link Removes assigned applications links for users occupying particular roles. tarantella role remove_link remove_member Removes occupants from particular roles. tarantella role remove_member

Examples

The following example lists all available roles.

$ tarantella role list

The following example adds a link for the application Indigo Time to the assigned applications of users occupying the Global Administrators role.

$ tarantella role add_link \
--role global \
--link "o=applications/cn=Indigo Time"

tarantella role add_link

Adds assigned applications links for users occupying particular roles.

Syntax

tarantella role add_link { --role rolename
                           --link lobj...
                         } | --file file

Description

The following table shows the available options for this command.

Option Description --role Specifies the name of a role, for example global. Use tarantella role list to find out the available roles. --link Specifies the names of objects to add to the assigned applications of users occupying the role, for example, o=applications/cn=Indigo Time. --file Specifies a file containing a batch of commands to add assigned applications links for users with a particular role.

Examples

The following example adds a link for the application Indigo Time to the assigned applications of users occupying the Global Administrators role.

$ tarantella role add_link \
--role global \
--link "o=applications/cn=Indigo Time"

tarantella role add_member

Adds occupants to particular roles.

Syntax

tarantella role add_member { --role rolename
                             --member mobj...
                           } | --file file

Description

The following table shows the available options for this command.

Option Description --role Specifies the name of a role, for example global. Use tarantella role list to find out the available roles. --member Specifies the names of user profile objects or profile objects for the users you want to occupy the role. --file Specifies a file containing a batch of commands to add occupants to particular roles.

Examples

The following example adds Sid Cerise to the Global Administrators role.

$ tarantella role add_member \
--role global \
--member "o=Indigo Insurance/ou=Finance/cn=Sid Cerise"

tarantella role list

Lists and describes all available roles, including the name of the role object applicable to each role.

Syntax

tarantella role list

Description

Use the short name, for example “global”, with other tarantella role commands.

Examples

The following example lists all available roles.

$ tarantella role list

tarantella role list_links

Lists the assigned applications links for occupants of particular roles. The name for each link is shown.

Syntax

tarantella role list_links --role rolename | --file file

Description

The following table shows the available options for this command.

Option Description --role Specifies the name of a role, for example global. Use tarantella role list to find out the available roles. --file Specifies a file containing a batch of commands to list the assigned applications for role occupants.

Examples

The following example lists the assigned applications for occupants of the Global Administrators role.

$ tarantella role list_links --role global

tarantella role list_members

Lists the occupants of particular roles. The name for each member is shown.

Syntax

tarantella role list_members --role rolename | --file file

Description

The following table shows the available options for this command.

Option Description --role Specifies the name of a role, for example global. Use tarantella role list to find out the available roles. --file Specifies a file containing a batch of commands to list the occupants of a particular role.

Examples

The following example lists the names of all occupants of the Global Administrators role.

$ tarantella role list_members --role global

tarantella role remove_link

Removes assigned applications links for users occupying particular roles.

Syntax

tarantella role remove_link { --role rolename
                              --link lobj...
                            } | --file file

Description

The following table shows the available options for this command.

Option Description --role Specifies the name of a role, for example global. Use tarantella role list to find out the available roles. --link Specifies the names of assigned applications links to remove for users occupying the role. For example, o=applications/cn=Indigo Time. --file Specifies a file containing a batch of commands to remove assigned applications links of users with a particular role.

Examples

The following example removes the Write-o-Win application from the assigned applications of members of the Global Administrators role.

$ tarantella role remove_link \
--role global \
--link "o=applications/cn=Write-o-Win"

tarantella role remove_member

Removes occupants from particular roles.

Syntax

tarantella role remove_member { --role rolename
                                --member mobj...
                              } | --file file

Description

The following table shows the available options for this command.

Option Description --role Specifies the name of a role, for example global. Use tarantella role list to find out the available roles. --member Specifies the names of objects for the users you do not want to occupy the role. --file Specifies a file containing a batch of commands to remove occupants from a particular role.

Examples

The following example removes Sid Cerise from the Global Administrators role.

$ tarantella role remove_member \
--role global \
--member "o=Indigo Insurance/ou=Finance/cn=Sid Cerise"