下列部分将详细描述 WLST 命令和变量。主题包括：

WSLT 命令类别概述

WLST 命令分为下列几种类别。

浏览命令

使用表 A-2 中列出的 WLST 浏览命令，可以导航配置 Bean 或运行时 Bean 的层次，并控制提示显示。

cd

命令类别：浏览命令 用于 WLST：联机版或脱机版

描述

导航配置 Bean 或运行时 Bean 的层次。此命令使用一种类似于在 Windows 或 UNIX 命令外壳中导航文件系统的模型。例如，要导航回父配置 Bean 或运行时 Bean，请输入 cd(‘..‘)。字符串..（点-点）是指当前目录的上一级目录。要在导航到深层 Bean 后返回根 Bean，请输入 cd(‘/‘)。

可以导航到位于当前层次的 Bean，以及任何子级或实例。

cd 命令可返回配置或运行时 Bean 实例的存根控件（如果存根控件存在的话）。如果导航到一种类型，则此命令将从导航的对象返回配置 Bean 或运行时 Bean 实例的存根控件。在出现错误的情况下，此命令将返回WLSTException。

语法

cd(mbeanName)

示例

以下示例可导航配置 Bean 的层次。第一个命令可导航到 Servers 配置 Bean 类型，第二个命令可导航到 myserver 配置 Bean 实例，最后一个命令回退两个层次导航到初始目录位置。

wls:/mydomain/serverConfig> cd(‘Servers‘) wls:/mydomain/serverConfig/Servers> cd(‘myserver‘) wls:/mydomain/serverConfig/Servers/myserver> cd(‘../..‘) wls:/mydomain/serverConfig>

currentTree

命令类别：浏览命令 用于 WLST：联机版

描述

返回层次中的当前位置。通过此命令，可以存储层次中的当前位置，以在浏览后轻松返回到此位置。在出现错误的情况下，此命令将返回 WLSTException。

语法

currentTree()

示例

以下示例可将层次中的当前位置存储到 myTree 中，然后使用 myTree 从管理服务器实例上的运行时 MBean 层次导航返回到 Edit MBean 层次。

wls:/mydomain/edit> myTree=currentTree() wls:/mydomain/edit> serverRuntime() Location changed to serverRuntime tree.This is a read-only tree with ServerRuntimeMBean as the root. For more help, use help(‘serverRuntime‘)
wls:/mydomain/serverRuntime> myTree() wls:/mydomain/edit>

prompt

命令类别：浏览命令 用于 WLST：联机版或脱机版

描述

如果输入此命令时不带参数，则可以根据提示切换路径信息。若由于路径长度而使得提示过长，此命令非常有用。

也可以将 on 或 off 明确指定为命令的参数。如果指定 off，WLST 将隐藏 WLST 提示并默认为 Jython 提示。默认情况下，WLST 提示可显示配置或运行时导航路径信息。

禁用提示详细信息时，要确定层次中的当前位置，可以使用 pwd 命令，如 pwd 中所述。

在出现错误的情况下，此命令将返回 WLSTException。

语法

prompt(myPrompt)

示例

以下示例可根据提示隐藏路径信息，然后重新显示此信息。

wls:/mydomain/serverConfig/Servers/myserver> prompt() wls:/> prompt() wls:/mydomain/serverConfig/Servers/myserver> 

以下示例可隐藏提示并默认为 Jython 提示（由于此命令是使用 WLST 联机版运行的）、更改 Jython 提示，然后重新显示 WLST 提示。此示例还说明了 pwd 命令的使用。

