type=page
status=published
title=list-virtual-servers
next=list-web-context-param.html
prev=list-transports.html
~~~~~~

= list-virtual-servers

[[list-virtual-servers-1]][[GSRFM00207]][[list-virtual-servers]]

== list-virtual-servers

Lists the existing virtual servers

[[sthref1850]]

=== Synopsis

[source]
----
asadmin [asadmin-options] list-virtual-servers [--help]
[target]
----

[[sthref1851]]

=== Description

The `list-virtual-servers` subcommand lists the existing virtual
servers. This subcommand is supported in remote mode only.

[[sthref1852]]

=== 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.

[[sthref1853]]

=== Operands

target::
  Restricts the listing to virtual servers for a specified target. Valid
  values are as follows:

  `server`;;
    Lists the virtual servers for the default server instance. This is
    the default value.
  configuration-name;;
    Lists the virtual servers for the specified configuration.
  cluster-name;;
    Lists the virtual servers for all server instances in the specified
    cluster.
  instance-name;;
    Lists the virtual servers for the specified server instance.

[[sthref1854]]

=== Examples

[[GSRFM717]][[sthref1855]]

==== Example 1   Listing Virtual Servers

The following command lists all the virtual servers for the server
instance:

[source]
----
asadmin> list-virtual-servers
server
__asadmin
Command list-virtual-servers executed successfully.
----

[[sthref1856]]

=== Exit Status

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

[[sthref1857]]

=== See Also

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

link:create-virtual-server.html#create-virtual-server-1[`create-virtual-server`(1)],
link:delete-virtual-server.html#delete-virtual-server-1[`delete-virtual-server`(1)]