適用於 Macintosh 的 zac (1)

Name

zac - 在 Macintosh 受管理裝置上安裝並執行的 Micro Focus ZENworks 代理程式的指令行管理介面。

語法

zac command options

描述

zac 公用程式可以在 ZENworks 受管理裝置上執行指令行管理功能,包括安裝與移除軟體套裝軟體、套用規則以及註冊與取消註冊裝置。

使用簡介

本節將簡單介紹指令的常用格式與慣例。

大多數指令都具有完整格式與簡短格式:

  • 完整格式:add-reg-key
  • 簡短格式:ark

若兩種格式都可以使用,則指令如下所示:

add-reg-key (ark) 選項

使用指令時,只需輸入完整格式或者簡短格式:

zac add-reg-key 選項

zac ark 選項

若選項包含空格,則以引號括住:

zac ark "選項 1"

必要引數與選用引數

以圓括號括住的引數為必要引數;以方括號括住的引數為選用引數。

省略符號 (...)

省略符號表示指令的最後一個引數類型接受多個項目。這些引數必須使用空格或逗號加以分隔,具體取決於指令本身。例如:

zman server-add-bundle [選項] (伺服器) (套裝軟體) [...]

省略符號表示 server-add-bundle 可接受多個套裝軟體。在指令層級的說明中,可接受多重項目之引數的說明,會以 [(套裝軟體) (套裝軟體) ... (套裝軟體)] 的方式指定,以免混淆。

套裝軟體指令

bundle-install (bin)

根據符合指定規則運算式、字串或套裝軟體 GUID 的顯示名稱,安裝指定的套裝軟體。

使用 bundle-list 指令將獲得可用資源集的清單及其顯示名稱。

安裝套裝軟體的範例:

zac bin MacBundle

bundle-launch (bln)

啟動指定的套裝軟體。此時會執行啟動動作集中的動作。如果嘗試啟動尚未安裝的套裝軟體,系統會先安裝該套裝軟體,然後將其啟動。

使用 bundle-list 指令將獲得可用資源集的清單及其顯示名稱。

根據顯示名稱啟動套裝軟體的範例:

zac bln MacBundle

bundle-list (bl)

顯示指定給裝置與登入使用者的套裝軟體清單。

此指令的輸出會分欄顯示,並提供已指定給受管理裝置或可供受管理裝置使用之每個套裝軟體的詳細資料。「顯示名稱」、「版本」及「套裝軟體類型」欄分別表示套裝軟體的顯示名稱、套裝軟體或沙箱 (如果套裝軟體為沙箱版本) 的版本號碼以及套裝軟體類型。

「狀態」欄顯示以下狀態:

可用:如果已安裝套裝軟體,便會顯示此狀態。

未安裝:如果未安裝特定版本的套裝軟體,便會顯示此狀態。

已下載:如果已下載內容,但尚未執行安裝動作集中的動作,便會顯示此狀態。

列出所有套裝軟體的範例:

zac bl

bundle-lock-add (bla) [選項] [套裝軟體名稱] [...]

鎖定符合指定規則運算式或字串的指定套裝軟體,防止它們升級或遭移除。

套裝軟體鎖定僅適用於安裝動作集。

適用的選項包括:

-li、--lock-install:鎖定套裝軟體,防止安裝鎖定中指定的套裝軟體。

-t、--type:指定要鎖定的套裝軟體類型。可用的類型為 MACPatch。如果未指定類型,則會選取套裝軟體類型。

bundle-lock-list (bll)

列出套裝軟體鎖定。套裝軟體鎖定按 ID 編號排序。

列出鎖定的套裝軟體的範例:

zac bll

bundle-lock-remove (blr)

移除指定編號的套裝軟體鎖定。您可以使用 bundle-lock-list 指令尋找每個鎖定套裝軟體的編號。

移除所有套裝軟體鎖定的範例:

zac blr --remove-all

bundle-props (bp)

傳回套裝軟體的內容資訊。

取得所指定套裝軟體之套裝軟體內容的範例:

zac bp MacBundle

bundle-refresh (br)

重新整理指定套裝軟體的相關資訊。

重新整理套裝軟體的範例:

zac br MacBundle

bundle-search (bse)

搜尋符合指定 Java 規則運算式或字串的套裝軟體。