wls:/mydomain/serverConfig/Servers/myserver> prompt(‘off‘) >>>sys.ps1="myprompt>" myprompt> prompt() wls:> pwd() `serverConfig:Servers/myserver‘ wls:> prompt() wls:/mydomain/serverConfig/Servers/myserver> 

pwd

命令类别：浏览命令 用于 WLST：联机版或脱机版

描述

显示配置 Bean 或运行时 Bean 层次中的当前位置。

在已使用 prompt 命令禁止在提示中显示路径信息时，此命令非常有用，如 prompt 中所述。

在出现错误的情况下，此命令将返回 WLSTException。

语法

pwd()

示例

以下示例显示配置 Bean 层次中的当前位置。

wls:/mydomain/serverConfig/Servers/myserver/Log/myserver> pwd() ‘serverConfig:/Servers/myserver/Log/myserver‘

控制命令

使用表 A-3 中列出的 WLST 控制命令，可执行下列任务：

表 A-3 列出了 WLST 配置的控制命令。

addTemplate

命令类别：控制命令 用于 WLST：脱机版

描述

使用应用程序或服务扩展模板扩展当前域。使用 Template Builder 创建应用程序或服务扩展模板。请参阅使用 Domain Template Builder 创建模板。

在出现错误的情况下，此命令将返回 WLSTException。

语法

addTemplate(templateFileName)

示例

以下示例可打开某个域，然后使用指定的扩展模板 DefaultWebApp.jar 扩展此域。

wls:/offline> readDomain(‘c:/bea/user_projects/domains/wlw‘) wls:/offline/wlw> addTemplate(‘c:/bea/wlserver_10.0/common/templates/ applications/DefaultWebApp.jar‘) wls:/offline/wlw> 

closeDomain

命令类别：控制命令 用于 WLST：脱机版

描述

关闭当前域。域一旦关闭，就不能再对其进行编辑。在出现错误的情况下，此命令将返回 WLSTException。

语法

closeDomain()

示例

以下示例可关闭当前域：

wls:/offline> readDomain(‘c:/bea/user_projects/domains/medrec‘) ... wls:/offline/medrec> updateDomain() wls:/offline/medrec> closeDomain() wls:/offline>

closeTemplate

命令类别：控制命令 用于 WLST：脱机版

描述

关闭当前域模板。域模板一旦关闭，就不再可用。在出现错误的情况下，此命令将返回 WLSTException。

语法

closeTemplate()

示例

以下示例可打开现有的域模板，执行某些操作，然后关闭当前域模板。

wls:/offline> readTemplate(‘c:/bea/wlserver_10.0/common/templates/domains/ wls.jar‘) ... wls:/offline/wls> closeTemplate() wls:/offline>

connect

命令类别：控制命令 用于 WLST：联机版或脱机版

描述

将 WLST 连接到 WebLogic Server 实例。

需要您提供已在活动 WebLogic 安全领域中定义的用户的凭据（用户名和密码）。一旦连接到 WebLogic Server 实例，安全策略的集合将确定允许您查看或修改的配置特性。（请参阅“WebLogic Server MBean Reference”中的 Default Security Policies for MBeans。）

可以通过下列任何操作提供用户凭据：

如果在未指定用户名和密码或者配置文件和密钥文件的情况下运行 connect 命令，WLST 将尝试使用以下列出的（按优先顺序排列）方法之一处理命令：

示例

以下示例可将 WLST 连接到 WebLogic Server 实例。在此示例中，管理服务器名称默认为 AdminServer。请注意，如果未使用 SSL 端口或管理端口连接到服务器，将显示警告。

wls:/offline> connect(‘weblogic‘,‘weblogic‘,‘t3://localhost:8001‘) Connecting to weblogic server instance running at t3://localhost:8001 as username weblogic...
Successfully connected to Admin Server ‘AdminServer‘ that belongs to domain ‘mydomain‘.
Warning: An insecure protocol was used to connect to the server.To ensure on-the-wire security, the SSL port or Admin port should be used instead. 
wls:/mydomain/serverConfig>

以下示例可将 WLST 连接到位于指定 URL 的 WebLogic Server 实例。在此示例中，用户名和密码将作为变量传递。此示例使用安全协议。

wls:/offline> username = ‘weblogic‘ wls:/offline> password = ‘weblogic‘ wls:/offline> connect(username,password,‘t3s://myhost:8001‘) Connecting to weblogic server instance running at t3://myhost:8001 as username weblogic...
Successfully connected to Admin Server ‘AdminServer‘ that belongs to domain ‘mydomain‘. wls:/mydomain/serverConfig>

以下示例将使用用户配置文件和密钥文件将 WLST 连接到 WebLogic Server 实例，以提供用户凭据。

wls:/offline> connect(userConfigFile=‘c:/myfiles/myuserconfigfile.secure‘, userKeyFile=‘c:/myfiles/myuserkeyfile.secure‘)  Connecting to weblogic server instance running at t3://localhost:7001 as username ...
Successfully connected to Admin Server ‘AdminServer‘ that belongs to domain ‘mydomain‘. wls:/mydomain/serverConfig> 

createDomain

命令类别：控制命令 用于 WLST：脱机版

描述

使用指定的模板创建域。

在出现错误的情况下，此命令将返回 WLSTException。

语法

createDomain(domainTemplate, domainDir, user, password)

示例

以下示例将通过使用 Avitek MedRec 模板新建域，并将默认用户名和密码设置为 weblogic。该域将被保存到以下目录：c:/bea/user_projects/domains/medrec。

wls:/offline> createDomain(‘c:/bea/wlserver_10.0/common/templates/domains /wls_medrec.jar‘,‘c:/bea/user_projects/domains/medrec‘, ‘weblogic‘, ‘weblogic‘)

disconnect

命令类别：控制命令 用于 WLST：联机版

描述

断开 WLST 与 WebLogic Server 实例的连接。disconnect 命令不会导致 WLST 退出交互式脚本外壳；它会在保持交互式外壳活动的同时关闭当前 WebLogic Server 实例连接，并重置所有变量。

在出现错误的情况下，此命令将返回 WLSTException。

可以使用 connect 命令连接到另一个 WebLogic Server 实例，如 connect 中所述。

语法

disconnect(force)

示例

以下示例可断开与正在运行的服务器的连接：

wls:/mydomain/serverConfig> disconnect() Disconnected from weblogic server: myserver wls:/offline> 

exit

命令类别：控制命令 用于 WLST：联机版或脱机版

描述

从用户会话退出 WLST，并关闭脚本外壳。

如果有正在进行中的编辑会话，WLST 将提示您进行确认。要跳过提示，请将 defaultAnswer 参数设置为 y。

默认情况下，退出 WLST 时，WLST 将为当前 WLST JVM 调用 System.exit(0)。如果要 JVM 使用其他退出代码退出，可通过使用 exitCode 参数指定值。

在出现错误的情况下，此命令将返回 WLSTException。

语法

exit([defaultAnswer], [exitcode])

示例

以下示例将断开与用户会话的连接，并关闭脚本外壳。

wls:/mydomain/serverConfig> exit() Exiting WebLogic Scripting Tool ... c:\>

以下示例可断开与用户会话的连接、关闭脚本外壳，并将错误代码设置为 101。

wls:/mydomain/serverConfig> exit(exitcode=101) Exiting WebLogic Scripting Tool ... c:\>

readDomain

命令类别：控制命令 用于 WLST：脱机版

描述

打开现有域进行更新。

使用 WLST 脱机版，可对在域 config 目录或域模板 JAR（由 Template Builder 创建）中持久存储的配置数据进行读取和写入访问。此数据是 XML 文档的集合，表示管理对象的层次。

打开模板或域时，系统将 WLST 放置到该域配置层次的根位置，并更新提示以反映配置层次中的当前位置。例如：

wls:/offline/base_domain>

有关详细信息，请参阅导航和询问 MBean。

在出现错误的情况下，此命令将返回 WLSTException。

语法

readDomain(domainDirName)

示例

以下示例可打开 medrec 域进行编辑。

wls:/offline> readDomain(‘c:/bea/user_projects/domains/medrec‘) wls:/offline/medrec>

readTemplate

命令类别：控制命令 用于 WLST：脱机版

描述

打开现有域模板以创建域。

如果打开某个域模板，会将 WLST 放入此域模板的配置 Bean 层次中，并且更新提示以反映配置层次中的当前位置。例如：

wls:/offline/base_domain>

WebLogic Server 配置 Bean 存在于层次结构之中。在 WLST 文件系统中，层次相当于驱动程序；类型和示例相当于目录；特性和操作相当于文件。WLST 使用命令（如 cd、ls 和 pwd）遍历配置 Bean 的层次结构，其方式类似于在 UNIX 或 Windows 命令外壳中导航文件系统。导航到配置 Bean 实例之后，您可使用 WLST 命令与 Bean 交互。有关详细信息，请参阅导航和询问 MBean。

在出现错误的情况下，此命令将返回 WLSTException。

语法

readTemplate(templateFileName)

示例

以下示例可打开 medrec.jar 域模板以创建域。

wls:/offline> readTemplate(‘c:/bea/wlserver_10.0/common/templates/domains /wls_medrec.jar‘) wls:/offline/wls_medrec>

updateDomain

命令类别：控制命令 用于 WLST：脱机版

描述

更新并保存当前域。更新并保存某个域后，可继续对此域进行编辑。

在出现错误的情况下，此命令将返回 WLSTException。

语法

updateDomain()

示例

以下示例可打开 medrec 域、执行某些操作，并更新和保存当前域：

wls:/offline> readDomain(‘c:/bea/user_projects/domains/medrec‘) ... wls:/offline/medrec> updateDomain()

writeDomain

命令类别：控制命令 用于 WLST：脱机版

描述

将域配置信息写入指定的目录中。

将域写入文件系统后，可以继续更新内存中的域模板对象，并重新发出 writeDomain 命令，以将域配置存储到新的或现有文件中。

默认情况下，写入域时会将相关联的应用程序写入 BEAHOME/user_projects/applications/domainname，其中 BEAHOME 用于指定 BEA 主目录，domainname 用于指定域的名称。此目录必须为空，否则 WLST 将显示错误。

完成对内存中的域模板对象的使用后，请使用 closeTemplate 命令将其关闭。如果要对已保存到磁盘中的某个域进行编辑，可通过使用 readDomain 命令打开此域。

在写入域之前，必须定义默认用户的密码（如果尚未定义的话）。例如：

cd(‘/Security/base_domain/User/weblogic‘) cmo.setPassword(‘weblogic‘)

在出现错误的情况下，此命令将返回 WLSTException。

语法

writeDomain(domainDir)

示例

以下示例可读取 medrec.jar 域模板，执行某些操作，并将域配置信息写入 c:/bea/user_projects/domains/medrec 目录。

wls:/offline> readTemplate(‘c:/bea/wlserver_10.0/common/templates/domains /wls.jar‘) ... wls:/offline/base_domain> writeDomain(‘c:/bea/user_projects/domains/base_domain‘)

writeTemplate

命令类别：控制命令 用于 WLST：脱机版

描述

将域配置信息写入指定的域模板。可以使用域配置模板重新创建域。

将配置信息写入域配置模板后，可以继续更新内存中的域或域模板对象，并重新发出 writeDomain 或 writeTemplate 命令，以将域配置存储到新的或现有的域或域模板文件中。有关详细信息，请分别参阅 writeDomain 或writeTemplate。

在出现错误的情况下，此命令将返回 WLSTException。

语法

writeTemplate(templateName)

示例

以下示例可将当前域配置写入名为 c:/bea/user_projects/templates/myTemplate.jar 的域模板。

wls:/offline> readDomain(‘c:/bea/user_projects/domains/mydomain‘) ... wls:/offline/base_domain> writeTemplate(‘c:/bea/user_projects/templates/myTemplate.jar‘)

部署命令

使用表 A-4 中列出的 WLST 部署命令，可以执行下列操作：

有关部署应用程序的详细信息，请参阅将应用程序部署到 WebLogic Server。

deploy

命令类别：部署命令 用于 WLST：联机版

描述

将应用程序部署到 WebLogic Server 实例。

deploy 命令可返回 WLSTProgress 对象，可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。在出现错误的情况下，此命令将返回 WLSTException。

语法

deploy(appName, path, [targets], [stageMode], [planPath], [options])

示例

以下示例可对位于 c:/myapps/business 的 businessApp 应用程序进行部署，将创建默认的部署计划。

deploy 命令可返回 WLSTProgress 对象，可以访问此对象以检查命令的状态。WLSTProgress 对象在用户定义的变量（在本案例中为 progress）中被捕获。

wls:/mydomain/serverConfig/Servers> progress= deploy(appName=‘businessApp‘,path=‘c:/myapps/business‘,createplan=‘true‘)

上一个示例可将返回的 WLSTProgress 对象存储在用户定义的变量（在本案例中为 progress）中。然后可以使用 progress 变量打印 deploy 命令的状态。例如：

wls:/mydomain/serverConfig/Servers> progress.printStatus() Current Status of your Deployment: Deployment command type: deploy Deployment State       : completed Deployment Message     : null wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。

以下示例通过将应用程序模块定位到 myserver，并使用位于 c:/myapps/demos/app/plan/plan.xml 的部署计划文件，对归档文件（位于 c:/myapps/demos/app/demoApp.ear）中的 demoApp 应用程序进行部署。WLST 用 120,000 毫秒的时间等待该进程完成。

wls:/mydomain/serverConfig/Servers> deploy(‘demoApp‘, ‘c:/myapps/demos/app/demoApp.ear‘, targets=‘myserver‘, planPath=‘c:/myapps/demos/app/plan/plan.xml‘, timeout=120000)

以下示例通过将应用程序模块定位到指定的目标，对位于 c:/myapps/demos/jmsApp/demo-jms.xml 的 jmsApp 应用程序进行部署。

wls:/mydomain/serverConfig/Servers>deploy(‘jmsApp‘,path=‘c:/myapps/demos/jmsApps/demo-jms.xml‘, subModuleTargets=‘jmsApp@managed1‘)

以下示例显示了如何将应用程序版本 (appVersion) 设置为唯一的标识符，以支持生产环境重新部署（并行）。此示例可对归档文件（位于 c:/myapps/demos/app/demoApp.ear）中的 demoApp 应用程序进行部署，并将应用程序和归档版本号设置为指定的值。

wls:/mydomain/serverConfig> deploy(‘demoApp‘, ‘c:/myapps/demos/app/demoApp.ear‘, archiveVersion=‘901-101‘, appVersion=‘901-102‘)

有关生产环境重新部署策略的详细信息，请参阅“将应用程序部署到 WebLogic Server”中的在生产环境中更新应用程序。

distributeApplication

命令类别：部署命令 用于 WLST：联机版

描述

将部署捆绑复制到指定目标。部署捆绑包括模块、配置数据和任何其他生成的代码。distributeApplication 命令不会启动部署。

distributeApplication 命令可返回 WLSTProgress 对象，可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。在出现错误的情况下，此命令将返回WLSTException。

语法

distributeApplication(appPath, [planPath], [targets], [options])

示例

以下示例可加载位于 c:/myapps 目录下的 BigApp 应用程序，并将 WLSTProgress 对象存储到用户定义的变量（在本案例中为 progress）中。

以下示例通过使用在 c:/deployment/BigApp/plan.xml 中定义的部署计划将 c:/myapps/BigApp 应用程序分发到 myserver、oamserver1 和 oamcluster 服务器中。

wls:/offline> progress=distributeApplication(‘c:/myapps/BigApp‘, ‘c:/deployment/BigApp/plan.xml‘, ‘myserver,oamserver1,oamcluster‘) Distributing Application and Plan ... Successfully distributed the application.

上一个示例可将 WLSTProgress 对象存储在用户定义的变量（在本案例中为 progress）中。然后可以使用 progress 变量来确定 distributeApplication 命令是否已完成。例如：

wls:/mydomain/serverConfig/Servers> progress.isCompleted() 1 wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。

getWLDM

命令类别：部署命令 用于 WLST：联机版

描述

返回 WebLogic DeploymentManager 对象。可以使用对象方法配置和部署应用程序。WLST 必须连接到管理服务器才能运行此命令。在出现错误的情况下，此命令将返回 WLSTException。

语法

getWLDM()

示例

以下示例可获取 WebLogicDeploymentManager 对象，并将此对象存储到 wldm 变量中。

wls:/mydomain/serverConfig> wldm=getWLDM() wls:/mydomain/serverConfig> wldm.isConnected() 1 wls:/mydomain/serverConfig>

loadApplication

命令类别：部署命令 用于 WLST：联机版

描述

将应用程序和部署计划加载到内存中。

loadApplication 命令可返回 WLSTPlan 对象，可以访问此对象以对部署计划进行更改。有关 WLSTPlan 对象的详细信息，请参阅 WLSTPlan 对象。在出现错误的情况下，此命令将返回 WLSTException。

语法

loadApplication(appPath, [planPath], [createPlan])

示例

以下示例通过使用位于 c:/myplans/myejb/plan.xml 的计划文件加载 c:/myapps/myejb.jar 应用程序。

wls:/myserver/serverConfig> myPlan=loadApplication(‘c:/myapps/myejb.jar‘, ‘c:/myplans/myejb/plan.xml‘) Loading application from c:/myapps/myejb.jar and deployment plan from c:/myplans/myejb/plan.xml ... Successfully loaded the application. wls:/myserver/serverConfig>

上一个示例可将返回的 WLSTPlan 对象存储在 myPlan 变量中。然后可以使用 myPlan 变量显示计划相关的信息（例如变量）。例如：

wls:/myserver/serverConfig> myPlan.showVariables() MyEJB jndi.ejb MyWAR app.foo wls:/myserver/serverConfig>

有关 WLSTPlan 对象的详细信息，请参阅 WLSTPlan 对象。

redeploy

命令类别：部署命令 用于 WLST：联机版

描述

重新加载类并重新部署先前已部署的应用程序。

redeploy 命令可返回 WLSTProgress 对象，可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。

在出现错误的情况下，此命令将返回 WLSTException。

有关重新部署应用程序的详细信息，请参阅“将应用程序部署到 WebLogic Server”中的常见部署场景概述。

语法

redeploy(appName, [planPath], [options])

示例

以下示例通过使用位于 c:/myapps 目录下的 plan.xml 文件对 myApp 应用程序进行重新部署。

wls:/mydomain/serverConfig> progress=redeploy(‘myApp‘ ‘c:/myapps/plan.xml‘) Redeploying application ‘myApp‘ ... Redeployment of ‘myApp‘ is successful wls:/mydomain/serverConfig>

上一个示例可将返回的 WLSTProgress 对象存储在用户定义的变量（在本案例中为 progress）中。然后可以使用 progress 变量访问 redeploy 命令的状态。例如：

wls:/mydomain/serverConfig/Servers> progress.getState() `completed‘ wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。

