![[z/OS]](../images/ngzos.svg)
![[AIX Solaris HP-UX Linux Windows]](../images/ngdist.svg)
規則集管理作業
您可以使用 ruleset 指令來新增、移除或修改 ruleset.xml 檔的規則和動作，而不使用管理主控台。
使用下列指令來建立規則集清單，以及在規則集中新增或移除規則和動作:
createRuleset
createRuleset 指令會建立規則集清單。
必要參數
- -rulesetName
- 指定規則集的名稱。 （字串，必要）
- -rulesetType
- 指定要與規則集相關聯的通訊協定類型。 唯一有效的類型是 HTTP 和 SOAP。 （字串，必要）
- -defaultContinue
- 指定預設繼續旗標值的設定。 指定 True 或 False。 （布林，必要）
選用參數
- -odrname
- 指定套用規則集的隨需應變路由器 (ODR) 名稱。 僅當您修改 ODR 時，才需要 -odrname 參數。 （字串，選用）
- -nodename
- 指定 ODR 所在節點的名稱。 僅當您修改 ODR 時，才需要 -nodename 參數。 （字串，選用）
- -clustername
- 指定套用規則集的叢集名稱。 僅當您修改 ODR 叢集時，才需要 -clusterName 參數。 （字串，選用）
批次模式用法範例
- 使用 Jacl：
$AdminTask createRuleset {-odrname odr -nodename node1 -rulesetName myRuleset -rulesetType HTTP -defaultContinue True} - 使用 Jython 字串：
AdminTask.createRuleset ('-odrname odr -nodename node1 -rulesetName myRuleset -rulesetType HTTP -defaultContinue True')
互動模式用法範例
- 使用 Jacl：
$AdminTask createRuleset {-interactive} - 使用 Jython 字串：
AdminTask.createRuleset ('[-interactive]')
listRuleset
listRuleset 指令會列出規則集規則和動作。
必要參數
- -rulesetName
- 指定規則集的名稱。 （字串，必要）
選用參數
- -odrname
- 指定套用規則集的隨需應變路由器 (ODR) 名稱。 僅當您修改 ODR 時，才需要 -odrname 參數。 （字串，選用）
- -nodename
- 指定 ODR 所在節點的名稱。 僅當您修改 ODR 時，才需要 -nodename 參數。 （字串，選用）
- -clustername
- 指定套用規則集的叢集名稱。 僅當您修改 ODR 叢集時，才需要 -clusterName 參數。 （字串，選用）
批次模式用法範例
- 使用 Jacl：
$AdminTask listRuleset {-odrname odr -nodename node1 -rulesetName myRuleset} - 使用 Jython 字串：
AdminTask.listRuleset ('-odrname odr -nodename node1 -rulesetName myRuleset')
互動模式用法範例
- 使用 Jacl：
$AdminTask listRuleset {-interactive} - 使用 Jython 字串：
AdminTask.listRuleset ('[-interactive]')
addRuleToRuleset
addRuleToRuleset 指令會將規則新增至規則集。
必要參數
- -rulesetName
- 指定規則集的名稱。 （字串，必要）
- -ruleName
- 指定規則的名稱。 -ruleName 參數在規則集內必須是唯一的。 （字串，必要）
- -rulePriority
- 指定代表規則優先順序的正整數值。 零是最高優先順序。 （字串，必要）
- -expression
- 指定規則表示式。 您必須以雙引號括住值。 （字串，必要）
選用參數
- -odrname
- 指定套用規則集的隨需應變路由器 (ODR) 名稱。 僅當您修改 ODR 時，才需要 -odrname 參數。 （字串，選用）
- -nodename
- 指定 ODR 所在節點的名稱。 僅當您修改 ODR 時，才需要 -nodename 參數。 （字串，選用）
- -clustername
- 指定套用規則集的叢集名稱。 僅當您修改 ODR 叢集時，才需要 -clusterName 參數。 （字串，選用）
批次模式用法範例
- 使用 Jacl：
$AdminTask addRuleToRuleset {-odrname odr -nodename node1 -rulesetName myRuleset -ruleName myRule -rulePriority 0 -expression "vhost = vhostA"} - 使用 Jython 字串：
AdminTask.addRuleToRuleset('-odrname odr -nodename node1 -rulesetName myRuleset -ruleName myRule -rulePriority 0 -expression "vhost = \'vhostA\'"')
互動模式用法範例
- 使用 Jacl：
$AdminTask addRuleToRuleset {-interactive} - 使用 Jython 字串：
AdminTask.addRuleToRuleset ('[-interactive]')
removeRuleFromRuleset
removeRuleFromRuleset 指令會從規則集移除規則。
必要參數
- -rulesetName
- 指定規則集的名稱。 （字串，必要）
- -ruleName
- 指定要移除的規則名稱。 （字串，必要）
選用參數
- -odrname
- 指定套用規則集的隨需應變路由器 (ODR) 名稱。 僅當您修改 ODR 時，才需要 -odrname 參數。 （字串，選用）
- -nodename
- 指定 ODR 所在節點的名稱。 僅當您修改 ODR 時，才需要 -nodename 參數。 （字串，選用）
- -clustername
- 指定套用規則集的叢集名稱。 僅當您修改 ODR 叢集時，才需要 -clusterName 參數。 （字串，選用）
批次模式用法範例
- 使用 Jacl：
$AdminTask removeRuleFromRuleset {-odrname odr -nodename node1 -rulesetName myRuleset -ruleName myRule} - 使用 Jython 字串：
AdminTask.removeRuleFromRuleset('-odrname odr -nodename node1 -rulesetName myRuleset -ruleName myRule')
互動模式用法範例
- 使用 Jacl：
$AdminTask removeRulefromRuleset {-interactive} - 使用 Jython 字串：
AdminTask.removeRulefromRuleset ('[-interactive]')
changeRule優先順序
changeRulePriority 指令會修改規則的優先順序。
必要參數
- -rulesetName
- 指定規則集的名稱。 （字串，必要）
- -ruleName
- 指定要修改的規則名稱。 （字串，必要）
- -rulePriority
- 指定代表規則優先順序的正整數值。 零是最高優先順序。 （字串，必要）
選用參數
- -odrname
- 指定套用規則集的隨需應變路由器 (ODR) 名稱。 僅當您修改 ODR 時，才需要 -odrname 參數。 （字串，選用）
- -nodename
- 指定 ODR 所在節點的名稱。 僅當您修改 ODR 時，才需要 -nodename 參數。 （字串，選用）
- -clustername
- 指定套用規則集的叢集名稱。 僅當您修改 ODR 叢集時，才需要 -clusterName 參數。 （字串，選用）
批次模式用法範例
- 使用 Jacl：
$AdminTask changeRulePriority {-odrname odr -nodename node1 -rulesetName myRuleset -ruleName myRule -rulePriority 1} - 使用 Jython 字串：
AdminTask.changeRulePriority('-odrname odr-nodename node1 -rulesetName myRuleset -ruleName myRule -rulePriority 1')
互動模式用法範例
- 使用 Jacl：
$AdminTask changeRulePriority {-interactive} - 使用 Jython 字串：
AdminTask.changeRulePriority ('[-interactive]')
changeRule表示式
changeRuleExpression 指令會修改規則表示式。
必要參數
- -rulesetName
- 指定規則集的名稱。 （字串，必要）
- -ruleName
- 指定要修改的規則名稱。 （字串，必要）
- -expression
- 指定新的規則表示式。 （字串，必要）
選用參數
- -odrname
- 指定套用規則集的隨需應變路由器 (ODR) 名稱。 僅當您修改 ODR 時，才需要 -odrname 參數。 （字串，選用）
- -nodename
- 指定 ODR 所在節點的名稱。 僅當您修改 ODR 時，才需要 -nodename 參數。 （字串，選用）
- -clustername
- 指定套用規則集的叢集名稱。 僅當您修改 ODR 叢集時，才需要 -clusterName 參數。 （字串，選用）
批次模式用法範例
- 使用 Jacl：
$AdminTask changeRuleExpression {-odrname odr -nodename node1 -rulesetName myRuleset -ruleName myRule -expression "vhost = vhostB"} - 使用 Jython 字串：
AdminTask.changeRuleExpression('-odrname odr -nodename node1 -rulesetName myRuleset -ruleName myRule -expression "vhost = \'vhostB\'"')
互動模式用法範例
- 使用 Jacl：
$AdminTask changeRuleExpression {-interactive} - 使用 Jython 字串：
AdminTask.changeRuleExpression ('[-interactive]')
addActionToRule
addActionToRule 指令會將動作新增至規則。
必要參數
- -rulesetName
- 指定規則集的名稱。 （字串，必要）
- -ruleName
- 指定規則的名稱。 -ruleName 參數在規則集內必須是唯一的。 （字串，必要）
- -actionName
- 指定動作的名稱。 -actionName 參數在規則集內必須是唯一的。 （字串，必要）
- -actionType
- 指定要與規則相關聯的動作類型。 （字串，必要）
- -actionValue
- 指定要使用的動作值，例如日誌檔的格式。 （字串，必要）
- -actionContinue
- 指定動作繼續旗標值的設定。 指定 True 或 False。 （布林，必要）
選用參數
- -odrname
- 指定套用規則集的隨需應變路由器 (ODR) 名稱。 僅當您修改 ODR 時，才需要 -odrname 參數。 （字串，選用）
- -nodename
- 指定 ODR 所在節點的名稱。 僅當您修改 ODR 時，才需要 -nodename 參數。 （字串，選用）
- -clustername
- 指定套用規則集的叢集名稱。 僅當您修改 ODR 叢集時，才需要 -clusterName 參數。 （字串，選用）
批次模式用法範例
- 使用 Jacl：
$AdminTask addActionToRule {-odrname odr -nodename node1 -rulesetName myRuleset -ruleName myRule -actionName myAction -actionType log -actionValue "MyCustom.log %r %T %z %Z" -actionContinue true} - 使用 Jython 字串：
AdminTask.addActionToRule('-odrname odr -nodename node1 -rulesetName myRuleset -ruleName myRule -actionName myAction -actionType log -actionValue "MyCustom.log %r %T %z %Z" -actionContinue true')
互動模式用法範例
- 使用 Jacl：
$AdminTask addActionToRule {-interactive} - 使用 Jython 字串：
AdminTask.addActionToRule ('[-interactive]')
removeActionFromRule
removeActionFromRule 指令會從規則中移除動作。
必要參數
- -rulesetName
- 指定規則集的名稱。 （字串，必要）
- -ruleName
- 指定包含動作的規則名稱。 （字串，必要）
- -actionName
- 指定要移除的動作名稱。 （字串，必要）
選用參數
- -odrname
- 指定套用規則集的隨需應變路由器 (ODR) 名稱。 僅當您修改 ODR 時，才需要 -odrname 參數。 （字串，選用）
- -nodename
- 指定 ODR 所在節點的名稱。 僅當您修改 ODR 時，才需要 -nodename 參數。 （字串，選用）
- -clustername
- 指定套用規則集的叢集名稱。 僅當您修改 ODR 叢集時，才需要 -clusterName 參數。 （字串，選用）
批次模式用法範例
- 使用 Jacl：
$AdminTask removeActionFromRule {-odrname odr -nodename node1 -rulesetName myRuleset -ruleName myRule -actionName myAction} - 使用 Jython 字串：
AdminTask.removeActionFromRule('-odrname odr -nodename node1 -rulesetName myRuleset -ruleName myRule -actionName myAction')
互動模式用法範例
- 使用 Jacl：
$AdminTask removeActionFromRule {-interactive} - 使用 Jython 字串：
AdminTask.removeActionFromRule ('[-interactive]')
addDefault動作
addDefaultAction 指令會將預設動作新增至規則集。
必要參數
- -rulesetName
- 指定規則集的名稱。 （字串，必要）
- -actionName
- 指定動作的名稱。 -actionName 參數在規則集內必須是唯一的。 （字串，必要）
- -actionType
- 指定要與規則相關聯的動作類型。 （字串，必要）
- -actionValue
- 指定要使用的動作值，例如日誌檔的格式。 （字串，必要）
- -actionContinue
- 指定動作繼續旗標值的設定。 指定 True 或 False。 （布林，必要）
選用參數
- -odrname
- 指定套用規則集的隨需應變路由器 (ODR) 名稱。 僅當您修改 ODR 時，才需要 -odrname 參數。 （字串，選用）
- -nodename
- 指定 ODR 所在節點的名稱。 僅當您修改 ODR 時，才需要 -nodename 參數。 （字串，選用）
- -clustername
- 指定套用規則集的叢集名稱。 僅當您修改 ODR 叢集時，才需要 -clusterName 參數。 （字串，選用）
批次模式用法範例
- 使用 Jacl：
$AdminTask addDefaultAction {-odrname odr -nodename node1 -rulesetName myRuleset -actionName defAction -actionType log -actionValue "default.log %a %d %D" -actionContinue True} - 使用 Jython 字串：
AdminTask.addDefaultAction('-odrname odr -nodename node1 -rulesetName myRuleset -actionName defAction -actionType log -actionValue "default.log %a %d %D" -actionContinue True')
互動模式用法範例
- 使用 Jacl：
$AdminTask addDefaultAction {-interactive} - 使用 Jython 字串：
AdminTask.addDefaultAction ('[-interactive]')
removeDefault動作
removeDefaultAction 指令會從規則集移除預設動作。
必要參數
- -rulesetName
- 指定規則集的名稱。 （字串，必要）
- -actionName
- 指定要移除的動作名稱。 （字串，必要）
選用參數
- -odrname
- 指定套用規則集的隨需應變路由器 (ODR) 名稱。 僅當您修改 ODR 時，才需要 -odrname 參數。 （字串，選用）
- -nodename
- 指定 ODR 所在節點的名稱。 僅當您修改 ODR 時，才需要 -nodename 參數。 （字串，選用）
- -clustername
- 指定套用規則集的叢集名稱。 僅當您修改 ODR 叢集時，才需要 -clusterName 參數。 （字串，選用）
批次模式用法範例
- 使用 Jacl：
$AdminTask removeDefaultAction {-odrname odr -nodename node1 -rulesetName myRuleset -actionName defAction} - 使用 Jython 字串：
AdminTask.removeDefaultAction('-odrname odr -nodename node1 -rulesetName myRuleset -actionName defAction')
互動模式用法範例
- 使用 Jacl：
$AdminTask removeDefaultAction {-interactive} - 使用 Jython 字串：
AdminTask.removeDefaultAction ('[-interactive]')