bundle-uninstall (bu)

解除安裝指定的套裝軟體。在解除安裝套裝軟體時,執行支援「復原」動作的動作。解除安裝套裝軟體完成後,套裝軟體狀態會顯示為「未安裝」

使用 bundle-list 指令將獲得已安裝之資源集的清單及其顯示名稱。

解除安裝套裝軟體的範例:

zac bu MacBundle

bundle-verify (bv)

重新安裝套裝軟體並執行「驗證」動作集,以確定所有檔案均未移除或損毀。使用 bundle-list 指令將獲得已安裝之資源集的清單及其顯示名稱。

驗證套裝軟體的範例:

zac bv MacBundle

核心指令

add-reg-key (ark)

此指令會使用指定的註冊金鑰註冊裝置。

範例:zac add-reg-key

agent-properties (agp)

此指令提供 ZENworks 代理程式的相關資訊。

範例:zac agent-properties

cache-clear (cc)

清除此裝置上的快取。

範例:zac cc

cert-info (ci)

列出各個已知 ZCM 伺服器的公用金鑰證書資訊,或向機器儲存區新增信任的根證書。

範例:

若要列出每個已知 ZENworks 使用者的證書:

zac ci

若要向裝置的信任儲存區新增信任的根證書:

zac ci <位置> -u myuser -p mypassword

config-location (cl)

顯示目前位置。

範例:

zac config-location

file-system-guid (fsg)

在檔案系統中移除或回存工作站 GUID,為擷取影像做好準備。

範例:

顯示 GUID 值:

zac fsg

從檔案系統中移除 GUID 及 conninfo.dat

zac file-system-guid -d

將 GUID 回存至檔案系統:

zac file-system-guid -r

不指定列印 GUID 值的選項:

zac fsg

get-pref (get)

顯示目前設定的優先設定。

顯示名稱以 abc 開頭的所有優先設定的範例:

zac get-pref abc

get-settings (gs)

每次重新整理時,設定模組都會將設定下載至本地快取。這會傳回與指定金鑰關聯的有效設定。

範例:

zac gs key1

您也可以使用 get-settings (gs) 指令列出使用各種金鑰的設定。如需詳細資訊,請參閱狀態指令一節中的 get-settings (gs) <金鑰>

logger [resetlog | level [MANAGED|ERROR|WARN|INFO|DEBUG] |managedlevel]

變更記錄器組態。

您可以使用下列選項:

  • resetlog:重設記錄。
  • level:若不使用層級,則會顯示目前管理的記錄層級。若使用了某個層級,則會將記錄層級變更為指定的層級。
  • managedlevel:顯示區域的全域記錄層級。

對記錄檔進行重設的範例:

zac logger resetlog

顯示當前記錄層級的範例:

zac logger level

將記錄層級設為 DEBUG 及以上的範例:

zac logger level DEBUG

reestablish-trust (retr)

此指令將與目前的區域重新建立信任關係。

針對目前的管理區域重新建立信任。所使用的使用者名稱和密碼必須是區域管理員的使用者名稱和密碼。

範例:

zac retr -u myuser -p mypassword

-u-p 為可選參數。如果不使用 -u-p 參數,系統會提示您輸入使用者名稱與密碼。