startApplication

命令类别：部署命令 用于 WLST：联机版

描述

启动应用程序，以供用户使用。应用程序必须完整配置且在域中可用。

startApplication 命令可返回 WLSTProgress 对象，可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。在出现错误的情况下，此命令将返回 WLSTException。

语法

startApplication(appName, [options])

示例

以下示例使用指定的部署选项启动 BigApp 应用程序。

wls:/offline> progress=startApplication(‘BigApp‘, stageMode=‘NOSTAGE‘, testMode=‘false‘) Starting the application... Successfully started the application.

上一个示例可将返回的 WLSTProgress 对象存储在用户定义的变量（在本案例中为 progress）中。然后可以使用 progress 变量访问 startApplication 命令的状态。例如：

wls:/mydomain/serverConfig/Servers> progress.getState() `completed‘ wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。

stopApplication

命令类别：部署命令 用于 WLST：联机版

描述

停止应用程序，使其对用户不可用。应用程序必须完整配置且在域中可用。

stopApplication 命令可返回 WLSTProgress 对象，可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。

在出现错误的情况下，此命令将返回 WLSTException。

语法

stopApplication(appName, [options])

示例

以下示例可停止 BigApp 应用程序。

wls:/offline> progress=stopApplication(‘BigApp‘) Stopping the application... Successfully stopped the application.

上一个示例可将返回的 WLSTProgress 对象存储在用户定义的变量（在本案例中为 progress）中。然后可以使用 progress 变量检查 stopApplication 命令是否正在运行。例如：

wls:/mydomain/serverConfig/Servers> progress.isRunning() 0 wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。

undeploy

命令类别：部署命令 用于 WLST：联机版

描述

从指定的服务器中取消某个应用程序的部署。

undeploy 命令可返回 WLSTProgress 对象，可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。在出现错误的情况下，此命令将返回 WLSTException。

有关部署和取消部署应用程序的详细信息，请参阅“将应用程序部署到 WebLogic Server”中的常见部署场景概述。

语法

undeploy(appName,[targets],[options])

示例

以下示例可将 businessApp 应用程序从所有目标服务器中删除。在此过程完成之前，WLST 将等待 60,000 毫秒。

wls:/mydomain/serverConfig> undeploy(‘businessApp‘, timeout=60000) Undeploying application businessApp ... <Jul 20, 2005 9:34:15 AM EDT> <Info> <J2EE Deployment SPI> <BEA-260121> <Initiating undeploy operation for application, businessApp [archive: null],  to AdminServer .>

Completed the undeployment of Application with status Current Status of your Deployment: Deployment command type: undeploy Deployment State       : completed Deployment Message     : no message wls:/mydomain/serverConfig>

updateApplication

命令类别：部署命令 用于 WLST：联机版

描述

通过使用新的部署计划更新应用程序配置。应用程序必须完整配置且在域中可用。

updateApplication 命令可返回 WLSTProgress 对象，可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。在出现错误的情况下，此命令将返回 WLSTException。

语法

updateApplication(appName, [planPath], [options])

示例

以下示例通过使用位于 c:/myapps/BigApp/newPlan 的 plan.xml 文件更新 BigApp 的应用程序配置。

wls:/offline> progress=updateApplication(‘BigApp‘, ‘c:/myapps/BigApp/newPlan/plan.xml‘, stageMode=‘STAGE‘, testMode=‘false‘) Updating the application... Successfully updated the application.

上一个示例可将返回的 WLSTProgress 对象存储在用户定义的变量（在本案例中为 progress）中。然后可以使用 progress 变量访问 updateApplication 命令的状态。例如：

wls:/mydomain/serverConfig/Servers> progress.getState() `completed‘ wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息，请参阅 WLSTProgress 对象。

诊断命令

使用表 A-5 列出的 WLST 诊断命令，通过针对 WebLogic 诊断框架（WebLogic Diagnostics Framework，简称 WLDF）数据存储执行查询，来检索诊断数据。有关 WLDF 的详细信息，请参阅配置和使用 WebLogic 诊断框架。

exportDiagnosticData

命令类别：诊断命令 用于 WLST：脱机版

描述

根据指定的日志文件执行查询。结果将保存在 XML 文件中。

