使用 wsadmin Scripting 的管理指令互動模式環境

收集目標物件和參數的使用者輸入

下列互動式提示用來收集指令特定說明中所顯示「目標」物件和「引數」輸入區域的輸入:

Command title

Command Description

*target object title [current or default value]:
*param1 title (param1 name) [choice1, choice2, ...]: [current/default value] 
param2 title (param2 name) [choice1, choice2, ...]: [current/default value]
...

顯示指令執行功能表

如果管理指令不包含步驟，則在收集目標物件及參數的值之後，您會看到下列功能表:

Command title

F (Finish)
C (Cancel)

Select [F, C]: F

「完成」選項會執行指令，而「取消」選項會取消指令。 預設選項為 F (完成)。 此功能表是針對非步驟指令所顯示的最後一個功能表，可透過取消或執行指令來結束互動模式。

顯示指令步驟選擇和執行功能表

如果管理指令包含步驟，則在收集目標物件及參數的值之後，會顯示下列功能表:

Command title
Command description
 -> *1. step1 title (step1 name)
     2. step2 title (step2 name)
    *3. step3 title (step3 name)
    (4. step4 title (step4 name))
     …
     n. stepn title (stepn name)

S (Select)
N (Next)
P (Previous)
F (Finish)
C (Cancel)
H (Help)

Select [S, N, P, F, C, H]: S

功能表中顯示的步驟數視管理指令而定。 步驟名稱會針對資訊顯示，並且是用來在此步驟中以批次模式設定資料的名稱。 下列表示法用來說明步驟:

• 步驟之前的 "->" 指出現行步驟位置。
• 步驟之前的 "*" 指出必要的步驟。
• A () 含括整個步驟表示已停用步驟。 您無法使用「下一步」或「上一步」選項來導覽至此步驟。

使用功能表，您可以選取上一個或下一個來循序導覽步驟。 選取選取現行步驟、完成執行指令、取消取消指令，以及「說明」提供指令的線上說明。 並非所有功能表選項都可用。 如果現行步驟是第一個步驟，則無法使用前一個步驟。 如果現行步驟是最後一個步驟，則「下一步」無法使用。 如果仍有步驟遺漏必要的輸入，則無法使用「完成」。 如果現行步驟是有效步驟，且步驟遺漏必要輸入，則預設選項為 S (選取)。 如果為步驟提供所有必要的輸入，則預設選項為 F (完成)。

對於具有步驟的指令，您可以透過取消或執行指令，在此功能表上結束互動模式。

顯示集合步驟功能表

步驟不一定支援集合。 集合是指相同類型的物件。 在管理指令中，集合包含具有相同參數集的物件。 如果選取支援集合的步驟， wsadmin 工具會顯示下列功能表，以新增及選取集合中的物件:

Step title (step name)
    | key param1 title (key param1 name), key param2 title (key param2 name), ...
    ---------------------------------------------------------------------------
->  | object1 key param1 value, key param2 value, ...
   *| object2 key param1 value, key param2 value, ...
    ...
key param1 title, key param2 title, ... must be provided to specify a row in batch row.

S (Select Row)
N (Next)
P (Previous)
A (Add Row or Add Row Before)
D (Delete Row)
F (Finish)
H (Help)

Select [S, N, P, A, D, F, H]: F

功能表中顯示的物件數視指令步驟而定。 主要參數由用來唯一識別集合中物件的步驟識別。 會顯示索引鍵參數值，以識別要選取的物件。 如同指令步驟選取功能表，會使用箭頭 (->) 來指出現行物件位置，並使用星號 (*) 來指出物件中遺漏必要的輸入。

請選取上一個或下一個，以使用功能表來循序導覽物件。 選取「列」選取現行物件、「新增列」新增物件、「新增列」在現行物件之前新增物件、「刪除列」刪除現行物件、「完成」將控制權交還給步驟選擇及執行功能表，以及「說明」提供步驟的線上說明。 並非所有功能表選項都可用。 如果集合中沒有物件，或第一個物件是現行物件，則無法使用前一個物件。 如果集合中沒有物件，或最後一個物件是現行物件，則「下一步」無法使用。 只有在有現行物件時，才能選取「列」。 只有在集合中沒有物件且步驟支援要新增的新物件時，才會提供「新增列」。 如果步驟支援新增物件，且集合中有現有的物件，則會提供「之前新增列」。 只有在有現行物件且步驟支援要刪除的物件時，才會提供「刪除列」。 如果仍有物件遺漏必要的輸入，則無法使用「完成」。 當集合中沒有物件且步驟支援要新增的物件時，預設選項為 A (新增列)。 如果有現行物件，且仍有物件遺漏必要的輸入，則預設選項是 S (選取列)。 如果任何物件中沒有遺漏必要的輸入，則預設選項是 F (完成)。

收集集合物件的參數的使用者輸入

選取集合物件之後，會循序提示每一個參數的參數值，如下列範例所示:

*param1 title (param1 name) [choice1, choice2, ...]: [current/default value] 
param2 title (param2 name) [choice1, choice2, ...]: [current/default value]
...

參數數目取決於指令步驟特定說明之引數區域中的引數數目。 使用相同的星號 (*) 表示法來表示必要的參數。 如果參數值限制為一組值，則會顯示有效的選項。 如果現行或預設值可用，則會顯示該值。 對於每一個可寫入參數，您可以按 Enter 鍵接受現有的值。 若要新增或變更現有值，請輸入新值，然後按 Enter 鍵。 若為唯讀參數，則會顯示參數及其值。 系統不會提供您修改其值的提示。 完成所有參數之後， wsadmin 工具會回到集合步驟功能表。

收集非收集步驟的使用者輸入

此步驟有兩個部分。 第一部分顯示所選步驟的現行或預設參數值，如下列範例所示:

Step title (step name)

*param1 title (param1 name) [choice1, choice2, ...]: [current/default value] 
param2 title (param2 name) [choice1, choice2, ...]: [current/default value]
...

Select [C (Cancel), E (Edit)]: [E]

此組件中不包含任何提示。 相反地，此組件更像是說明函數，提供所選取步驟的相關參數資訊。 參數數目取決於指令步驟特定說明的 argument 區域中的引數數目。 星號 (*) 表示法表示必要的參數。 如果參數值限制為一組值，則會顯示有效的選項。 如果現行或預設值可用，則會顯示該值。 您可以選擇取消步驟，或繼續下一個部分以提供參數輸入。 預設選項為 Edit。 因為您可能看到指派給新資料片段的預設值尚未在步驟中設定，所以您可以接受預設選項以繼續下一個部分。 否則，如果選取的步驟中沒有資料，則選取「取消」不會導致建立資料。

如果您接受預設 Edit 選項，則會循序收集參數的使用者輸入，就像收集集合物件參數的使用者輸入一樣。

*param1 title (param1 name) [choice1, choice2, ...]: [current/default value] 
param2 title (param2 name) [choice1, choice2, ...]: [current/default value]
...

對於每一個可寫入參數，您可以按 Enter 鍵接受現有的值。 若要新增或變更現有值，請輸入新值，然後按 Enter 鍵。 若為唯讀參數，則會顯示參數及其值。 系統不會提示您修改參數的值。 只要您逐步執行所有參數， wsadmin 工具就會引導您回到指令步驟選取和執行功能表。