refresh (ref)[general | partial bundle <套裝軟體顯示名稱> [bypasscache]

啟動一般重新整理以重新整理所有套裝軟體、規則、註冊與組態設定;或啟動部分重新整理以重新整理所有規則、註冊與組態設定。

使用 bypasscache 避免在重新整理期間使用伺服器快取中的資料。此選項對測試或疑難排解非常有幫助。

範例:

zac ref general bypasscache

zac ref partial bypasscache

register (reg)

此指令用於向指定區域註冊裝置。

若要執行此指令,您必須對嘗試註冊的資料夾擁有建立/刪除裝置權限。

範例:

zac reg -k key1 https://123.456.78.90

reregister (rereg)

此指令將在目前區域中註冊裝置,並為其指定現有裝置物件的 GUID。目前關聯的裝置物件會刪除。若要執行此指令,您必須對嘗試重新註冊的資料夾擁有建立/刪除裝置權限。

若要重新註冊並指定使用者名稱與密碼:

zac reregister -u myuser -p mypassword eaa6a76814d650439c648d597280d5d4

set-pref (set)

設定優先設定的值。

將優先設定值 abc 設為 123 的範例:

zac set-pref abc 123

set-proxy (sp) [選項] <IP 位址/主機名稱:連接埠>

指定要聯絡的代理,而不是直接聯絡 ZENworks 伺服器。

選項包括:

  • --default:設定代理,管理區域中的代理設定可覆寫該值。
  • --clear:清除目前的代理,但使用管理區域中的代理設定。
  • --ipv6:設定 IPv6 代理。

範例:

IPv4:

zac sp 123.456.78.90:2349 administrator novell

zac sp /default 123.456.78.90:2349

zac sp /clear

IPv6:

zac sp /ipv6 [2001:db8:0:1:1:1:1:1]:2349 administrator novell

如果未指定使用者名稱和密碼,系統將提示您輸入。

unregister (unr)

此指令將從目前的區域取消註冊裝置。

若要執行此指令,您必須對嘗試取消註冊的資料夾擁有建立/刪除裝置權限

範例:

zac unr -u administrator -p novell

附註:執行 UNR 指令可能會導致出現資料庫高使用率。發生此情況的原因可能為以下任一種:

  • 伺服器上正在執行 UNR 指令。

  • 區域中包含大量受管理裝置。

  • 受管理裝置具有海量歷程。

  • 啟用了修補程式管理。

zone-config (zc)

此指令將顯示區域組態伺服器或列出目前區域組態。

zac zc

庫存指令

inventory (inv) [scannow]

執行庫存掃描。

執行庫存掃描的範例:

zac inv scannow

僅庫存指令

這些指令僅用於僅庫存 (IOA) 代理程式。

zac ioa cfg <伺服器 IP>

將 MAC IOA 裝置設定為指定的伺服器 IP。

將 MAC 僅庫存裝置註冊到伺服器 <10.70.13.124> 的範例

zac ioa cfg 10.70.13.124

zac ioa version

顯示僅庫存 (IOA) 代理程式的版本。

inventory (inv) [scannow]

執行庫存掃描。

執行庫存掃描的範例:

zac inv scannow

修補程式管理指令

patch-scan (ps)

使用裝置的目前修補程式簽名 (DAU) 檔案掃描裝置中有無未套用的修補程式。之後,結果會上傳至伺服器。

執行修補程式掃描的範例:

zac ps

patch-scan --quick (ps --quick)

將上次掃描結果上傳至伺服器,此指令不會執行新的偵測掃描。

執行快速修補程式掃描的範例:

zac ps --quick

patch-scan --complete (ps --complete)

使用更新的修補程式簽名 (DAU) 檔案掃描裝置中有無未套用的修補程式。之後,結果會上傳至伺服器。

執行完整修補程式掃描的範例︰

zac ps --complete

patch-apply-policy (pap)

使用所有修補程式規則的最新版本更新裝置。

執行修補程式套用規則的範例:

zac pap

patch-quarantine-release (pqr)

釋放執行該指令之裝置上的所有已隔離修補程式,以允許透過修補程式規則排程或矯正排程啟動一次性安裝嘗試。

執行修補程式隔離釋放的範例:

zac pq

輔助角色指令

satellite-cachecfg (satcfg)

從快取讀取輔助角色。

從快取讀取輔助角色的範例:

zac satcfg

satellite-clearcache (satcc)

清除快取中的輔助組態資訊。

從快取清除輔助組態資訊的範例:

zac satcc

satellite-refreshcfg (satrc)

重新整理輔助角色。

重新整理輔助角色的範例:

zac satrc

satellite-roles (satr)

有關目前輔助角色及其狀態的報告。

報告目前輔助角色及其狀態的範例:

zac satr

狀態指令

zenhttp-status(zhs)

列出註冊處理器所用的連接埠和標籤。

列出已註冊處理器的連接埠和標籤的範例:

zac zhs

僅當代理程式升級為輔助裝置時,才可使用此指令。

系統更新指令

zac zeus-refresh / zeus-ref

當已對裝置指定系統更新時,將擷取系統更新。

ZENworks 證書指令

zac certificate-verify / cv

驗證複製到重建儲存庫的伺服器證書和金鑰檔案是否有效,並將結果更新至伺服器。