有关 WebLogic Server 诊断服务的详细信息，请参阅配置和使用 WebLogic 诊断框架。

在出现错误的情况下，此命令将返回 WLSTException。

语法

exportDiagnosticData([options])

示例

以下示例可针对名为 myserver.log 的 ServerLog 执行查询，并将结果存储在名为 myExport.xml 的文件中。

wls:/offline/mydomain>exportDiagnosticData(logicalName=‘ServerLog‘, logName=‘myserver.log‘, exportFileName=‘myExport.xml‘) {‘elfFields‘: ‘‘, ‘logName‘: ‘myserver.log‘, ‘logRotationDir‘: ‘.‘, ‘endTimestamp‘: 9223372036854775807L, ‘exportFileName‘: ‘export.xml‘, ‘storeDir‘: ‘../data/store/diagnostics‘, ‘logicalName‘: ‘ServerLog‘, ‘query‘: ‘‘, ‘beginTimestamp‘: 0}
Exporting diagnostic data to export.xml

<Aug 2, 2005 6:58:21 PM EDT> <Info> <Store> <BEA-280050> <Persistent store  "WLS_DIAGNOSTICS" opened: directory="c:\bea\wlserver_10.0\server\data\store\diagnostics"  writePolicy="Disabled" blockSize=512 directIO=false driver="wlfileio2">
wls:/mydomain/serverRuntime>

exportDiagnosticDataFromServer

命令类别：诊断命令 用于 WLST：联机版

描述

在服务器端执行查询，并检索导出的 WebLogic 诊断框架 (WLDF) 数据。结果将保存在 XML 文件中。

有关 WebLogic Server 诊断服务的详细信息，请参阅配置和使用 WebLogic 诊断框架。

在出现错误的情况下，此命令将返回 WLSTException。

语法

exportDiagnosticDataFromServer([options])

示例

以下示例可针对 HTTPAccessLog 执行查询，并将结果存储在名为 myExport.xml 的文件中。

wls:/mydomain/serverRuntime> exportDiagnosticDataFromServer(logicalName="HTTPAccessLog", exportFileName="myExport.xml")

编辑命令

使用表 A-6 中列出的 WLST 编辑命令，可以询问和编辑配置 Bean。

activate

命令类别：编辑命令 用于 WLST：联机版

描述

激活在当前编辑会话期间已保存但尚未部署的更改。如果需要重新启动服务器才能激活更改，此命令将打印一条消息。

activate 命令将返回最新的 ActivationTask MBean，此 MBean 可反映用户当前所进行的或最近已进行的更改的状态。然后可以调用方法以获取有关正在进行的或刚完成的最新配置管理器激活任务的信息。在出现错误的情况下，此命令将返回 WLSTException。

语法

activate([timeout], [block])

示例

以下示例可激活在当前编辑会话期间所进行的、已保存到磁盘但尚未激活的更改。WLST 在激活完成之前，将等待 100,000 毫秒，在停止激活之前，将等待 200,000 毫秒。

wls:/mydomain/edit !> activate(200000, block=‘true‘) Activating all your changes, this may take a while ...  The edit lock associated with this edit session is released once the activation is completed. Action completed. wls:/mydomain/edit>

assign

命令类别：编辑命令 用于 WLST：脱机版

描述

将资源分配到一个或多个目标。

在出现错误的情况下，此命令将返回 WLSTException。

语法

assign(sourceType, sourceName, destinationType, destinationName)

可使用下列准则设置 sourceType 和 destinationType：

示例

下列示例可执行下列操作：

wls:/offline/mydomain> assign("Server", "myServer,myServer2", "Cluster", "myCluster")

wls:/offline/mydomain> assign("Server", "*", "Cluster", "myCluster")

wls:/offline/mydomain> assign("AppDeployment", "myAppDeployment", "Target", "newServer")

wls:/offline/mydomain> assign("User", "newUser", "Group", "Monitors")

wls:/offline/mydomain> assign(‘JMSSystemResource.SubDeployment‘, ‘myJMSResource.myQueueSubDeployment‘, ‘Target‘, ‘newServer‘)

wls:/offline/mydomain>assign(‘AppDeployment.SubDeployment.SubDeployment ‘,‘MedRecEAR.MedRecAppScopedJMS.MedRecJMSServer‘,‘Target‘,‘AdminServer‘)

assignAll

命令类别：编辑命令 用于 WLST：脱机版

描述

将所有应用程序或服务分配到一个或多个目标。

在出现错误的情况下，此命令将返回 WLSTException。

语法

assignAll(sourceType, destinationType, destinationName)

示例

以下示例可将所有服务分配到服务器 adminServer 和 cluster1。

wls:/offline/mydomain> assignAll("Services", "Target", "adminServer,cluster1")

可将下列服务（如果存在）分配到指定的目标：MigratableRMIService、Shutdownclass、Startupclass、FileT3,RMCFactory、MailSession、MessagingBridge、JMSConnectionFactory、JDBCConnectionPool、JDBCMultipool、JDBCTxDatasource、JDBCDataSource、JDBCPoolComp、JoltConnectionPool、WLECConnectionPool和 WTCServer。

cancelEdit

命令类别：编辑命令 用于 WLST：联机版

描述

取消编辑会话，解除编辑锁定，并放弃所有未保存的更改。

发出此命令的用户不一定必须是当前编辑者；这样可允许管理员取消编辑会话（如有必要），以使其他用户可以启动编辑会话。

在出现错误的情况下，此命令将返回 WLSTException。

语法

cancelEdit([defaultAnswer])

示例

以下示例可取消当前编辑会话。在取消前，WLST 将提示进行验证。

wls:/mydomain/edit !> cancelEdit() Sure you would like to cancel the edit session?(y/n)y Edit session is cancelled successfully wls:/mydomain/edit>

create

命令类别：编辑命令 用于 WLST：联机版或脱机版

描述

为当前 Bean 创建指定类型的配置 Bean。

create 命令可返回新建配置 Bean 的存根控件。在出现错误的情况下，此命令将返回 WLSTException。

将 create 命令与 WLST 联机版配合使用时，请注意以下事项：

将 create 命令与 WLST 脱机版配合使用时，请注意以下事项：

有关详细信息：

语法

create(name, childMBeanType, [baseProviderType])

示例

以下示例可为当前配置 Bean 创建名为 newServer、类型为 Server 的子配置 Bean，并将存根控件存储为 server1：

wls:/mydomain/edit !> server1=create(‘newServer‘,‘Server‘) Server with name `newServer‘ has been created successfully. wls:/mydomain/edit !> server1.getName() `newServer‘ wls:/mydomain/edit !>

以下示例可创建称为 myProvider 的身份验证提供程序安全提供程序：

wls:/mydomain/edit !> cd(‘SecurityConfiguration/mydomain/Realms/myrealm‘) wls:/mydomain/edit !> create(‘myProvider‘,‘weblogic.security.providers.authentication.SQLAuthenticator‘,‘AuthenticationProvider‘)

以下示例可创建名为 highsec_nm 的计算机，并设置关联节点管理器的特性。

wls:/mydomain/edit !> create(‘highsec_nm‘, ‘Machine‘) wls:/mydomain/edit !> cd(‘Machine/highsec_nm/NodeManager/highsec_nm‘)  wls:/mydomain/edit !> set(‘DebugEnabled‘, ‘true‘) wls:/mydomain/edit !> set(‘ListenAddress‘, ‘innes‘) wls:/mydomain/edit !> set(‘NMType‘, ‘SSL‘) wls:/mydomain/edit !> set(‘ShellCommand‘, ‘‘)

delete

命令类别：编辑命令 用于 WLST：联机版或脱机版

描述

删除当前配置 Bean 的指定类型的配置 Bean 的实例。

在出现错误的情况下，此命令将返回 WLSTException。

语法

delete(name, childMBeanType)

示例

以下示例可删除名为 newServer、类型为 Server 的配置 Bean：

wls:/mydomain/edit !> delete(‘newServer‘,‘Server‘) Server with name ‘newServer‘ has been deleted successfully. wls:/mydomain/edit !>

encrypt

命令类别：编辑命令 用于 WLST：联机版

描述

对指定的字符串进行加密。然后可以在配置文件中使用加密的字符串，或将其用作命令的参数。

必须为要在其中使用加密字符串的每个域调用一次此命令。只能在最初加密字符串的域中使用相应的字符串。

在出现错误的情况下，此命令将返回 WLSTException。

语法

encrypt(obj, [domainDir])

示例

以下示例通过使用指定域目录中的 security/SerializedSystemIni.dat 文件对指定的字符串进行加密。

wls:/mydomain/serverConfig> es=encrypt(‘myPassword‘,‘c:/bea/domains/mydomain‘)

get

命令类别：编辑命令 用于 WLST：联机版或脱机版

描述

返回指定特性的值。有关可以查看的 MBean 特性的详细信息，请参阅 WebLogic Server MBean Reference。在出现错误的情况下，此命令将返回 WLSTException。

