docs/reference-manual/src/main/jbake/content/delete-admin-object.adoc

type=page
status=published
title=delete-admin-object
next=delete-application-ref.html
prev=create-virtual-server.html
~~~~~~
delete-admin-object
===================

[[delete-admin-object-1]][[GSRFM00063]][[delete-admin-object]]

delete-admin-object
-------------------

removes the administered object with the specified JNDI name.

[[sthref577]]

Synopsis

[source,oac_no_warn]
----
asadmin [asadmin-options] delete-admin-object [--help] 
[--target target] jndi_name
----

[[sthref578]]

Description

The `delete-admin-object` subcommand removes an administered object with
the specified JNDI name.

This subcommand is supported in remote mote only.

[[sthref579]]

Options

asadmin-options::
  Options for the `asadmin` utility. For information about these
  options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
  Displays the help text for the subcommand.
`--target`::
  This is the name of the targets for which the administered object is
  to be deleted. Valid values are: +

[width="100%",cols="100%",]
|=======================================================================
a|
Note:

Resources are always created for a domain as a whole but are only
active for targets for which a `<resource-ref>` has been created using
the `--target` option when the resource was created. This means that
deleting a resource only deletes the `<resource-ref>` element for the
specified `--target`, and does not delete the resource from the domain
as a whole unless `domain` is specified as the `--target` for the
deletion.

|=======================================================================

  `server`;;
    Deletes the administered object for the default server instance
    `server` and is the default value.
  configuration_name;;
    Deletes the administered object for the specified configuration.
  cluster_name;;
    Deletes the administered object for the specified cluster.
  instance_name;;
    Deletes the administered object for a particular server instance.

[[sthref580]]

Operands

jndi_name::
  JNDI name of the administered object to be deleted.

[[sthref581]]

Examples

[[GSRFM530]][[sthref582]]

Example 1   Deleting an Administered Object

This example deletes the administered object named `jms/samplelqueue`.

[source,oac_no_warn]
----
asadmin> delete-admin-object jms/samplequeue
Command delete-admin-object executed successfully
----

[[sthref583]]

Exit Status

0::
  subcommand executed successfully
1::
  error in executing the subcommand

[[sthref584]]

See Also

link:asadmin.html#asadmin-1m[`asadmin`(1M)]

link:create-admin-object.html#create-admin-object-1[`create-admin-object`(1)],
link:list-admin-objects.html#list-admin-objects-1[`list-admin-objects`(1)]