72/461

## delete-auth-realm

removes the named authentication realm

Synopsis

    delete-auth-realm [--help]
    [--target target]
    auth_realm-name

Description

The `delete-auth-realm` subcommand removes the named authentication realm. This subcommand is supported in remote mode only.

Options

`--help`
`-?`

  Displays the help text for the subcommand.

`--target`

  Specifies the target on which you are deleting the authentication realm. Valid values are

  `server`

    Deletes the realm for the default server instance `server` and is the default value.

  configuration_name

    Deletes the realm for the named configuration.

  cluster_name

    Deletes the realm for every server instance in the cluster.

  instance_name

    Deletes the realm for a particular server instance.

Operands

auth_realm_name

  Name of the realm to be deleted.

Examples

Example 1 Deleting an Authentication Realm

  This example deletes the authentication realm `db`.

      asadmin> delete-auth-realm db
      Command delete-auth-realm executed successfully

Exit Status

0

  command executed successfully

1

  error in executing the command

See Also

create-auth-realm(1), list-auth-realms(1)

asadmin(1M)