也可以使用 cmo 变量在当前配置 Bean 上执行任一 get 方法。例如：

cmo.getListenPort()

有关 cmo 变量的详细信息，请参阅更改当前管理对象。

语法

get(attrName)

示例

以下示例可为当前配置 Bean 返回 AdministrationPort 的值。

wls:/mydomain/serverConfig> get(‘AdministrationPort‘) 9002

也可以使用 cmo 变量：

cmo.getAdministrationPort()

getActivationTask

命令类别：编辑命令 用于 WLST：联机版

描述

返回用户可以从中获取状态的最新 ActivationTask MBean。ActivationTask MBean 可反映用户当前所进行或最近已进行的更改的状态。然后可以调用方法以获取有关正在进行的或刚完成的最新配置管理器激活任务的信息。在出现错误的情况下，此命令将返回 WLSTException。

语法

getActivationTask()

示例

以下示例可返回用户可在其上获取状态的最新 ActivationTask MBean，并将其存储到 task 变量中。

wls:/mydomain/serverConfig> task=getActivationTask() wls:/mydomain/serverConfig> task.getState() STATE_COMMITTED

invoke

命令类别：编辑命令 用于 WLST：联机版

描述

对当前配置 Bean 调用管理操作。通常，使用此命令可以调用除大多数 WebLogic Server 配置 Bean 提供的 get 和 set 操作之外的操作。类对象是通过用于加载对其调用操作的配置 Bean 的同一类加载器加载的。

WLST 连接到受管服务器实例时不能使用 invoke 命令。

如果成功，invoke 命令将返回由调用的操作返回的对象。在出现错误的情况下，此命令将返回 WLSTException。

语法

invoke(methodName, parameters, signatures)

示例

以下示例可对当前配置 Bean 调用 lookupServer 方法。

wls:/mydomain/config> objs = jarray.array([java.lang.String("oamserver")],java.lang.Object) wls:/mydomain/edit> strs = jarray.array(["java.lang.String"],java.lang.String) wls:/mydomain/edit> invoke(‘lookupServer‘,objs,strs) true wls:/mydomain/edit>

isRestartRequired

命令类别：编辑命令 用于 WLST：联机版

描述

确定是否需要重新启动服务器。

如果在编辑会话正在进行中时调用此命令，则响应将基于当前正在进行中的编辑。如果指定某个特性的名称，WLST 将指示是否仅对于此特性需要重新启动服务器。

在出现错误的情况下，此命令将返回 WLSTException。

语法

isRestartRequired([attributeName])

示例

以下示例可指定在当前 WLST 会话期间进行的所有更改是否需要重新启动服务器。

wls:/mydomain/edit !> isRestartRequired()  Server re-start is REQUIRED for the set of changes in progress.
The following attribute(s) have been changed on MBeans that require server re-start. MBean Changed : mydomain:Name=mydomain,Type=Domain  Attributes changed : AutoConfigurationSaveEnabled 

以下示例可指定如果编辑 ConsoleEnabled 特性，是否需要重新启动服务器。

wls:/mydomain/edit !> isRestartRequired("ConsoleEnabled")  Server re-start is REQUIRED if you change the attribute ConsoleEnabled wls:/mydomain/edit !> 

loadDB

命令类别：编辑命令 用于 WLST：脱机版

描述

将 SQL 文件加载到数据库中。

loadDB 命令可从模板文件中加载 SQL 文件。将域模板或者扩展模板加载到内存中后，方可发出此命令（请参阅 readDomain 和 readTemplate）。

在执行此命令之前，请确保满足下列条件：

如果不能满足上述条件，此命令将失败。

在出现错误的情况下，此命令将返回 WLSTException。

语法

loadDB(dbVersion, datasourceName, dbCategory)

示例

以下示例通过使用 p13nDataSource JDBC 数据源加载与专用于数据库版本 5.1 的 Drop/Create P13N Database Objects 相关的 SQL 文件。

wls:/offline/mydomain> loadDB(‘5.1‘, ‘p13nDataSource‘, ‘Drop/Create P13N Database Objects‘)

loadProperties

命令类别：编辑命令 用于 WLST：联机版 和 Offline

描述

从文件中加载属性值，并使这些值在 WLST 会话中可用。

将 WLST 导入为 Jython 模块时，不能使用此命令，如将 WLST 导入为 Jython 模块中所述。

在出现错误的情况下，此命令将返回 WLSTException。

语法

loadProperties(fileName)

示例

此示例可获取和设置属性文件的值。

wls:/mydomain/serverConfig> loadProperties(‘c:/temp/myLoad.properties‘)

save

命令类别：编辑命令 用于 WLST：联机版

描述

保存已完成但尚未保存的编辑。此命令仅当正在编辑会话时有效。有关启动编辑会话的信息，请参阅 startEdit。

在出现错误的情况下，此命令将返回 WLSTException。

语法

save()

示例

以下示例可保存尚未保存到磁盘的编辑。

wls:/mydomain/edit !> save() Saving all your changes ... Saved all your changes successfully. wls:/mydomain/edit !> 

set

命令类别：编辑命令 用于 WLST：联机版或脱机版

描述

在当前管理对象中设置指定特性的值。在使用 WLST 脱机版时，此命令将特性值写入域的配置文件中。在使用 WLST 联机版时，此命令可设置 MBean 特性的值。当您激活编辑时，会将联机版更改写入到域的配置文件中。

在出现错误的情况下，此命令将返回 WLSTException。

有关设置已加密的特性（所有已加密特性的名称都以 Encrypted 结尾）的信息，请参阅写入和读取加密的配置值。

使用 WLST 联机版时请注意下列事项：

语法

set(attrName, value)

例如

以下示例可将 DomainMBean 的 ArchiveConfigurationCount 特性设置为 10：

wls:/mydomain/serverConfig> set(‘ArchiveConfigurationCount‘,10)

以下示例将自定义 Mbean 的 T1TimerInterval 特性的 Long 值设置为 123：

wls:/mydomain/serverConfig> set(`T1TimerInterval‘, Long(123))

以下示例将自定义 Mbean 的 MyBooleanAttribute 特性的 boolean 值设置为 true：

wls:/mydomain/serverConfig> set(`MyBooleanAttribute‘, Boolean(true))

setOption

命令类别：编辑命令 用于 WLST：脱机版

描述

设置与创建域或更新域相关的选项。在出现错误的情况下，此命令将返回 WLSTException。

语法

setOption(optionName, optionValue)

示例

以下示例可将 CreateStartMenu 选项设置为 false：

wls:/offline> setOption(‘CreateStartMenu‘, ‘false‘)

showChanges

命令类别：编辑命令 用于 WLST：联机版

描述

显示在当前编辑会话期间由当前用户对配置所进行的更改。在出现错误的情况下，此命令将返回 WLSTException。

语法

showChanges([onlyInMemory])

示例

以下示例可显示自启动当前编辑会话之后，当前用户对配置进行的所有更改。

wls:/mydomain/edit !> showChanges() Changes that are in memory and saved to disc but not yet activated are:
MBean Changed           : com.bea:Name=basicWLSDomain,Type=Domain Operation Invoked       : add Attribute Modified      : Machines Attributes Old Value    : null Attributes New Value    : Mach1 Server Restart Required : false
MBean Changed           : com.bea:Name=basicWLSDomain,Type=Domain Operation Invoked       : add Attribute Modified      : Servers Attributes Old Value    : null Attributes New Value    : myserver Server Restart Required : false

startEdit

命令类别：编辑命令 用于 WLST：联机版

描述

代表当前已连接的用户启动配置编辑会话。在发出此命令之前，必须使用 edit 命令导航到编辑配置 MBean 层次。有关详细信息，请参阅 edit。

必须在调用任何命令前调用此命令，以对域配置进行修改。

在出现错误的情况下，此命令将返回 WLSTException。

语法

startEdit([waitTimeInMillis], [timeoutInMillis], [exclusive])

示例

以下示例可保存尚未保存到磁盘的编辑。

wls:/mydomain/edit> startEdit(60000, 120000) Starting an edit session ... Started edit session, please be sure to save and activate your changes once you are done. wls:/mydomain/edit !>

stopEdit

命令类别：编辑命令 用于 WLST：联机版

描述

停止当前编辑会话，解除编辑锁定，并放弃所有未保存的更改。

在出现错误的情况下，此命令将返回 WLSTException。

语法

stopEdit([defaultAnswer])

示例

以下示例可停止当前编辑会话。在取消前，WLST 将提示进行验证。

wls:/mydomain/edit !> stopEdit() Sure you would like to stop your edit session?(y/n) y Edit session has been stopped successfully. wls:/mydomain/edit>

unassign

命令类别：编辑命令 用于 WLST：脱机版

描述

从一个或多个目标中取消应用程序或资源的分配。

在出现错误的情况下，此命令将返回 WLSTException。

