ServerGroup - removePermission


ServerGroup - removePermission

Description :

This command removes a permission entry from the ACL controlling access to a server group. A permission consists of a role and an authorization.

Returns the DBKey of the server group.

This command works only on static server groups. For smart server groups, use the corresponding Group-removePermission with modelType 5007 (SMART_SERVER_GROUP).

You must call this command with a valid authorization name, role name, and server group name. Otherwise this command returns an error.

Valid authorizations for a server group are:

  • ServerGroup.Read
  • ServerGroup.Modify
  • ServerGroup.ModifyACL
  • ServerGroup.Delete
  • ServerGroup.Write
  • ServerGroup.*

Return type : DBKey

Command Input :

Variable Name

Variable Type

Description

groupName

String

The fully qualified name of the server group.

roleName

String

Name of the role.

authName

String

Name of the authorization.

Example

The following example shows how to remove the permission consisting of the role "SampleRole" and the authorization "ServerGroup.Read" from a server group called "/Sample Group".

Script

ServerGroup removePermission "/Sample Group" SampleRole ServerGroup.Read

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Server Automation Command Line Interface 8.7