下列部分將詳細描述 WLST 命令和變量。主題包括：
| 注意： | 有關命令語法要求，建議您查看 WLST 命令的語法。 |
使用表 A-2 中列出的 WLST 瀏覽命令，可以導航配置 Bean 或運行時 Bean 的層次，並控制提示顯示。
命令類別：瀏覽命令 用於 WLST：聯機版或脫機版
導航配置 Bean 或運行時 Bean 的層次。此命令使用一種類似於在 Windows 或 UNIX 命令外殼中導航文件系統的模型。例如，要導航回父配置 Bean 或運行時 Bean，請輸入 cd('..')。字符串..（點-點）是指當前目錄的上一級目錄。要在導航到深層 Bean 后返回根 Bean，請輸入 cd('/')。
cd 命令可返回配置或運行時 Bean 實例的存根控件（如果存根控件存在的話）。如果導航到一種類型，則此命令將從導航的對象返回配置 Bean 或運行時 Bean 實例的存根控件。在出現錯誤的情況下，此命令將返回WLSTException。
| 注意： | 第一次將 WLST 連接到服務器實例時，cmo 變量將被初始化為所有域配置 Bean 的根。在導航到實例之前，此變量可反映父配置 Bean 類型。有關 cmo 變量的詳細信息，請參閱更改當前管理對象。 |
以下示例可導航配置 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>
命令類別：瀏覽命令 用於 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>
命令類別：瀏覽命令 用於 WLST：聯機版或脫機版
如果輸入此命令時不帶參數，則可以根據提示切換路徑信息。若由於路徑長度而使得提示過長，此命令非常有用。
也可以將 on 或 off 明確指定為命令的參數。如果指定 off，WLST 將隱藏 WLST 提示並默認為 Jython 提示。默認情況下，WLST 提示可顯示配置或運行時導航路徑信息。
禁用提示詳細信息時，要確定層次中的當前位置，可以使用 pwd 命令，如 pwd 中所述。
在出現錯誤的情況下，此命令將返回 WLSTException。
|
|
wls:/mydomain/serverConfig/Servers/myserver> prompt() wls:/> prompt() wls:/mydomain/serverConfig/Servers/myserver>
以下示例可隱藏提示並默認為 Jython 提示（由於此命令是使用 WLST 聯機版運行的）、更改 Jython 提示，然后重新顯示 WLST 提示。此示例還說明了 pwd 命令的使用。
| 注意： | 有關使用 Jython 進行編程的詳細信息，請參閱 http://www.jython.org。 |
wls:/mydomain/serverConfig/Servers/myserver>prompt('off')>>>sys.ps1="myprompt>"myprompt>prompt()wls:>pwd()`serverConfig:Servers/myserver' wls:>prompt()wls:/mydomain/serverConfig/Servers/myserver>
命令類別：瀏覽命令 用於 WLST：聯機版或脫機版
在已使用 prompt 命令禁止在提示中顯示路徑信息時，此命令非常有用，如 prompt 中所述。
在出現錯誤的情況下，此命令將返回 WLSTException。
pwd()
wls:/mydomain/serverConfig/Servers/myserver/Log/myserver> pwd() 'serverConfig:/Servers/myserver/Log/myserver'
使用表 A-3 中列出的 WLST 控制命令，可執行下列任務：
表 A-3 列出了 WLST 配置的控制命令。
命令類別：控制命令 用於 WLST：脫機版
使用應用程序或服務擴展模板擴展當前域。使用 Template Builder 創建應用程序或服務擴展模板。請參閱使用 Domain Template Builder 創建模板。
在出現錯誤的情況下，此命令將返回 WLSTException。
以下示例可打開某個域，然后使用指定的擴展模板 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>
命令類別：控制命令 用於 WLST：脫機版
關閉當前域。域一旦關閉，就不能再對其進行編輯。在出現錯誤的情況下，此命令將返回 WLSTException。
closeDomain()
wls:/offline>readDomain('c:/bea/user_projects/domains/medrec')... wls:/offline/medrec>updateDomain()wls:/offline/medrec>closeDomain()wls:/offline>
命令類別：控制命令 用於 WLST：脫機版
關閉當前域模板。域模板一旦關閉，就不再可用。在出現錯誤的情況下，此命令將返回 WLSTException。
closeTemplate()
以下示例可打開現有的域模板，執行某些操作，然后關閉當前域模板。
wls:/offline>readTemplate('c:/bea/wlserver_10.0/common/templates/domains/ wls.jar')... wls:/offline/wls>closeTemplate()wls:/offline>
命令類別：控制命令 用於 WLST：聯機版或脫機版
將 WLST 連接到 WebLogic Server 實例。
需要您提供已在活動 WebLogic 安全領域中定義的用戶的憑據（用戶名和密碼）。一旦連接到 WebLogic Server 實例，安全策略的集合將確定允許您查看或修改的配置特性。（請參閱“WebLogic Server MBean Reference”中的 Default Security Policies for MBeans。）
storeUserConfig命令創建包含加密格式憑據的用戶配置文件以及 WebLogic Server 用來對憑據解除加密的密鑰文件。在后續 WLST 會話中（或 WLST 腳本中），提供用戶配置文件和密鑰文件的名稱，而不是在命令行上輸入憑據。如果以腳本模式使用 WLST，因為使用此選項可以防止將解除加密的用戶憑據存儲在腳本中，所以建議您使用此選項。boot.properties文件中存儲的憑據。默認情況下，當您創建管理服務器時，WebLogic Server 加密用戶用來創建服務器的憑據並將它們存儲在boot.properties文件中。
如果在未指定用戶名和密碼或者配置文件和密鑰文件的情況下運行 connect 命令，WLST 將嘗試使用以下列出的（按優先順序排列）方法之一處理命令：
adminServerName參數，則在./boot.properties或./servers/myserver/security/boot.properties中查找boot.properties文件。adminServerName參數，則在./servers/adminServerName/security/boot.properties中查找boot.properties文件，其中adminServerName是adminServerName參數的值。
storeUserConfig
命令將使用密鑰文件對用戶名和密碼進行加密。只有對用戶配置文件進行加密的密鑰文件才可以解密用戶名和密碼。（請參閱 storeUserConfig。）
|
|
|
|
|
以下示例可將 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>
命令類別：控制命令 用於 WLST：脫機版
| 注意： | 如果希望在創建域時修改域配置設置，請參閱編輯域（脫機）中的選項 2。 |
| 注意： | createDomain 命令在功能上與 unpack 命令類似，如使用 pack 和 unpack 命令創建模板和域中所述。 |
在出現錯誤的情況下，此命令將返回 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')
命令類別：控制命令 用於 WLST：聯機版
斷開 WLST 與 WebLogic Server 實例的連接。disconnect 命令不會導致 WLST 退出交互式腳本外殼；它會在保持交互式外殼活動的同時關閉當前 WebLogic Server 實例連接，並重置所有變量。
在出現錯誤的情況下，此命令將返回 WLSTException。
可以使用 connect 命令連接到另一個 WebLogic Server 實例，如 connect 中所述。
wls:/mydomain/serverConfig> disconnect() Disconnected from weblogic server: myserver wls:/offline>
命令類別：控制命令 用於 WLST：聯機版或脫機版
如果有正在進行中的編輯會話，WLST 將提示您進行確認。要跳過提示，請將 defaultAnswer 參數設置為 y。
默認情況下，退出 WLST 時，WLST 將為當前 WLST JVM 調用 System.exit(0)。如果要 JVM 使用其他退出代碼退出，可通過使用 exitCode 參數指定值。
| 注意： | 如果在 Ant 腳本內發出 WLST 退出命令，可能還會退出 Ant 腳本的執行。建議在 Ant 腳本內調用 WLST 時，通過指定 fork="true" 分出新的 JVM。 |
在出現錯誤的情況下，此命令將返回 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:\>
命令類別：控制命令 用於 WLST：脫機版
使用 WLST 脫機版，可對在域 config 目錄或域模板 JAR（由 Template Builder 創建）中持久存儲的配置數據進行讀取和寫入訪問。此數據是 XML 文檔的集合，表示管理對象的層次。
打開模板或域時，系統將 WLST 放置到該域配置層次的根位置，並更新提示以反映配置層次中的當前位置。例如：
有關詳細信息，請參閱導航和詢問 MBean。
在出現錯誤的情況下，此命令將返回 WLSTException。
wls:/offline> readDomain('c:/bea/user_projects/domains/medrec') wls:/offline/medrec>
命令類別：控制命令 用於 WLST：脫機版
如果打開某個域模板，會將 WLST 放入此域模板的配置 Bean 層次中，並且更新提示以反映配置層次中的當前位置。例如：
WebLogic Server 配置 Bean 存在於層次結構之中。在 WLST 文件系統中，層次相當於驅動程序；類型和示例相當於目錄；特性和操作相當於文件。WLST 使用命令（如 cd、ls 和 pwd）遍歷配置 Bean 的層次結構，其方式類似於在 UNIX 或 Windows 命令外殼中導航文件系統。導航到配置 Bean 實例之后，您可使用 WLST 命令與 Bean 交互。有關詳細信息，請參閱導航和詢問 MBean。
| 注意： | 通過使用 WLST 和域模板，在新建域時僅能夠創建和訪問安全信息。更新域時，不能通過 WLST 訪問安全信息。 |
在出現錯誤的情況下，此命令將返回 WLSTException。
readTemplate(templateFileName)
wls:/offline> readTemplate('c:/bea/wlserver_10.0/common/templates/domains /wls_medrec.jar') wls:/offline/wls_medrec>
命令類別：控制命令 用於 WLST：脫機版
更新並保存當前域。更新並保存某個域后，可繼續對此域進行編輯。
在出現錯誤的情況下，此命令將返回 WLSTException。
以下示例可打開 medrec 域、執行某些操作，並更新和保存當前域：
wls:/offline>readDomain('c:/bea/user_projects/domains/medrec')... wls:/offline/medrec>updateDomain()
命令類別：控制命令 用於 WLST：脫機版
將域寫入文件系統后，可以繼續更新內存中的域模板對象，並重新發出 writeDomain 命令，以將域配置存儲到新的或現有文件中。
默認情況下，寫入域時會將相關聯的應用程序寫入 BEAHOME/user_projects/applications/domainname，其中 BEAHOME 用於指定 BEA 主目錄，domainname 用於指定域的名稱。此目錄必須為空，否則 WLST 將顯示錯誤。
完成對內存中的域模板對象的使用后，請使用 closeTemplate 命令將其關閉。如果要對已保存到磁盤中的某個域進行編輯，可通過使用 readDomain 命令打開此域。
| 注意： | 域的名稱是從域目錄的名稱中派生出來的。例如，對於保存到 c:/bea/user_projects/domains/myMedrec 的域，域名為 myMedrec。 |
在寫入域之前，必須定義默認用戶的密碼（如果尚未定義的話）。例如：
cd('/Security/base_domain/User/weblogic') cmo.setPassword('weblogic')
在出現錯誤的情況下，此命令將返回 WLSTException。
以下示例可讀取 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')
命令類別：控制命令 用於 WLST：脫機版
將域配置信息寫入指定的域模板。可以使用域配置模板重新創建域。
將配置信息寫入域配置模板后，可以繼續更新內存中的域或域模板對象，並重新發出 writeDomain 或 writeTemplate 命令，以將域配置存儲到新的或現有的域或域模板文件中。有關詳細信息，請分別參閱 writeDomain 或writeTemplate。
在出現錯誤的情況下，此命令將返回 WLSTException。
| 注意： | writeTemplate 命令在功能上與 pack 命令類似，如使用 pack 和 unpack 命令創建模板和域中所述。但是，writeTemplate 不支持創建受管服務器模板。 |
以下示例可將當前域配置寫入名為 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。
命令類別：部署命令 用於 WLST：聯機版
deploy 命令可返回 WLSTProgress 對象，可以訪問此對象以檢查命令的狀態。有關 WLSTProgress 對象的詳細信息，請參閱 WLSTProgress 對象。在出現錯誤的情況下，此命令將返回 WLSTException。
| 注意： | 如果有正在進行中的編輯會話，deploy 命令將不會阻塞用戶交互。 |
deploy(appName, path, [targets], [stageMode], [planPath], [options])
stage、nostage 和 external_stage。有關臨時模式的信息，請參閱“將應用程序部署到 WebLogic Server”中的使用臨時模式控制部署文件復制。此參數默認為 null。
|
|
|
|
|
|
以下示例可對位於 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”中的在生產環境中更新應用程序。
命令類別：部署命令 用於 WLST：聯機版
將部署捆綁復制到指定目標。部署捆綁包括模塊、配置數據和任何其他生成的代碼。distributeApplication 命令不會啟動部署。
distributeApplication 命令可返回 WLSTProgress 對象，可以訪問此對象以檢查命令的狀態。有關 WLSTProgress 對象的詳細信息，請參閱 WLSTProgress 對象。在出現錯誤的情況下，此命令將返回WLSTException。
distributeApplication(appPath, [planPath], [targets], [options])
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 對象。
命令類別：部署命令 用於 WLST：聯機版
返回 WebLogic DeploymentManager 對象。可以使用對象方法配置和部署應用程序。WLST 必須連接到管理服務器才能運行此命令。在出現錯誤的情況下，此命令將返回 WLSTException。
getWLDM()
以下示例可獲取 WebLogicDeploymentManager 對象，並將此對象存儲到 wldm 變量中。
wls:/mydomain/serverConfig> wldm=getWLDM() wls:/mydomain/serverConfig> wldm.isConnected() 1 wls:/mydomain/serverConfig>
命令類別：部署命令 用於 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 對象。
命令類別：部署命令 用於 WLST：聯機版
redeploy 命令可返回 WLSTProgress 對象，可以訪問此對象以檢查命令的狀態。有關 WLSTProgress 對象的詳細信息，請參閱 WLSTProgress 對象。
在出現錯誤的情況下，此命令將返回 WLSTException。
有關重新部署應用程序的詳細信息，請參閱“將應用程序部署到 WebLogic Server”中的常見部署場景概述。
redeploy(appName, [planPath], [options])
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 對象。
命令類別：部署命令 用於 WLST：聯機版
啟動應用程序，以供用戶使用。應用程序必須完整配置且在域中可用。
startApplication 命令可返回 WLSTProgress 對象，可以訪問此對象以檢查命令的狀態。有關 WLSTProgress 對象的詳細信息，請參閱 WLSTProgress 對象。在出現錯誤的情況下，此命令將返回 WLSTException。
startApplication(appName, [options])
options 參數描述。
|
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 對象。
命令類別：部署命令 用於 WLST：聯機版
停止應用程序，使其對用戶不可用。應用程序必須完整配置且在域中可用。
stopApplication 命令可返回 WLSTProgress 對象，可以訪問此對象以檢查命令的狀態。有關 WLSTProgress 對象的詳細信息，請參閱 WLSTProgress 對象。
在出現錯誤的情況下，此命令將返回 WLSTException。
stopApplication(appName, [options])
options 參數描述。
|
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 對象。
命令類別：部署命令 用於 WLST：聯機版
undeploy 命令可返回 WLSTProgress 對象，可以訪問此對象以檢查命令的狀態。有關 WLSTProgress 對象的詳細信息，請參閱 WLSTProgress 對象。在出現錯誤的情況下，此命令將返回 WLSTException。
有關部署和取消部署應用程序的詳細信息，請參閱“將應用程序部署到 WebLogic Server”中的常見部署場景概述。
undeploy(appName,[targets],[options])
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>
命令類別：部署命令 用於 WLST：聯機版
通過使用新的部署計划更新應用程序配置。應用程序必須完整配置且在域中可用。
updateApplication 命令可返回 WLSTProgress 對象，可以訪問此對象以檢查命令的狀態。有關 WLSTProgress 對象的詳細信息，請參閱 WLSTProgress 對象。在出現錯誤的情況下，此命令將返回 WLSTException。
updateApplication(appName, [planPath], [options])
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 診斷框架。
命令類別：診斷命令 用於 WLST：脫機版
有關 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>
命令類別：診斷命令 用於 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。
| 注意： | 要編輯配置 Bean，必須連接到管理服務器，並且必須導航到編輯樹並啟動編輯會話，分別如 edit 和 startEdit 中所述。 |
| 注意： | 如果連接到受管服務器，則 WLST 的功能只限於瀏覽配置 Bean 層次。無法使用 WLST 更改受管服務器上的 MBean 的值時，可以使用管理 API 進行更改。BEA Systems 建議僅更改管理服務器上的配置 MBean 的值。更改受管服務器上 MBean 的值會導致域的配置不一致。 |
| 注意： | 有關編輯配置 Bean 的詳細信息，請參閱使用 WLST 聯機版更新現有域。 |
命令類別：編輯命令 用於 WLST：聯機版
激活在當前編輯會話期間已保存但尚未部署的更改。如果需要重新啟動服務器才能激活更改，此命令將打印一條消息。
activate 命令將返回最新的 ActivationTask MBean，此 MBean 可反映用戶當前所進行的或最近已進行的更改的狀態。然后可以調用方法以獲取有關正在進行的或剛完成的最新配置管理器激活任務的信息。在出現錯誤的情況下，此命令將返回 WLSTException。
false，表示不會阻止用戶交互。這種情況下，WLST 將在發出命令后將控制權返回給用戶，並將與當前任務相關聯的任務 MBean 賦給某個變量，可使用此變量檢查此 MBean 的狀態。如果要將 WLST 導入為 Jython 模塊（如將 WLST 導入為 Jython 模塊中所述），block 將始終設置為 true。
|
以下示例可激活在當前編輯會話期間所進行的、已保存到磁盤但尚未激活的更改。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>
命令類別：編輯命令 用於 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')
命令類別：編輯命令 用於 WLST：脫機版
| 注意： | 自 WebLogic Server 9.0 開始，不贊成使用此命令。應更新您的腳本，以使用 assign 命令，如 assign 中所述。此命令仍可以在指定 sourceType 的任何資源上執行。 |
| 注意： | 請注意，必須使用 assign 命令分配 JMS 服務器和 JMS 分布式目標，如 assign 中所述。 |
在出現錯誤的情況下，此命令將返回 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。
命令類別：編輯命令 用於 WLST：聯機版
發出此命令的用戶不一定必須是當前編輯者；這樣可允許管理員取消編輯會話（如有必要），以使其他用戶可以啟動編輯會話。
在出現錯誤的情況下，此命令將返回 WLSTException。
以下示例可取消當前編輯會話。在取消前，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>
命令類別：編輯命令 用於 WLST：聯機版或脫機版
create 命令可返回新建配置 Bean 的存根控件。在出現錯誤的情況下，此命令將返回 WLSTException。
| 注意： | 子類型必須在其父類型的實例之下創建。僅可以創建當前配置管理對象 (cmo) 類型子類型的配置 Bean。有關 cmo 變量的詳細信息，請參閱更改當前管理對象。 |
將 create 命令與 WLST 聯機版配合使用時，請注意以下事項：
create命令用於運行時 MBean，或 WLST 連接到受管服務器實例時不能使用此命令。edit命令導航到編輯配置 MBean 層次。請參閱 edit。
將 create 命令與 WLST 脫機版配合使用時，請注意以下事項：
create(name, childMBeanType, [baseProviderType])
config.xml 文件中定義的任何類型（除自定義安全類型之外）的實例。有關有效配置 Bean 的詳細信息，請參閱 WebLogic Server MBean Reference。
|
|
以下示例可為當前配置 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', '')
命令類別：編輯命令 用於 WLST：聯機版或脫機版
刪除當前配置 Bean 的指定類型的配置 Bean 的實例。
在出現錯誤的情況下，此命令將返回 WLSTException。
| 注意： | 僅可以刪除當前配置管理對象 (cmo) 類型的子類型的配置 Bean。有關 cmo 變量的詳細信息，請參閱更改當前管理對象。 |
config.xml 文件中所定義的任何類型的實例。有關有效配置 Bean 的詳細信息，請參閱 WebLogic Server MBean Reference。
|
以下示例可刪除名為 newServer、類型為 Server 的配置 Bean：
wls:/mydomain/edit !> delete('newServer','Server') Server with name 'newServer' has been deleted successfully. wls:/mydomain/edit !>
命令類別：編輯命令 用於 WLST：聯機版
對指定的字符串進行加密。然后可以在配置文件中使用加密的字符串，或將其用作命令的參數。
必須為要在其中使用加密字符串的每個域調用一次此命令。只能在最初加密字符串的域中使用相應的字符串。
在出現錯誤的情況下，此命令將返回 WLSTException。
以下示例通過使用指定域目錄中的 security/SerializedSystemIni.dat 文件對指定的字符串進行加密。
wls:/mydomain/serverConfig> es=encrypt('myPassword','c:/bea/domains/mydomain')
命令類別：編輯命令 用於 WLST：聯機版或脫機版
返回指定特性的值。有關可以查看的 MBean 特性的詳細信息，請參閱 WebLogic Server MBean Reference。在出現錯誤的情況下，此命令將返回 WLSTException。
| 注意： | 可通過輸入 ls('a') 列出所有特性及其當前值。有關詳細信息，請參閱 ls。 |
也可以使用 cmo 變量在當前配置 Bean 上執行任一 get 方法。例如：
有關 cmo 變量的詳細信息，請參閱更改當前管理對象。
以下示例可為當前配置 Bean 返回 AdministrationPort 的值。
wls:/mydomain/serverConfig> get('AdministrationPort') 9002
cmo.getAdministrationPort()
命令類別：編輯命令 用於 WLST：聯機版
返回用戶可以從中獲取狀態的最新 ActivationTask MBean。ActivationTask MBean 可反映用戶當前所進行或最近已進行的更改的狀態。然后可以調用方法以獲取有關正在進行的或剛完成的最新配置管理器激活任務的信息。在出現錯誤的情況下，此命令將返回 WLSTException。
getActivationTask()
以下示例可返回用戶可在其上獲取狀態的最新 ActivationTask MBean，並將其存儲到 task 變量中。
wls:/mydomain/serverConfig>task=getActivationTask()wls:/mydomain/serverConfig>task.getState()STATE_COMMITTED
命令類別：編輯命令 用於 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>
命令類別：編輯命令 用於 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 !>
命令類別：編輯命令 用於 WLST：脫機版
loadDB 命令可從模板文件中加載 SQL 文件。將域模板或者擴展模板加載到內存中后，方可發出此命令（請參閱 readDomain 和 readTemplate）。
要驗證相應的 SQL 文件是否存在，請打開域模板並查找相關的 SQL 文件列表 jdbc.index（位於 _jdbc_ 目錄下）。例如，對於 PointBase 版本 4.4，SQL 文件列表位於 _jdbc_\Pointbase\44\jdbc.index。
在出現錯誤的情況下，此命令將返回 WLSTException。
loadDB(dbVersion, datasourceName, dbCategory)
jdbc.index 文件和數據庫類別的詳細信息，請參閱“Domain Template 參考”（可從以下站點獲得：http://edocs.bea.com/common/docs100/tempref/tempref.html）中的“模板中通常包含的文件”
|
以下示例通過使用 p13nDataSource JDBC 數據源加載與專用於數據庫版本 5.1 的 Drop/Create P13N Database Objects 相關的 SQL 文件。
wls:/offline/mydomain> loadDB('5.1', 'p13nDataSource', 'Drop/Create P13N Database Objects')
命令類別：編輯命令 用於 WLST：聯機版 和 Offline
將 WLST 導入為 Jython 模塊時，不能使用此命令，如將 WLST 導入為 Jython 模塊中所述。
在出現錯誤的情況下，此命令將返回 WLSTException。
wls:/mydomain/serverConfig> loadProperties('c:/temp/myLoad.properties')
命令類別：編輯命令 用於 WLST：聯機版
保存已完成但尚未保存的編輯。此命令僅當正在編輯會話時有效。有關啟動編輯會話的信息，請參閱 startEdit。
在出現錯誤的情況下，此命令將返回 WLSTException。
save()
wls:/mydomain/edit !> save() Saving all your changes ... Saved all your changes successfully. wls:/mydomain/edit !>
命令類別：編輯命令 用於 WLST：聯機版或脫機版
在當前管理對象中設置指定特性的值。在使用 WLST 脫機版時，此命令將特性值寫入域的配置文件中。在使用 WLST 聯機版時，此命令可設置 MBean 特性的值。當您激活編輯時，會將聯機版更改寫入到域的配置文件中。
在出現錯誤的情況下，此命令將返回 WLSTException。
有關設置已加密的特性（所有已加密特性的名稱都以 Encrypted 結尾）的信息，請參閱寫入和讀取加密的配置值。
cmo變量：cmo.setattrName(value)
例如，可以使用 cmo.setListenPort(7011)，而不使用 set(`ListenPort', 7011)
有關 cmo 變量的詳細信息，請參閱更改當前管理對象。
以下示例可將 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))
命令類別：編輯命令 用於 WLST：脫機版
設置與創建域或更新域相關的選項。在出現錯誤的情況下，此命令將返回 WLSTException。
setOption(optionName, optionValue)
以下示例可將 CreateStartMenu 選項設置為 false：
wls:/offline> setOption('CreateStartMenu', 'false')
命令類別：編輯命令 用於 WLST：聯機版
顯示在當前編輯會話期間由當前用戶對配置所進行的更改。在出現錯誤的情況下，此命令將返回 WLSTException。
以下示例可顯示自啟動當前編輯會話之后，當前用戶對配置進行的所有更改。
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
命令類別：編輯命令 用於 WLST：聯機版
代表當前已連接的用戶啟動配置編輯會話。在發出此命令之前，必須使用 edit 命令導航到編輯配置 MBean 層次。有關詳細信息，請參閱 edit。
在出現錯誤的情況下，此命令將返回 WLSTException。
| 注意： | 如果 WLST 檢測到存在由同一用戶可能通過管理控制台或另一個 WLST 會話啟動的編輯會話已在進行中，WLST 將自動啟動編輯會話。 |
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 !>
命令類別：編輯命令 用於 WLST：聯機版
在出現錯誤的情況下，此命令將返回 WLSTException。
以下示例可停止當前編輯會話。在取消前，WLST 將提示進行驗證。
wls:/mydomain/edit !>stopEdit()Sure you would like to stop your edit session?(y/n)yEdit session has been stopped successfully. wls:/mydomain/edit>
命令類別：編輯命令 用於 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')
命令類別：編輯命令 用於 WLST：脫機版
| 注意： | 自 WebLogic Server 9.0 開始，不贊成使用此命令。應更新您的腳本，以使用 unassign 命令，如 unassign 中所述。此命令仍可以在指定 sourceType 的任何資源上執行。 |
在出現錯誤的情況下，此命令將返回 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。
命令類別：編輯命令 用於 WLST：聯機版
指定是否恢復所有未激活的編輯（包括已保存到磁盤的編輯）或自上次 save 操作以來的所有編輯。此命令不會釋放編輯會話。
在出現錯誤的情況下，此命令將返回 WLSTException。
undo([unactivateChanges], [defaultAnswer])
下面的示例將恢復自上次 save 操作以來進行的所有更改。WLST 提示您在恢復之前進行驗證。
wls:/mydomain/edit !>undo()Sure you would like to undo your changes?(y/n)yDiscarded your in-memory changes successfully. wls:/mydomain/edit>
下面的示例恢復所有未激活的更改。WLST 提示您在恢復之前進行驗證。
wls:/mydomain/edit !>undo('true')Sure you would like to undo your changes?(y/n)yDiscarded all your changes successfully. wls:/mydomain/edit>
命令類別：編輯命令 用於 WLST：聯機版
驗證已完成但尚未保存的更改。通過此命令，可以在保存所有更改之前驗證它們的有效性。
在出現錯誤的情況下，此命令將返回 WLSTException。
validate()
wls:/mydomain/edit !> validate() Validating changes ... Validated the changes successfully
使用表 A-7 中列出的 WLST 信息命令以詢問域、服務器和變量，並提供配置 Bean、運行時 Bean 和 WLST 相關信息。
命令類別：信息命令 用於 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")
命令類別：信息命令 用於 WLST：聯機版或脫機版
將現有的服務器配置（config 目錄）轉換為可執行的 WLST 腳本。可使用生成的腳本在其他服務器上重新創建資源。
在出現錯誤的情況下，此命令將返回 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>
命令類別：信息命令 用於 WLST：聯機版或脫機版
顯示執行 WLST 操作時最后一次出現異常的堆棧跟蹤，並重置此堆棧跟蹤。
如果重置成功，則 dumpstack 命令將返回 Throwable 對象。在出現錯誤的情況下，此命令將返回 WLSTException。
wls:/myserver/serverConfig> dumpStack() com.bea.plateng.domain.script.jython.WLSTException: java.lang.reflect.Invocation TargetException ...
命令類別：信息命令 用於 WLST：聯機版或脫機版
顯示 WLST 使用的所有變量，包括它們的名稱和值。在出現錯誤的情況下，此命令將返回 WLSTException。
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>
命令類別：信息命令 用於 WLST：聯機版
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>
命令類別：編輯命令 用於 WLST：聯機版
返回可管理更改過程的最新 ConfigurationManager MBean。然后您可以調用方法以便管理域中的配置更改。在出現錯誤的情況下，此命令將返回 WLSTException。
下面的示例返回最新的 ConfigurationManagerBean MBean 並將其存儲到任務變量中。
wls:/mydomain/serverConfig>cm=getConfigManager()wls:/mydomain/serverConfig>cm=getType()'weblogic.management.mbeanservers.edit.ConfigurationManagerMBean'
命令類別：信息命令 用於 WLST：聯機版
通過瀏覽至指定路徑返回 MBean。在出現錯誤的情況下，此命令將返回 WLSTException。
| 注意： | 如果未找到 MBean，則不會出現異常。 |
wls:/mydomain/edit !>com=getMBean('Servers/myserver/COM/myserver')wls:/mydomain/edit !>com.getType()`Server'
命令類別：信息命令 用於 WLST：聯機版
返回指定的 MBeanType 或 cmo 變量的 MBeanInfo。在出現錯誤的情況下，此命令將返回 WLSTException。
下面的示例獲取指定 MBeanType 的 MBeanInfo，並將其存儲在變量 svrMbi 中。
wls:/mydomain/serverConfig> svrMbi=getMBI('weblogic.management.configuration.ServerMBean')
命令類別：信息命令 用於 WLST：聯機版
返回當前樹中 MBean 的指定 MBean 實例或 ObjectName 的 MBean 路徑。在出現錯誤的情況下，此命令將返回 WLSTException。
wls:/mydomain/edit !>path=getPath('com.bea:Name=myserver,Type=Server')wls:/mydomain/edit !>print path'Servers/myserver'
命令類別：信息命令 用於 WLST：聯機版
列出所有可創建或刪除的 cmo 的子 MBean。cmo 變量可指定您使用 WLST 上一次導航到的配置 Bean 實例。有關 cmo 變量的詳細信息，請參閱更改當前管理對象。
在出現錯誤的情況下，此命令將返回 WLSTException。
下面的示例將列出可以創建或刪除的 cmo 類型的子 MBean。
wls:/mydomain/serverConfig> listChildTypes() AppDeployments BridgeDestinations CachingRealms Clusters ... wls:/mydomain/serverConfig>
命令類別：信息命令 用於 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>
命令類別：信息命令 用於 WLST：聯機版或脫機版
在出現錯誤的情況下，此命令將返回 WLSTException。
:parameterType(parameterName)
|
|
|
|
|
|
|
|
默認情況下，輸出會列出當前管理對象的所有特性、操作和子管理對象。要篩選輸出，或者查看不同管理對象的列表，可以指定命令參數。
如果要更改其管理對象不被 WLST 脫機版顯示的特性的默認值，必須首先使用 create 命令創建管理對象。然后，可使用 cd 命令轉到管理對象並更改特性值。請參閱 create。
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>
命令類別：信息命令 用於 WLST：聯機版
為當前 MBean 或其指定特性顯示來自 MBeanInfo 的幫助。在出現錯誤的情況下，此命令將返回 WLSTException。
下面的示例為 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
命令類別：信息命令 用於 WLST：聯機版或脫機版
將 WLST 信息、錯誤和調試消息重定向到指定的文件名。也可以將 dumpStack() 和 dumpVariables() 命令的輸出重定向到指定的文件名。
在出現錯誤的情況下，此命令將返回 WLSTException。
redirect(outputFile, [toStdOut])
下面的示例開始將 WLST 輸出重定向到 logs/wlst.log 文件：
wls:/mydomain/serverConfig> redirect('./logs/wlst.log')
命令類別：信息命令 用於 WLST：聯機版
刪除以前定義的監聽器。如果不指定參數，則 WLST 將刪除為所有 MBean 定義的所有監聽器。有關設置監聽器的詳細信息，請參閱 addListener。
在出現錯誤的情況下，此命令將返回 WLSTException。
removeListener([mbean], [listenerName])
wls:/mydomain/serverConfig> removeListener(listenerName="mylistener")
命令類別：信息命令 用於 WLST：聯機版
顯示當前定義的所有監聽器。有關設置監聽器的詳細信息，請參閱 addListener。
在出現錯誤的情況下，此命令將返回 WLSTException。
showListeners()
wls:/mydomain/serverConfig> showListeners()
命令類別：信息命令 用於 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>
命令類別：信息命令 用於 WLST：聯機版
使用節點管理器，返回服務器或群集及其狀態的列表。節點管理器必須正在運行。
有關服務器狀態的詳細信息，請參閱“管理服務器啟動和關閉”中的了解服務器生命周期。
在出現錯誤的情況下，此命令將返回 WLSTException。
wls:/mydomain/serverConfig> state('managed1','Server') Current state of "managed1": SUSPENDED wls:/mydomain/serverConfig>
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>
命令類別：信息命令 用於 WLST：聯機版或脫機版
停止記錄 WLST 命令。有關啟動記錄的信息，請參閱 startRecording。
在出現錯誤的情況下，此命令將返回 WLSTException。
wls:/mydomain/serverConfig> stopRecording() Stopping recording to c:\myScripts\record.py wls:/mydomain/serverConfig>
命令類別：信息命令 用於 WLST：聯機版或脫機版
如果重定向正在進行中，則停止將 WLST 輸出重定向到文件。
在出現錯誤的情況下，此命令將返回 WLSTException。
stopRedirect()
wls:/mydomain/serverConfig> stopRedirect() WLST output will not be redirected to myfile.txt any more
命令類別：信息命令 用於 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 nyThe 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 nyThe 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>
命令類別：信息命令 用於 WLST：聯機版或脫機版
顯示指定服務器的線程轉儲。在出現錯誤的情況下，此命令將返回 WLSTException。
threadDump([writeToFile], [fileName], [serverName])
下面的示例顯示當前服務器的線程轉儲並將輸出保存到 Thread_Dump_serverName 文件。
wls:/mydomain/serverConfig> threadDump()
下面的示例顯示服務器 managedServer 的線程轉儲。此信息不保存到文件。
wls:/mydomain/serverConfig> threadDump(writeToFile='false', serverName='managedServer')
命令類別：信息命令 用於 WLST：聯機版
顯示有關 MBean 的信息，例如特性名稱、特性值和操作。在出現錯誤的情況下，此命令將返回 WLSTException。
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>
命令類別：編輯命令 用於 WLST：聯機版
將 WLST 定義和方法聲明轉換為 Python (.py) 文件，使高級用戶能夠將其作為 Jython 模塊導入。導入之后，這些定義和方法聲明可用於其他 Jython 模塊，且可直接使用 Jython 語法來訪問。有關詳細信息，請參閱將 WLST 導入為 Jython 模塊。
在出現錯誤的情況下，此命令將返回 WLSTException。
下面的示例將 WLST 轉換為名為 wl.py 的 Python 文件。
wls:/offline>writeIniFile("wl.py")The Ini file is successfully written to wl.py wls:/offline>
使用在表 A-9 中列出的 WLST 生命周期命令管理服務器實例的生命周期。
有關服務器實例的生命周期的詳細信息，請參閱“管理服務器啟動和關閉”中的了解服務器生命周期。
命令類別：生命周期命令 用於 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 !>
命令類別：生命周期命令 用於 WLST：聯機版
恢復處於掛起或 ADMIN 狀態的服務器實例。此命令將服務器更改為 RUNNING 狀態。有關服務器狀態的詳細信息，請參閱“管理服務器啟動和關閉”中的了解服務器生命周期。
在出現錯誤的情況下，此命令將返回 WLSTException。
false，表示不會阻止用戶交互。在這種情況下，WLST 將在執行命令后把控制權返回給用戶，並將與當前任務相關聯的任務 MBean 分配到一個能夠用於檢查此參數狀態的變量。如果要將 WLST 導入為 Jython 模塊（如將 WLST 導入為 Jython 模塊中所述），block 將始終設置為 true。
|
wls:/mydomain/serverConfig> resume('managed1', block='true') Server 'managed1' resumed successfully. wls:/mydomain/serverConfig>
命令類別：生命周期命令 用於 WLST：聯機版
正常關閉正在運行的服務器實例或群集。shutdown 命令在關閉服務器或群集之前，會等待到所有進行中的工作都完成。
通過輸入不帶任何參數的 shutdown 命令，可以關閉 WLST 所連接的服務器。
當連接到受管服務器實例時，只能使用 shutdown 命令關閉 WLST 所連接的受管服務器實例，而不能在連接到受管服務器實例的情況下關閉其他服務器。
WLST 使用節點管理器關閉受管服務器。在關閉受管服務器時，節點管理器必須正在運行。
在出現錯誤的情況下，此命令將返回 WLSTException。
shutdown([name], [entityType], [ignoreSessions], [timeOut], [force], [block])
false，表示不會阻止用戶交互。在這種情況下，WLST 將在執行命令后把控制權返回給用戶，並將與當前任務相關聯的任務 MBean 分配到一個能夠用於檢查此參數狀態的變量。如果要將 WLST 導入為 Jython 模塊（如將 WLST 導入為 Jython 模塊中所述），block 將始終設置為 true。
|
wls:/mydomain/serverConfig> shutdown() Shutting down the admin server that you are currently connected to ....... Disconnected from weblogic server: AdminServer
下面的示例命令 WLST 在關閉 myserver 前為 HTTP 會話的結束或超時 (1000 ms) 等待 1000 秒：
wls:/mydomain/serverConfig> shutdown('myserver','Server','false',1000, block='false')
下面的示例命令 WLST 在連接到受管服務器實例時立即結束所有 HTTP 會話：
wls:/mydomain/serverConfig> shutdown('MServer1','Server','true',1200) Shutting down a managed server that you are connected to ... Disconnected from weblogic server: MServer1
wls:/mydomain/serverConfig>shutdown('mycluster','Cluster')Shutting down the cluster with name mycluster Shutdown of cluster mycluster has been issued, please refer to the logs to check if the cluster shutdown is successful. Use the state(<server-name>) or state(<cluster-name>,"Cluster") to check the status of the server or cluster 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>
命令類別：生命周期命令 用於 WLST：聯機版
使用節點管理器啟動受管服務器實例或群集。WLST 必須連接到管理服務器且節點管理器必須正在運行。
有關用於連接的 WLST 命令和使用節點管理器的詳細信息，請參閱節點管理器命令。
在出現錯誤的情況下，此命令將返回 WLSTException。
start(name, [type], [url], [block])
false，表示不會阻止用戶交互。在這種情況下，WLST 將在執行命令后把控制權返回給用戶，並將與當前任務相關聯的任務 MBean 分配到一個能夠用於檢查此參數狀態的變量。如果要將 WLST 導入為 Jython 模塊（如將 WLST 導入為 Jython 模塊中所述），block 將始終設置為 true。
|
下面的示例命令節點管理器啟動受管服務器實例；監聽地址為 localhost，監聽端口為 8801。因為將 block 設置為 false，所以 WLST 發出此命令后將返回對用戶的控制。
wls:/mydomain/serverConfig> start('myserver', 'Server', block='false') Starting server myserver ... Server with name myserver started successfully. wls:/mydomain/serverConfig>
下面的示例命令節點管理器啟動群集。因為 block 默認為 true，所以在啟動群集之前，WLST 會持續阻止用戶交互。
wls:/mydomain/serverConfig> start('mycluster', 'Cluster') Starting the following servers in Cluster, mycluster: MS1, MS2, MS3... ...................................................................... All servers in the cluster mycluster are started successfully. wls:/mydomain/serverConfig>
命令類別：生命周期命令 用於 WLST：聯機版或脫機版
啟動管理服務器。在出現錯誤的情況下，此命令將返回 WLSTException。
startServer([adminServerName], [domainName], [url], [username], [password], [domainDir], [block], [timeout], [serverLog], [systemProperties], [jvmArgs])
block 設置為 false 時，WLST 在發出命令后將返回對用戶的控制，並將與當前任務相關聯的任務 MBean 分配到一個變量，使用此變量可以檢查服務器的狀態。此參數默認為 true，表示阻止用戶交互。如果要將 WLST 導入為 Jython 模塊（如將 WLST 導入為 Jython 模塊中所述），block 將始終設置為 true。
|
|
下面的示例在 demoDomain 中啟動名為 demoServer 的管理服務器。
wls:/offline> startServer('demoServer','demoDomain','t3://localhost:8001', 'myweblogic','wlstdomain','c:/mydomains/wlst','false', 60000, jvmArgs='-XX:MaxPermSize=75m, -Xmx512m, -XX:+UseParallelGC') wls:/offline>
命令類別：生命周期命令 用於 WLST：聯機版
掛起正在運行的服務器。此命令將服務器從 RUNNING 狀態更改為 ADMIN 狀態。有關服務器狀態的詳細信息，請參閱“管理服務器啟動和關閉”中的了解服務器生命周期。
在出現錯誤的情況下，此命令將返回 WLSTException。
suspend([sname], [ignoreSessions], [timeOut], [force], [block])
false，表示不會阻止用戶交互。在這種情況下，WLST 將在執行命令后把控制權返回給用戶，並將與當前任務相關聯的任務 MBean 分配到一個能夠用於檢查此參數狀態的變量。如果要將 WLST 導入為 Jython 模塊（如將 WLST 導入為 Jython 模塊中所述），block 將始終設置為 true。
|
wls:/mydomain/serverConfig> suspend('managed1') Server 'managed1' suspended successfully. wls:/mydomain/serverConfig>
使用表 A-10 中列出的 WLST 節點管理器命令啟動、關閉、重新啟動和監視 WebLogic Server 實例。
有關節點管理器的詳細信息，請參閱“管理服務器啟動和關閉”中的使用節點管理器控制服務器。
命令類別：節點管理器命令 用於 WLST：聯機版或脫機版
確定 WLST 是否已連接到節點管理器。返回 true 或 false，並打印描述性消息。在執行此命令之前，節點管理器必須正在運行。
在出現錯誤的情況下，此命令將返回 WLSTException。
nm()
下面的示例 WLST 當前已連接到正在監視 mydomain 的節點管理器。
wls:/mydomain/serverConfig> nm() Currently connected to Node Manager that is monitoring the domain "mydomain" wls:/mydomain/serverConfig>
wls:/mydomain/serverConfig> nm() Not connected to any Node Manager wls:/mydomain/serverConfig>
命令類別：節點管理器命令 用於 WLST：聯機版或脫機版
將 WLST 連接到節點管理器以便建立會話。連接到節點管理器之后，可以通過 WLST 調用任何節點管理器命令。在執行此命令之前，節點管理器必須正在運行。
一旦連接后，WLST 將提示顯示如下內容，其中 domainName 表示正受到管理的域的名稱：wls:/nm/domainName>。如果轉為將 WLST 連接到 WebLogic Server 實例，則提示會更改為反映 WebLogic Server 實例。可使用 nm 命令確定 WLST 是否已連接到節點管理器，有關描述可參閱 nm。
在出現錯誤的情況下，此命令將返回 WLSTException。
nmConnect([username, password], [host], [port], [domainName], [domainDir] [nmType], [verbose])
nmConnect([userConfigFile, userKeyFile], [host], [port], [domainName], [domainDir] [nmType], [verbose])
|
|||
|
|||
storeUserConfig
命令將使用密鑰文件對用戶名和密碼進行加密。只有對用戶配置文件進行加密的密鑰文件才可以解密用戶名和密碼。（請參閱 storeUserConfig。）
|
|||
|
|
下面的示例使用默認的主機、端口號及 plain 節點管理器類型，將 WLST 連接到節點管理器以便監視 oamdomain 域。
wls:/myserver/serverConfig> nmConnect('weblogic', 'weblogic', 'localhost', '5555', 'oamdomain', 'c:/bea/user_projects/domains/oamdomain','plain') Connecting to Node Manager Server ... Successfully connected to Node Manager. wls:/nm/oamdomain>
下面的示例通過使用用戶配置文件和密鑰文件提供用戶憑據，將 WLST 連接到節點管理器服務器實例。
wls:/myserver/serverConfig>nmConnect(userConfigFile='c:/myfiles/myuserconfigfile.secure', userKeyFile='c:/myfiles/myuserkeyfile.secure', host='172.18.137.82', port=26106, domainName='mydomain', domainDir='c:/myfiles/mydomain', mType='plain')
Connecting to Node Manager Server ... Successfully connected to Node Manager. wls:/nm/mydomain>
命令類別：節點管理器命令 用於 WLST：聯機版或脫機版 要運行此命令必須將 WLST 連接到節點管理器。
在出現錯誤的情況下，此命令將返回 WLSTException。
nmDisconnect()
wls:/nm/oamdomain> nmDisconnect() Successfully disconnected from Node Manager wls:/myserver/serverConfig>
命令類別：節點管理器命令 用於 WLST：聯機版
注冊當前正在運行 WLST 的計算機。要運行此命令，WLST 必須連接到管理服務器；WLST 無需連接到節點管理器。
此命令還將更新 WL_HOME/common/nodemanager 目錄下 nodemanager.domains 文件中的域信息，其中 WL_HOME 指 WebLogic Server 的上一級安裝目錄。
您必須在每台計算機的每個域中運行該命令一次，但共享管理服務器根目錄的域除外。
如果運行此命令時，此計算機已注冊，則刷新節點管理器機密文件 (nm_password.properties) 以便獲得管理服務器的最新信息。
在出現錯誤的情況下，此命令將返回 WLSTException。
nmEnroll([domainDir], [nmHome])
下面的示例注冊連接到節點管理器的當前計算機，並將節點管理器機密文件 (nm_password properties) 和 SerializedSystemIni.dat 文件保存到c:/bea/mydomain/common/nodemanager/nm_password.properties。默認情況下，nodemanager.domains 文件將寫入 WL_HOME/common/nodemanager。
wls:/mydomain/serverConfig>nmEnroll('c:/bea/mydomain/common/nodemanager')Enrolling this machine with the domain directory atc:\bea\mydomain\common\nodemanager.... Successfully enrolled this machine with the domain directory at C:\bea\mydomain\common\nodemanager wls:/mydomain/serverConfig>
命令類別：節點管理器命令 用於 WLST：聯機版
為指定的服務器生成節點管理器屬性文件 boot.properties 和 startup.properties。節點管理器的屬性文件相對於指定服務器的根目錄存儲。目標根目錄所在的計算機必須與運行此命令的計算機是同一台計算機。
在出現錯誤的情況下，此命令將返回 WLSTException。
nmGenBootStartupProps(serverName)
下面的示例在指定服務器 ms1 的根目錄中生成 boot.properties 和 startup.properties。
wls:/mydomain/serverConfig> nmGenBootStartupProps('ms1') Successfully generated boot.properties at c:\bea\mydomain\servers\ms1\data\nodemanager\boot.properties Successfully generated startup.properties at c:\bea\mydomain\servers\ms1\data\nodemanager\startup.properties wls:/mydomain/serverConfig>
命令類別：節點管理器命令 用於 WLST：聯機版或脫機版 要運行此命令必須將 WLST 連接到節點管理器。
如果未使用 serverName 參數指定服務器名稱，則此參數默認為 myServer，它必須與您的服務器名稱相匹配，否則命令將失敗。
如果試圖取消不是使用節點管理器啟動的服務器實例，則命令將顯示出錯。
在出現錯誤的情況下，此命令將返回 WLSTException。
wls:/nm/oamdomain> nmKill('oamserver') Killing server `oamserver' ... Server oamServer killed successfully. wls:/nm/oamdomain>
命令類別：節點管理器命令 用於 WLST：聯機版或脫機版 要運行此命令必須將 WLST 連接到節點管理器。
在出現錯誤的情況下，此命令將返回 WLSTException。
wls:/nm/oamdomain> nmLog() Successfully retrieved the Node Manager log and written. wls:/nm/oamdomain>
命令類別：節點管理器命令 用於 WLST：聯機版或脫機版 要運行此命令必須將 WLST 連接到節點管理器。
在出現錯誤的情況下，此命令將返回 WLSTException。
nmServerLog([serverName], [writer])
下面的示例顯示服務器 oamserver 的輸出日志並將日志輸出寫入到 myWriter。
wls:/nm/oamdomain> nmServerLog('oamserver',myWriter) Successfully retrieved the server log and written. wls:/nm/oamdomain>
命令類別：節點管理器命令 用於 WLST：聯機版或脫機版 要運行此命令必須將 WLST 連接到節點管理器。
在出現錯誤的情況下，此命令將返回 WLSTException。
下面的示例顯示使用節點管理器啟動的名為 oamserver 的服務器的狀態。
wls:/nm/oamdomain> nmServerStatus('oamserver') RUNNING wls:/nm/oamdomain>
命令類別：節點管理器命令 用於 WLST：聯機版或脫機版 要運行此命令必須將 WLST 連接到節點管理器。
在出現錯誤的情況下，此命令將返回 WLSTException。
| 注意： | 為了使用 nmStart 啟動服務器，boot.properties 必須存在。如果這是您第一次啟動服務器，則必須進行手工創建以使用 nmStart。 |
nmStart([serverName], [domainDir], [props], [writer])
下面的示例使用節點管理器在當前域中啟動服務器 managed1。
wls:/nm/mydomain> nmStart("managed1") Starting server managed1 ... Server managed1 started successfully wls:/nm/mydomain>
下面的示例使用節點管理器在指定的域中啟動管理服務器。在此示例中，prps 變量存儲系統屬性設置，通過 props 參數可將此變量傳遞到命令中。
wls:/nm/mydomain> prps = makePropertiesObject("weblogic.ListenPort=8001") wls:/nm/mydomain> nmStart("AdminServer",props=prps) Starting server AdminServer... Server AdminServer started successfully wls:/nm/mydomain>
命令類別：節點管理器命令 用於 WLST：聯機版或脫機版 要運行此命令必須將 WLST 連接到節點管理器。
在出現錯誤的情況下，此命令將返回 WLSTException。
nmVersion()
wls:/nm/oamdomain> nmVersion() The Node Manager version that you are currently connected to is 9.0.0.0 wls:/nm/oamdomain>
命令類別：節點管理器命令 用於 WLST：聯機版或脫機版
| 注意： | WebLogic Server 自定義安裝過程可以有選擇的安裝節點管理器，並將其作為 Windows 系統中的 Windows 服務來啟動。有關詳細信息，請參閱“BEA 產品安裝指南”中的關於將節點管理器安裝為 Windows 服務。在這種情況下，不需要手工啟動節點管理器。 |
如果調用 startNodeManager 命令時，節點管理器已在運行，則會顯示下列消息：
A Node Manager has already been started. Cannot start another Node Manager process via WLST
在出現錯誤的情況下，此命令將返回 WLSTException。
startNodeManager([verbose], [nmProperties])
wls:/mydomain/serverConfig> startNodeManager(verbose='true', NodeManagerHome='c:/bea/wlserver_10.0/common/nodemanager', ListenPort='6666', ListenAddress='myhost')) Launching Node Manager ... Successfully launched the Node Manager. The Node Manager process is running independent of the WLST process Exiting WLST will not stop the Node Manager process. Please refer to the Node Manager logs for more information. The Node Manager logs will be under c:\bea\wlserver_10.0\common\nodemanager. wls:/mydomain/serverConfig>
使用表 A-11 中列出的 WLST 樹命令以便在 MBean 層次中導航。
|
||||
|
||||
命令類別：樹命令 用於 WLST：聯機版
| 注意： | 自 WebLogic Server 9.0 開始，不贊成使用此命令。應更新您的腳本，以使用 serverConfig 命令，如 serverConfig 中所述。 |
導航到配置 MBean 層次中您上一次導航到的 MBean，或導航到層次的根 DomainMBean。有關詳細信息，請參閱在 MBean 層次中導航。
在出現錯誤的情況下，此命令將返回 WLSTException。
config()
下面的示例說明如何在管理服務器實例上從運行時 MBean 層次導航到配置 MBean 層次：
wls:/mydomain/runtime> config() Location changed to config tree (deprecated).This is a writeable tree with DomainMBean as the root. For more help, use help('config') wls:/mydomain/config> ls() dr-- Applications dr-- BridgeDestinations dr-- Clusters dr-- DeploymentConfiguration dr-- Deployments dr-- DomainLogFilters dr-- EmbeddedLDAP dr-- JDBCConnectionPools dr-- JDBCDataSourceFactories dr-- JDBCDataSources dr-- JDBCMultiPools dr-- JDBCTxDataSources dr-- JMSBridgeDestinations dr-- JMSConnectionFactories dr-- JMSDestinationKeys dr-- JMSDestinations dr-- JMSDistributedQueueMembers dr-- JMSDistributedQueues dr-- JMSDistributedTopicMembers dr-- JMSDistributedTopics dr-- JMSFileStores dr-- JMSJDBCStores ... wls:/mydomain/config>
命令類別：樹命令 用於 WLST：聯機版
導航到在服務器中注冊的自定義 MBean 的根。WLST 可以對自定義 MBean 進行導航、詢問和編輯，正像它對域 MBean 操作的那樣；但是，因為存根控件不可用，所以自定義 MBean 不能使用 cmo 變量。
| 注意： | 當導航到 custom 樹時，WLST 會查詢兼容 MBean 服務器中的所有 MBean，如運行時 MBean 服務器，可能還有 JVM 平台 MBean 服務器，以便定位自定義 MBean。此過程會花費幾分鍾的時間，並且 WLST 可能不會立即返回提示，這些都取決於當前域中 WLST 的數目。 |
當 WLST 連接到管理服務器實例或受管服務器實例時，custom 命令可用。當連接到 WebLogic Integration 或 WebLogic Portal 服務器時，WLST 可以與所有的 WebLogic Integration 或 WebLogic Portal 服務器 MBean 進行交互。
有關自定義 MBean 的詳細信息，請參閱使用 JMX 開發自定義管理實用工具。
在出現錯誤的情況下，此命令將返回 WLSTException。
custom()
下面的示例針對管理服務器實例，從配置 MBean 層次導航到自定義 MBean 層次。
wls:/mydomain/serverConfig> custom() Location changed to custom tree.This is a writeable tree with No root.For more help, use help('custom') wls:/mydomain/custom>
命令類別：樹命令 用於 WLST：聯機版
導航到域配置層次中您上一次導航到的 MBean，或導航到層次的根 DomainMBean。此只讀層次可存儲代表當前域的配置 MBean。
在出現錯誤的情況下，此命令將返回 WLSTException。
domainConfig()
下面的示例在管理服務器實例上，從配置 MBean 層次導航到域配置層次。
wls:/mydomain/serverConfig>domainConfig()Location changed to domainConfig tree.This is a read-only tree with DomainMBean as the root. For more help, use help('domainConfig') wls:/mydomain/domainConfig>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 ... wls:/mydomain/domainConfig>
命令類別：樹命令 用於 WLST：聯機版
導航到域運行時層次中您上一次導航到的 MBean，或導航到層次的根 DomainRuntimeMBean。此只讀層次可存儲表示當前域的運行時 MBean。
在出現錯誤的情況下，此命令將返回 WLSTException。
domainRuntime()
下面的示例在管理服務器實例上，從配置 MBean 層次導航到域運行時層次。
wls:/mydomain/serverConfig>domainRuntime()wls:/mydomain/domainRuntime>ls()dr-- AppRuntimeStateRuntime dr-- DeployerRuntime dr-- DomainServices dr-- LogRuntime dr-- MessageDrivenControlEJBRuntime dr-- MigratableServiceCoordinatorRuntime dr-- MigrationDataRuntimes dr-- SNMPAgentRuntime dr-- ServerLifeCycleRuntimes dr-- ServerRuntimes dr-- ServerServices
-r-- ActivationTime Mon Aug 01 11:41:25 EDT 2005 -r-- Clusters null -r-- MigrationDataRuntimes null -r-- Name sampleMedRecDomain -rw- Parent null -r-- SNMPAgentRuntime null -r-- Type DomainRuntime -r-x restartSystemResource Void : WebLogicMBean(weblogic.management.configuration.SystemResourceMBean) wls:/mydomain/domainRuntime>
命令類別：樹命令 用於 WLST：聯機版
導航到編輯配置 MBean 層次中您上一次導航到的 MBean，或導航到層次的根 DomainMBean。此可寫層次可存儲表示當前域的所有配置 MBean。
| 注意： | 要編輯配置 Bean，必須連接到管理服務器。如果連接到受管服務器，則 WLST 的功能只限於瀏覽配置 Bean 層次。無法使用 WLST 更改受管服務器上的 MBean 的值時，可以使用管理 API 進行更改。BEA Systems 建議僅更改管理服務器上的配置 MBean 的值。更改受管服務器上 MBean 的值會導致域的配置不一致。 |
| 注意： | 有關編輯配置 Bean 的詳細信息，請參閱使用 WLST 聯機版更新現有域。 |
在出現錯誤的情況下，此命令將返回 WLSTException。
edit()
下面的示例說明如何在管理服務器實例上從服務器配置 MBean 層次導航到域配置 MBean 層次的可編輯的副本。
wls:/myserver/serverConfig>edit()Location changed to edit tree.This is a writeable tree with DomainMBean as the root. For more help, use help('edit') wls:/myserver/edit !>ls()dr-- AppDeployments dr-- BridgeDestinations dr-- Clusters dr-- DeploymentConfiguration dr-- Deployments dr-- EmbeddedLDAP ... wls:/myserver/edit !>
命令類別：樹命令 用於 WLST：聯機版
導航到 WLST 當前所連接的服務器的 JNDI 樹。此只讀樹保留所有當前綁定在 JNDI 中的元素。
在出現錯誤的情況下，此命令將返回 WLSTException。
jndi()
下面的示例在管理服務器實例上，從運行時 MBean 層次導航到域 JNDI 樹。
wls:/myserver/runtime> jndi() Location changed to jndi tree.This is a read-only tree with No root.For more help, use help('jndi') wls:/myserver/jndi> ls() dr-- ejb dr-- javax dr-- jms dr-- weblogic ...
命令類別：樹命令 用於 WLST：聯機版
| 注意： | 自 WebLogic Server 9.0 開始，不贊成使用此命令。應更新您的腳本，以使用 serverRuntime 命令，如 serverRuntime 中所述。 |
導航到運行時層次中您上一次導航到的 MBean，或導航到所有運行時對象的根 DomainRuntimeMBean。當連接到受管服務器實例時，運行時 MBean 的根是 ServerRuntimeMBean。
在出現錯誤的情況下，此命令將返回 WLSTException。
有關詳細信息，請參閱瀏覽運行時 MBean。
runtime()
下面的示例在受管服務器實例上，從配置 MBean 層次導航到運行時 MBean 層次。
wls:/mydomain/serverConfig> runtime() Location changed to runtime tree (deprecated).This is a read-only tree with DomainRuntimeMBean as the root. For more help, use help('runtime') wls:/mydomain/runtime>
命令類別：樹命令 用於 WLST：聯機版
導航到配置 MBean 層次中您上一次導航到的 MBean，或導航到層次的根 DomainMBean。
此只讀層次可存儲表示 WLST 當前所連接的服務器的配置 MBean。MBean 特性值包括啟動服務器時用戶指定的所有命令行替換。
在出現錯誤的情況下，此命令將返回 WLSTException。
有關詳細信息，請參閱在 MBean 層次中導航。
serverConfig()
下面的示例在管理服務器實例上，從域運行時 MBean 層次導航到配置 MBean 層次。
wls:/mydomain/domainRuntime> serverConfig() wls:/mydomain/serverConfig>
命令類別：樹命令 用於 WLST：聯機版
導航到運行時 MBean 層次中您上一次導航到的 MBean，或導航到層次的根 ServerRuntimeMBean。此只讀層次可存儲表示 WLST 當前所連接的服務器的運行時 MBean。
在出現錯誤的情況下，此命令將返回 WLSTException。
serverRuntime()
下面的示例在管理服務器實例上，從配置 MBean 層次導航到運行時 MBean 層次。
wls:/mydomain/serverConfig> 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>
表 A-12 描述了 WLST 變量及其常見的用法。所有變量在啟動用戶會話時已初始化為默認值，並且會根據用戶與 WLST 的交互情況發生更改。
|
||||
|
||||