语法

unassign(sourceType, sourceName, destinationType, destinationName)

可使用下列准则设置 sourceType 和 destinationType：

示例

下列示例可执行下列操作：

wls:/offline/medrec> unassign("Server", "myServer,myServer2", "Cluster", "myCluster")

wls:/offline/mydomain> unassign("Server", "*", "Cluster", "myCluster")

wls:/offline/medrec> unassign("User", "newUser", "Group", "Monitors")

wls:/offline/mydomain> unassign("AppDeployment", "myAppDeployment", "Target", "newServer")

wls:/offline/mydomain> assign(‘AppDeployment.SubDeployment.SubDeployment‘, ‘MedRecEAR.MedRecAppScopedJMS.MedRecJMSServer‘, ‘Target‘,‘AdminServer‘)

unassignAll

命令类别：编辑命令 用于 WLST：脱机版

描述

从一个或多个目标中取消分配所有应用程序或服务。

在出现错误的情况下，此命令将返回 WLSTException。

语法

unassignAll(sourceType, destinationType, destinationName)

示例

下面的示例将从服务器 adminServer 和 cluster1 中取消分配所有的服务。

wls:/offline/medrec> unassignAll("Services", "Target", "adminServer,cluster1")

此时从指定的目标中取消分配下列服务（如果存在）：MigratableRMIService、Shutdownclass、Startupclass、FileT3、RMCFactory、MailSession、MessagingBridge、JMSConnectionFactory、JDBCConnectionPool、JDBCMultipool、JDBCTxDatasource、JDBCDataSource、JDBCPoolComp、JoltConnectionPool、WLECConnectionPool和 WTCServer。

undo

命令类别：编辑命令 用于 WLST：联机版

描述

恢复所有未保存的或未激活的编辑。

指定是否恢复所有未激活的编辑（包括已保存到磁盘的编辑）或自上次 save 操作以来的所有编辑。此命令不会释放编辑会话。

在出现错误的情况下，此命令将返回 WLSTException。

语法

undo([unactivateChanges], [defaultAnswer])

示例

下面的示例将恢复自上次 save 操作以来进行的所有更改。WLST 提示您在恢复之前进行验证。

wls:/mydomain/edit !> undo() Sure you would like to undo your changes?(y/n) y Discarded your in-memory changes successfully. wls:/mydomain/edit>

下面的示例恢复所有未激活的更改。WLST 提示您在恢复之前进行验证。

wls:/mydomain/edit !> undo(‘true‘) Sure you would like to undo your changes?(y/n) y Discarded all your changes successfully. wls:/mydomain/edit>

validate

命令类别：编辑命令 用于 WLST：联机版

描述

验证已完成但尚未保存的更改。通过此命令，可以在保存所有更改之前验证它们的有效性。

在出现错误的情况下，此命令将返回 WLSTException。

语法

validate()

示例

下面的示例将验证所有已完成但尚未保存的更改。

wls:/mydomain/edit !> validate() Validating changes ... Validated the changes successfully

信息命令

使用表 A-7 中列出的 WLST 信息命令以询问域、服务器和变量，并提供配置 Bean、运行时 Bean 和 WLST 相关信息。

addListener

命令类别：信息命令 用于 WLST：联机版

描述

将 JMX 监听器添加到指定的 MBean。对 MBean 进行的所有更改都将报告到标准输出中和/或保存到指定的配置文件中。

在出现错误的情况下，此命令将返回 WLSTException。

语法

addListener(mbean, [attributeNames], [logFile], [listenerName])

示例

下面的示例在 cmo MBean 上为 Notes 和 ArchiveConfigurationCount 特性定义 JMX 监听器。此监听器名为 domain-listener 且存储在 ./listeners/domain.log 中。

wls:/mydomain/serverConfig> addListener(cmo, "Notes,ArchiveConfigurationCount","./listeners/domain.log","domain-listener") 

configToScript

命令类别：信息命令 用于 WLST：联机版或脱机版

将现有的服务器配置（config 目录）转换为可执行的 WLST 脚本。可使用生成的脚本在其他服务器上重新创建资源。

configToScript 命令创建下列文件：

运行生成的脚本时：

在出现错误的情况下，此命令将返回 WLSTException。

语法

configToScript([configPath], [pyPath], [overwrite], [propertiesFile], [createDeploymentScript])

示例

下面的示例将配置转换为 WLST 脚本 config.py。默认情况下，从 ./config 加载配置文件，脚本文件保存到 .config/config.py，属性文件保存到 .config/config.py.properties。

wls:/offline> configToScript() configToScript is loading configuration from c:\bea\user_projects\domains\wls\config\config.xml ... Completed configuration load, now converting resources to wlst script... configToScript completed successfully The WLST script is written to c:\bea\user_projects\domains\wls\config\config.py and the properties file associated with this script is written to c:\bea\user_projects\domains\wls\config\config.py.properties wls:/offline>

下面的示例将文件 c:\bea\user_projects\domains\mydomain\config 目录中配置的服务器资源转换为 WLST 脚本 c:\bea\myscripts\config.py。

wls:/offline> configToScript(‘c:/bea/user_projects/domains/mydomain‘, ‘c:/bea/myscripts‘) configToScript is loading configuration from c:\bea\user_projects\domains\mydomain\config\config.xml ... Completed configuration load, now converting resources to wlst script... configToScript completed successfully The WLST script is written to c:\bea\myscripts\config.py and the properties file associated with this script is written to c:\bea\mydomain\config.py.properties wls:/offline>

dumpStack

命令类别：信息命令 用于 WLST：联机版或脱机版

描述

显示执行 WLST 操作时最后一次出现异常的堆栈跟踪，并重置此堆栈跟踪。

如果重置成功，则 dumpstack 命令将返回 Throwable 对象。在出现错误的情况下，此命令将返回 WLSTException。

语法

dumpStack()

示例

此示例显示堆栈跟踪。

wls:/myserver/serverConfig> dumpStack() com.bea.plateng.domain.script.jython.WLSTException: java.lang.reflect.Invocation TargetException ...

dumpVariables

命令类别：信息命令 用于 WLST：联机版或脱机版

描述

显示 WLST 使用的所有变量，包括它们的名称和值。在出现错误的情况下，此命令将返回 WLSTException。

语法

dumpVariables()

示例

此示例将显示所有当前变量及其值。

wls:/mydomain/serverConfig> dumpVariables() adminHome   weblogic.rmi.internal.BasicRemoteRef - hostID:     ‘-1 108080150904263937S:localhost:[7001,8001,-1,-1,-1,-1,-1]:    mydomain:AdminServer‘, oid: ‘259‘, channel: ‘null‘ cmgr   [MBeanServerInvocationHandler]com.bea:Name=ConfigurationManager,    Type=weblogic.management.mbeanservers.edit.ConfigurationManagerMBean

cmo   [MBeanServerInvocationHandler]com.bea:Name=mydomain,Type=Domain connected true domainName mydomain ... wls:/mydomain/serverConfig>

find

命令类别：信息命令 用于 WLST：联机版

描述

在当前层次中查找 MBean 和特性。

WLST 将返回用来存储特性和/或特性类型及特性值的 MBean 的路径名。如果将 searchInstancesOnly 设置为 false，则此命令也会搜索未在服务器中实例化但可以创建的 MBeanType 路径。在出现错误的情况下，此命令将返回 WLSTException。

语法

find([name], [type], [searchInstancesOnly])

示例

下面的示例在当前配置层次中搜索名为 javaCompiler 的特性。

wls:/mydomain/serverConfig> find(name = ‘JavaCompiler‘) Finding ‘JavaCompiler‘ in all registered MBean instances ... /Servers/AdminServer                         JavaCompilerPreClassPath      null /Servers/AdminServer                       JavaCompiler                  java /Servers/AdminServer                      JavaCompilerPostClassPath   null wls:/mydomain/serverConfig>

下面的示例在当前配置层次中搜索类型为 JMSRuntime 的特性。

wls:/mydomain/serverRuntime> find(type=‘JMSRuntime‘) Finding MBean of type ‘JMSRuntime‘ in all the instances ... /JMSRuntime/AdminServer.jms wls:/mydomain/serverRuntime>

下面的示例在当前配置层次中搜索名为 execute 的特性。searchInstancesOnly 参数设置为 false，表示同时搜索未在服务器中实例化的 MBeanType。

