Service Registry 3.1 管理指南

Admin Tool 功能

本小節說明 Admin Tool 的以下功能︰

許可權

使用 Admin Tool 時,您僅能執行在啟動此工具時為其指定金鑰別名和密碼的使用者可以執行的動作。只有身為管理員角色的使用者,才能執行指令以變更非使用者所擁有的物件。如需詳細資訊,請參閱建立管理員

顯示異常

Admin Tool 可讓您避免在指令失敗時檢視很長的堆疊追蹤。

指令失敗時,Admin Tool 會輸出堆疊追蹤的第一行和以下訊息︰


An error occurred when executing the function.  Use the show exception 
command to view messages.

如果您需要更多資訊,請接著執行 show exception 指令,以查看完整堆疊追蹤。

show exception 指令會自動顯示前一緊接指令的堆疊追蹤。

識別登錄 (Registry) 物件

識別登錄 (Registry) 物件的主要方法是依名稱。然而,您通常可按照從 registry 根至 RegistryPackage 的路徑來識別 Registry 套裝軟體 (RegistryPackage) 物件。例如,/registry/userDatauserData Registry 套裝軟體 (RegistryPackage) 的路徑。

某些名稱的比對支援萬用字元。使用問號 (?) 可比對單一字元。使用星號 (*) 可比對零個或多個字元。

某些指令 (例如,cdchown) 支援依物件的單一資源名稱 (URN) (必須包含前導字元 urn:) 來識別物件。例如,urn:uuid:2702f889-3ced-4d49-82d1-e4cd846cb9e4 是有效的 URN。

chowncp 指令還支援使用 %number 來參考前一 users 指令列出的使用者 (User)

對於某些指令,如果要輸入含有空格的名稱,請以雙引號括住整個名稱,或在名稱中的每個空格前加上反斜線。

select 指令支援使用 SQL 萬用字元︰百分比符號 (%) 用於比對多個字元,而底線 (_) 則用於比對單一字元。

語言環境對指定名稱的影響

RegistryObject (或 Registry 套裝軟體 (RegistryPackage)) 可具有多個名稱,每個名稱關聯一個不同的語言環境。

您指定的路徑和物件名稱僅根據目前的語言環境計算。嘗試依名稱選取具有多個名稱的登錄 (Registry) 物件時,Registry 會嘗試將您提供的名稱僅與一個登錄 (Registry) 物件名稱 (其語言環境與目前的語言環境最相符) 選項相比對,而非與登錄 (Registry) 物件的所有名稱相比對。

例如,假定目前 Registry 套裝軟體 (RegistryPackage) 的成員物件具有兩個名稱,每個名稱關聯一個不同的語言環境︰在 en (英文) 語言環境中為 red,在 fr (法文) 語言環境中為 rouge。目前的語言環境是 en 時,指令 ls rouge 不會顯示該成員物件,但當語言環境是 fr (或其一個變體) 時,則會顯示該成員物件。

大小寫相符性

Admin Tool 辨識的指令名稱和文字參數無須大小寫相符。例如,lsLsLS 均指同一個指令。

您為其提供值的選項會被逐字地傳送至使用該選項的代碼。