Beaker

bkr group-modify: Modify a group

Synopsis

bkr group-modify [options] <group-name>

Description

Modify an existing group.

Options

--display-name

New display name of the group.

--group-name

New name of the group.

--description

New description of the group.

--add-member

Add a user to the group. This option can be specified multiple times to add more than one user to the group. Should a specified user fail to be added, all subsequent users are ignored.

--remove-member

Remove a user from the group. This option can be specified multiple times to remove more than one user from the group. Should a specified user fail to be removed, all subsequent users are ignored.

--grant-owner

Grant group owner permissions to an existing group member.

--revoke-owner

Remove group owner permissions from an existing group owner.

--root-password

Root password for group jobs.

Common bkr options are described in the Options section of bkr(1).

Exit status

Non-zero on error, otherwise zero.

Examples

Modify an existing group ‘mygroup’ with the new display name ‘A new group’:

bkr group-modify --display-name="A new group" mygroup

Modify an existing group ‘mygroup’ with the new display name ‘A new group’ and new group name ‘mynewgroup’:

bkr group-modify --display-name="A new group" --group-name="mynewgroup" mygroup

Add a user with username ‘user1’ to the group ‘mygroup’:

bkr group-modify --add-member user1 mygroup

Remove an existing group member with username ‘user1’ from the group ‘mygroup’:

bkr group-modify --remove-member user1 mygroup

Add an existing group member with username ‘user1’ as an owner of group ‘mygroup’:

bkr group-modify --grant-owner user1 mygroup

Revoke group owner rights from an existing group owner of group ‘mygroup’ with username ‘user1’:

bkr group-modify --revoke-owner user1 mygroup

See also

bkr(1)