wls:/mydomain/serverConfig> find(name=‘execute‘, searchInstancesOnly=‘false‘) Finding ‘execute‘ in all registered MBean instances ... /Servers/AdminServer 				ExecuteQueues [Ljavax.management.ObjectName;@1aa7dbc /Servers/AdminSever 				Use81StyleExecuteQueues                            false

Now finding ‘execute‘ in all MBean Types that can be instantiated ... /Servers                                      ExecuteQueues /Servers                                      Use81StyleExecuteQueues wls:/mydomain/serverConfig>

getConfigManager

命令类别：编辑命令 用于 WLST：联机版

描述

返回可管理更改过程的最新 ConfigurationManager MBean。然后您可以调用方法以便管理域中的配置更改。在出现错误的情况下，此命令将返回 WLSTException。

语法

getConfigManager()

示例

下面的示例返回最新的 ConfigurationManagerBean MBean 并将其存储到任务变量中。

wls:/mydomain/serverConfig> cm=getConfigManager() wls:/mydomain/serverConfig> cm=getType() ‘weblogic.management.mbeanservers.edit.ConfigurationManagerMBean‘

getMBean

命令类别：信息命令 用于 WLST：联机版

描述

通过浏览至指定路径返回 MBean。在出现错误的情况下，此命令将返回 WLSTException。

语法

getMBean(mbeanPath)

示例

下面的示例返回指定路径的 MBean。

wls:/mydomain/edit !> com=getMBean(‘Servers/myserver/COM/myserver‘) wls:/mydomain/edit !> com.getType() `Server‘

getMBI

命令类别：信息命令 用于 WLST：联机版

描述

返回指定的 MBeanType 或 cmo 变量的 MBeanInfo。在出现错误的情况下，此命令将返回 WLSTException。

语法

getMBI([mbeanType])

示例

下面的示例获取指定 MBeanType 的 MBeanInfo，并将其存储在变量 svrMbi 中。

wls:/mydomain/serverConfig> svrMbi=getMBI(‘weblogic.management.configuration.ServerMBean‘)

getPath

命令类别：信息命令 用于 WLST：联机版

描述

返回当前树中 MBean 的指定 MBean 实例或 ObjectName 的 MBean 路径。在出现错误的情况下，此命令将返回 WLSTException。

语法

getPath(mbean)

示例

下面的示例返回指定路径的 MBean。

wls:/mydomain/edit !> path=getPath(‘com.bea:Name=myserver,Type=Server‘) wls:/mydomain/edit !> print path ‘Servers/myserver‘

listChildTypes

命令类别：信息命令 用于 WLST：联机版

描述

列出所有可创建或删除的 cmo 的子 MBean。cmo 变量可指定您使用 WLST 上一次导航到的配置 Bean 实例。有关 cmo 变量的详细信息，请参阅更改当前管理对象。

在出现错误的情况下，此命令将返回 WLSTException。

语法

listChildTypes([parent])

示例

下面的示例将列出可以创建或删除的 cmo 类型的子 MBean。

wls:/mydomain/serverConfig> listChildTypes() AppDeployments BridgeDestinations CachingRealms Clusters ... wls:/mydomain/serverConfig>

lookup

命令类别：信息命令 用于 WLST：联机版

描述

查找指定的 MBean。此 MBean 必须是当前 MBean 的子 MBean。在出现错误的情况下，此命令将返回 WLSTException。

语法

lookup(name, [childMBeanType])

示例

下面的示例查找指定的服务器 myserver，并将返回的存根控件存储在 sbean 变量中。

wls:/mydomain/serverConfig> sbean=lookup(‘myserver‘,‘Server‘) wls:/mydomain/serverConfig> sbean.getType() `Server‘ wls:/mydomain/serverConfig> 

ls

命令类别：信息命令 用于 WLST：联机版或脱机版

描述

列出指定管理对象的特性、操作和子管理对象。

在出现错误的情况下，此命令将返回 WLSTException。

默认情况下，输出以字符串形式返回，并且分为三列：

默认情况下，输出会列出当前管理对象的所有特性、操作和子管理对象。要筛选输出，或者查看不同管理对象的列表，可以指定命令参数。

当使用 WLST 脱机版时请注意下列事项：

语法

ls( [ a | c | o ] [ moPath ])

ls( [ moPath ] returnMap [ returnType ] )

示例

下面的示例在 WLST 脱机版模式下显示 examples 域（已加载到内存）的所有子配置 Bean 和特性名称及特性值：

wls:/offline/mydomain > ls() dr--   AppDeployments dr--   BridgeDestinations dr--   Clusters dr--   CustomResources dr--   DeploymentConfiguration dr--   Deployments dr--   EmbeddedLDAP dr--   ErrorHandlings dr--   FileStores dr--   InternalAppDeployments dr--   InternalLibraries dr--   JDBCDataSourceFactories dr--   JDBCStores dr--   JDBCSystemResources dr--   JMSBridgeDestinations dr--   JMSInteropModules dr--   JMSServers dr--   JMSSystemResources dr--   JMX ... wls:/offline/examples>

下面的示例显示 DomainMBean 中的所有特性名称和特性值：

wls:/mydomain/serverConfig> ls(‘a‘) -r--   AdminServerName                              AdminServer -r--   AdministrationMBeanAuditingEnabled           false -r--   AdministrationPort                           9002 -r--   AdministrationPortEnabled                    false -r--   AdministrationProtocol                       t3s -r--   ArchiveConfigurationCount                    0 -r--   ClusterConstraintsEnabled                    false -r--   ConfigBackupEnabled                          false -r--   ConfigurationAuditType                       none -r--   ConfigurationVersion                         9.0.0.0 -r--   ConsoleContextPath                           console -r--   ConsoleEnabled                               true -r--   ConsoleExtensionDirectory                    console-ext -r--   DomainVersion                                9.0.0.0 -r--   LastModificationTime                         0 -r--   Name                                         basicWLSDomain -r--   Notes                                        null -r--   Parent                                       null -r--   ProductionModeEnabled                        false -r--   RootDirectory                                . -r--   Type                                         Domain wls:/mydomain/serverConfig>

下面的示例显示 Servers MBean 中的所有子 Bean、特性名称和特性值：

wls:/mydomain/serverConfig> ls(‘Servers‘) dr--   AdminServer

下面的示例显示指定 MBean 路径的特性名称和特性值，并以表的形式返回信息：

wls:/mydomain/serverConfig> svrAttrList = ls(‘edit:/Servers/myserver‘, ‘true‘, ‘a‘) -rw-   AcceptBacklog                                50 -rw-   AdminReconnectIntervalSeconds                10 -rw-   AdministrationPort                           9002 -rw-   AdministrationProtocol                       t3s -rw-   AutoKillIfFailed                             false -rw-   AutoMigrationEnabled                         false -rw-   AutoRestart                                  true -rw-   COMEnabled                                   false -rw-   ClasspathServletDisabled                     false -rw-   ClientCertProxyEnabled                       false -rw-   Cluster                                      null -rw-   ClusterRuntime                               null -rw-   ClusterWeight                                100 wls:/mydomain/serverConfig>

man

命令类别：信息命令 用于 WLST：联机版

描述

为当前 MBean 或其指定特性显示来自 MBeanInfo 的帮助。在出现错误的情况下，此命令将返回 WLSTException。

语法

man([attrName])

示例

下面的示例为 ServerMBean Bean 显示来自 MBeanInfo 的帮助。

wls:/mydomain/serverConfig> man(‘Servers‘) dynamic : true creator : createServer destroyer : destroyServer description : <p>Returns the ServerMBeans representing the servers that have been configured to be part of this domain.</p> descriptorType : Attribute Name : Servers interfaceClassName : [Lweblogic.management.configuration.ServerMBean; displayName : Servers relationship : containment

redirect

命令类别：信息命令 用于 WLST：联机版或脱机版

描述

将 WLST 信息、错误和调试消息重定向到指定的文件名。也可以将 dumpStack() 和 dumpVariables() 命令的输出重定向到指定的文件名。

在出现错误的情况下，此命令将返回 WLSTException。

语法

redirect(outputFile, [toStdOut])

示例

下面的示例开始将 WLST 输出重定向到 logs/wlst.log 文件：

wls:/mydomain/serverConfig> redirect(‘./logs/wlst.log‘)

removeListener

命令类别：信息命令 用于 WLST：联机版

描述

删除以前定义的监听器。如果不指定参数，则 WLST 将删除为所有 MBean 定义的所有监听器。有关设置监听器的详细信息，请参阅 addListener。

在出现错误的情况下，此命令将返回 WLSTException。

语法

removeListener([mbean], [listenerName])

示例

下面的示例删除名为 mylistener 的监听器。

wls:/mydomain/serverConfig> removeListener(listenerName="mylistener")

showListeners

命令类别：信息命令 用于 WLST：联机版

描述

显示当前定义的所有监听器。有关设置监听器的详细信息，请参阅 addListener。

在出现错误的情况下，此命令将返回 WLSTException。

语法

showListeners()

示例

下面的示例显示当前定义的所有监听器。

wls:/mydomain/serverConfig> showListeners()

startRecording

命令类别：信息命令 用于 WLST：联机版或脱机版

描述

记录所有用户与 WLST 的交互。此命令对于捕获用于重播的命令非常有用。

在出现错误的情况下，此命令将返回 WLSTException。

将 WLST 导入为 Jython 模块时，不能使用此命令，如将 WLST 导入为 Jython 模块中所述。

语法

startRecording(recordFile, [recordAll])

示例

下面的示例开始在 record.py 文件中记录 WLST 命令：

wls:/mydomain/serverConfig> startRecording(‘c:/myScripts/record.py‘) Starting recording to c:/myScripts/record.py wls:/mydomain/serverConfig>

state

命令类别：信息命令 用于 WLST：联机版

描述

使用节点管理器，返回服务器或群集及其状态的列表。节点管理器必须正在运行。

有关服务器状态的详细信息，请参阅“管理服务器启动和关闭”中的了解服务器生命周期。

在出现错误的情况下，此命令将返回 WLSTException。

语法

state(name, [type])

示例

下面的示例中返回受管服务器 managed1 的状态。

wls:/mydomain/serverConfig> state(‘managed1‘,‘Server‘) Current state of "managed1": SUSPENDED wls:/mydomain/serverConfig>

下面的示例将返回群集 mycluster 的状态。

wls:/mydomain/serverConfig> state(‘mycluster‘,‘Cluster‘) There are 3 server(s) in cluster: mycluster
States of the servers are MServer1---SHUTDOWN MServer2---SHUTDOWN MServer3---SHUTDOWN wls:/mydomain/serverConfig>

stopRecording

命令类别：信息命令 用于 WLST：联机版或脱机版

描述

停止记录 WLST 命令。有关启动记录的信息，请参阅 startRecording。

在出现错误的情况下，此命令将返回 WLSTException。

语法

stopRecording()

示例

下面的示例停止记录 WLST 命令。

wls:/mydomain/serverConfig> stopRecording() Stopping recording to c:\myScripts\record.py wls:/mydomain/serverConfig>

stopRedirect

命令类别：信息命令 用于 WLST：联机版或脱机版

描述

如果重定向正在进行中，则停止将 WLST 输出重定向到文件。

在出现错误的情况下，此命令将返回 WLSTException。

语法

stopRedirect()

示例

下面的示例停止将 WLST 输出重定向到文件：

wls:/mydomain/serverConfig> stopRedirect() WLST output will not be redirected to myfile.txt any more

storeUserConfig

命令类别：信息命令 用于 WLST：联机版

描述

创建用户配置文件和相关联的密钥文件。用户配置文件包含加密后的用户名和密码。密钥文件包含用于加密和解密用户名和密码的密钥。

只有用于最初加密用户名和密码的密钥文件才可用于解密这些值。如果丢失了密钥文件，则必须新建用户配置文件和密钥文件对。

在出现错误的情况下，此命令将返回 WLSTException。

语法

storeUserConfig([userConfigFile], [userKeyFile], [nm])

示例

下面的示例在默认位置创建和存储用户配置文件和密钥文件。

wls:/mydomain/serverConfig>  storeUserConfig() Creating the key file can reduce the security of your system if it is not kept in a secured location after it is created.Do you want to create the key file? y or n y The username and password that were used for this current WLS connection are stored in stored in C:\Documents and Settings\pat\pat-WebLogicConfig.properties and C:\Documents and Settings\pat\pat-WebLogicKey.properties.

下面的示例在指定位置创建和存储用户配置文件和密钥文件。

wls:/mydomain/serverConfig>  storeUserConfig(‘c:/myFiles/myuserconfigfile.secure‘, ‘c:/myFiles/myuserkeyfile.secure‘) Creating the key file can reduce the security of your system if it is not kept in a secured location after it is created.Do you want to create the key file? y or n y The username and password that were used for this current WLS connection are stored in c:/myFiles/mysuserconfigfile.secure and c:/myFiles/myuserkeyfile.secure wls:/mydomain/serverConfig>

threadDump

命令类别：信息命令 用于 WLST：联机版或脱机版

描述

显示指定服务器的线程转储。在出现错误的情况下，此命令将返回 WLSTException。

语法

threadDump([writeToFile], [fileName], [serverName])

示例

下面的示例显示当前服务器的线程转储并将输出保存到 Thread_Dump_serverName 文件。

wls:/mydomain/serverConfig> threadDump()

下面的示例显示服务器 managedServer 的线程转储。此信息不保存到文件。

wls:/mydomain/serverConfig> threadDump(writeToFile=‘false‘, serverName=‘managedServer‘)

viewMBean

命令类别：信息命令 用于 WLST：联机版

描述

显示有关 MBean 的信息，例如特性名称、特性值和操作。在出现错误的情况下，此命令将返回 WLSTException。

语法

viewMBean(mbean)

示例

下面的示例显示有关当前 MBean cmo 的信息。

wls:/mydomain/serverConfig> cmo.getType() `Domain‘ wls:/mydomain/serverConfig> viewMBean(cmo) Attribute Names and Values -------------------------- XMLEntityCaches   null Targets   javax.management.ObjectName[com.bea :Name=MedRecJMSServer,Type=JMSServer,    com.bea:Name=WSStoreForwardInternalJMSServerMedRecServer,Type=JMSServer,     com.bea:Name=MedRecWseeJMSServer,Type=JMSServer,    com.bea:Name=PhysWSEEJMSServer,Type=JMSServer,     com.bea:Name=MedRecSAFAgent,Type=SAFAgent,     com.bea:Name=AdminServer,Type=Server] RootDirectory                                . EmbeddedLDAP                                 com.bea:Name=OOTB_medrec,Type=EmbeddedLDAP RemoteSAFContexts  null Libraries   javax.management.ObjectName[com.bea ... wls:/mydomain/serverConfig>

writeIniFile

命令类别：编辑命令 用于 WLST：联机版

描述

将 WLST 定义和方法声明转换为 Python (.py) 文件，使高级用户能够将其作为 Jython 模块导入。导入之后，这些定义和方法声明可用于其他 Jython 模块，且可直接使用 Jython 语法来访问。有关详细信息，请参阅将 WLST 导入为 Jython 模块。

在出现错误的情况下，此命令将返回 WLSTException。

语法

writeIniFile(filePath)

示例

下面的示例将 WLST 转换为名为 wl.py 的 Python 文件。

wls:/offline> writeIniFile("wl.py") The Ini file is successfully written to wl.py wls:/offline> 

生命周期命令

使用在表 A-9 中列出的 WLST 生命周期命令管理服务器实例的生命周期。

有关服务器实例的生命周期的详细信息，请参阅“管理服务器启动和关闭”中的了解服务器生命周期。

migrate

命令类别：生命周期命令 用于 WLST：联机版

描述

将指定的服务（JTA、JMS 或服务器）迁移到群集内的目标服务器。在出现错误的情况下，此命令将返回 WLSTException。

有关迁移服务的信息，请参阅“使用 WebLogic Server 群集”中的服务级迁移。

语法

migrate(sname, destinationName, [sourceDown], [destinationDown], [migrationType])

示例

下面的示例将 server1 上的所有 JMS 和 JTA 服务迁移到服务器 server2。布尔参数指定源服务器已关闭而目标服务器正在运行。

wls:/mydomain/edit !> migrate(‘server1‘,‘server2‘, ‘true‘, ‘false‘, ‘all‘) Migrating all JMS and JTA services from ‘server1‘ to destination `server2‘ ... wls:/mydomain/edit !>

下面的示例将 server1 上的所有服务器服务迁移到服务器 server2。布尔参数指定源服务器已关闭而目标服务器正在运行。

wls:/mydomain/edit !> migrate(‘server1‘,‘server2‘, ‘true‘, ‘false‘, ‘Server‘) Migrating singleton server services from ‘server1‘ to machine ‘server2‘... wls:/mydomain/edit !>

resume

命令类别：生命周期命令 用于 WLST：联机版

描述

恢复处于挂起或 ADMIN 状态的服务器实例。此命令将服务器更改为 RUNNING 状态。有关服务器状态的详细信息，请参阅“管理服务器启动和关闭”中的了解服务器生命周期。

在出现错误的情况下，此命令将返回 WLSTException。

语法

resume([sname], [block])

示例

下面的示例恢复受管服务器实例。

wls:/mydomain/serverConfig> resume(‘managed1‘, block=‘true‘) Server ‘managed1‘ resumed successfully. wls:/mydomain/serverConfig>

shutdown

命令类别：生命周期命令 用于 WLST：联机版

描述

正常关闭正在运行的服务器实例或群集。shutdown 命令在关闭服务器或群集之前，会等待到所有进行中的工作都完成。

通过输入不带任何参数的 shutdown 命令，可以关闭 WLST 所连接的服务器。

当连接到受管服务器实例时，只能使用 shutdown 命令关闭 WLST 所连接的受管服务器实例，而不能在连接到受管服务器实例的情况下关闭其他服务器。

WLST 使用节点管理器关闭受管服务器。在关闭受管服务器时，节点管理器必须正在运行。

在出现错误的情况下，此命令将返回 WLSTException。

语法

shutdown([name], [entityType], [ignoreSessions], [timeOut], [force], [block])