適用於 Windows 的 zac (1)

Name

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

語法

zac command options

描述

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

使用簡介

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

  • 完整格式︰add-reg-key

  • 簡短格式︰ark

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

add-reg-key (ark) 引數

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

zac add-reg-key 引數

zac ark 引數

引數可以是必要引數,也可以是選用引數。必要引數以尖角括弧括住,如 <引數>。選用引數以方括弧括住,如 [引數]。如果引數包含空格,則以引號括住︰

zac ark "arg 1"

說明指令

/h 或 --help

顯示指令的相關資訊。

驗證輔助伺服器指令

authentication server reconfigure (asr) [-t all|config|casa] [-u username] [-p password]

重新設定啟用的驗證輔助裝置。

範例:

從伺服器擷取組態檔案︰

zac asr -t config

重新設定 CASA 簽章證書︰

zac asr -t casa

重新設定整個輔助裝置︰

zac asr -t all -u 管理員 -p 密碼

如果需要使用者名稱和密碼,但指令行中未提供,系統會提示您予以指定。

輔助角色指令

satellite server reconfigure (ssr) [-t jetty] [-u username] [-p password]

重新設定 Jetty Web 伺服器。

重新設定 Jetty Web 伺服器︰

zac ssr -t jetty -u Administrator -p password

Import-satellite-cert (isc) [-pk <private-key.der>] [-c <signed-server-certificate.der>] [-ca<signing-authority-public-certificate.der>] [-ks <keystore.jks>] [-ksp<keystore-pass-phrase>] [-a <signed-cert-alias>] [-cp<signed-cert-passphrase>] [-u <username>] [-p <password>] [ -rc ]

使用外部簽署的證書設定輔助裝置。

-rc:確認重新設定輔助伺服器,如此管理員就不會收到重新組態提示。

套裝軟體指令

bundle-install (bin) <套裝軟體顯示名稱>

安裝指定的套裝軟體。使用 bundle-list 指令將獲得可用套裝軟體及其顯示名稱的清單。

範例:

zac bin bundle1

bundle-launch (bln) <套裝軟體顯示名稱> [-noSelfHeal]

啟動指定的套裝軟體。使用 bundle-list 指令將獲得可用套裝軟體及其顯示名稱的清單。

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

zac bln bundle1

以下是根據顯示名稱啟動套裝軟體,並在啟動動作失敗時關閉自我修復功能 (預設會開啟自我修復) 的範例︰

zac bln bundle1 -noSelfHeal

bundle-list (bl)

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

範例:

zac bl

bundle-props (bp) <套裝軟體顯示名稱>

顯示指定套裝軟體的狀態、版本、GUID 以及要求等資訊。使用 bundle-list 指令將獲得可用套裝軟體及其顯示名稱的清單。

範例:

zac bln bundle1

bundle-refresh (br) <套裝軟體顯示名稱或 guid>

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

範例:

zac br bundle1

bundle-uninstall (bu) <套裝軟體顯示名稱>

解除安裝指定的套裝軟體。使用 bundle-list 指令將獲得已安裝之套裝軟體及其顯示名稱的清單。

範例:

zac bu bundle1

bundle-verify (bv) <套裝軟體顯示名稱>

驗證已安裝的套裝軟體 (透過套裝軟體顯示名稱指定),以確定沒有移除或損壞檔案。使用 bundle-list 指令將獲得已安裝之套裝軟體及其顯示名稱的清單。

範例:

zac bv bundle1

證書指令

cert-info (ci) [CA 證書檔案路徑] [-u <使用者名稱> -p <密碼>]

列出各個已知 ZENworks 伺服器的公用金鑰證書資訊,或向裝置的信任儲存區新增信任的根證書。檔案可以採用 ASN.1 DER 格式或 base64 編碼,並由 ----BEGIN CERTIFICATE---- 和 ----END CERTIFICATE-- 進行分隔。

範例:

若要列出每個已知 ZENworks 伺服器的證書︰

zac ci

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

zac ci c:\certs\mytrustcacert.der -u myuser -p mypassword

集合彙總指令

collection-point (cp)

顯示收集角色的狀態和組態。

範例:

collection-point [wake]

喚醒︰喚醒執行收集的模組 (庫存、MD 狀態、郵件寄件者)

collection-upload-orphans (cuo)

找到輔助裝置中遺留的檔案,然後將其彙總至父收集伺服器,或將其刪除 (若已彙總)。

此指令可建立 %zenworks_home%\work\collection 下的資料夾中所含檔案的清單,然後嘗試尋找收集狀態資料庫中每個項目的原始上傳資訊。

若資料庫中含有檔案項目,且其顯示此檔案尚未彙總,指令會將此檔案彙總。若項目顯示此檔案已彙總,指令會將輔助裝置中的檔案刪除。若資料庫中沒有檔案項目,指令會將檔案彙總。此指令還會列出未上傳或未刪除的所有檔案。

在執行此指令之前,您應該執行 zac crw 指令,以將等待中的所有檔案傳送至父伺服器。

範例:

zac cuo

內容配送指令

cdp-checksum (cchk) [-l:<記錄的路徑>]

透過對每個檔案計算檢查總和來驗證輔助裝置內容。

可選的記錄檔會詳細記錄檢查總和比較的結果。

範例:

zac cchk -l:"C:\Program Files\Novell\ZENworks\logs\cchk.log"

cdp-verify-content (cvc) [-c] [-l:<記錄的路徑>]

將此 CDP 上內容 ID 及其同步狀態的清單與主要伺服器認為它應具有的狀態進行比較。

您可以使用下列選項︰

  • -c︰對本地內容計算檢查總和。

範例︰

zac cvc -l:"C:\Program Files\Novell\ZENworks\logs\cvc.log"

cdp-import-content (cic) <內容路徑> [-l:<記錄的路徑>]

輸入內容路徑指定的目錄下缺少的內容,並記錄到 log-path 指定的檔案中。

範例:

zac cic c:\輸入來源目錄 -l:"C:\Program Files\Novell\ZENworks\logs\cic.log"

wake-cdp (cdp) [replicate | cleanup]

喚醒內容配送點工作線串。您可以使用下列任一選項︰

  • replicate︰從內容配送點的父 ZENworks 伺服器下載所有新的或變更後的內容。
  • cleanup︰移除無需再儲存於「內容配送點」的全部內容。

範例:

zac cdp

zac cdp replicate

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

資料庫指令

statussender RollUp

將自上一次成功彙總狀態後更新過的狀態彙總至 MDStatus 資料庫。依預設,狀態寄件者每 5 分鐘自動彙總狀態一次。

MDStatus 資料庫用於將套裝軟體與規則狀態從受管理裝置彙總至 ZENworks 伺服器。

影像指令

file-system-guid (fsg)[-d] [-r]

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

例如︰

顯示 GUID 值︰

zac fsg

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

zac file-system-guid -d

將 GUID 回存至檔案系統︰

zac file-system-guid -r

顯示 GUID 值︰

zac fsg

庫存指令

inventory [scannow | cdf | -f scannow]

執行庫存掃描或開啟收集資料表單。

執行庫存掃描的範例:

zac inv scannow

開啟收集資料表單的範例:

zac inv cdf

執行完整掃描的範例︰

zac inv -f scannow

位置指令

config-location (cl)

顯示組態位置。組態位置決定裝置為進行驗證、設定組態、獲取內容及收集等目的而要連接的一或多個目標 ZENworks 伺服器。

範例:

zac config-location

zac cl

記錄指令

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

變更或顯示 ZENworks Agent 的記錄器組態。

您可以使用下列選項︰

  • resetlog︰重設記錄。
  • level︰若使用此選項但未指定層級,則會顯示目前管理的記錄層級。若使用選項時指定某個層級,則會將記錄層級變更為指定的層級。
  • managedlevel︰顯示區域的全域記錄層級。

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

zac logger resetlog

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

zac logger level

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

zac logger level DEBUG

作業系統目標指令

ostarget (os)

顯示與工作站作業系統或指定的版本字串關聯的 ostarget 記錄。

範例︰

若要顯示工作站的版本字串和相應 ostarget 資訊,請執行︰

zac ostarget

若要顯示特定版本字串的相應 ostarget 資訊,請執行︰

zac ostarget "Windows XP Professional Service Pack 2 (Build 2600)"

修補程式管理指令

patch-scan (ps)

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

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

zac ps

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

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

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

zac ps --quick

patch-apply-policy (pap)

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

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

zac pap

patch-quarantine-release (pqr)

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

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

zac pqr

規則指令

policy-list (pl)

列出裝置上目前正在執行的規則 (有效規則)。若要列出所有規則 (有效及無效規則),請使用 --all 選項。

範例:

zac pl

zac pl --all

policy-refresh (pr)

套用指定給裝置及使用者的所有規則。

範例:

zac pr

註冊指令

add-reg-key (ark) <註冊金鑰>

使用指定金鑰註冊裝置。使用金鑰進行的註冊具有累加性。如果之前已使用金鑰註冊裝置,則使用新金鑰再次註冊時,裝置會收到與這個兩個金鑰關聯的所有群組指定。

範例:

zac ark key12

register (reg) [-g] [-k <金鑰>] [-u <使用者名稱> -p <密碼>] <ZENworks 伺服器位址:連接埠>

在管理區域中註冊裝置。

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

您可以使用下列選項︰

  • g:如果您有多部具有相同 GUID 的裝置,該選項可讓您使用新的 GUID 與密碼為裝置建立新的裝置物件。如果使用此參數註冊裝置,則指定給原始裝置物件的所有關聯 (規則與套裝軟體) 都將移除。您無法使用此選項為主要伺服器或輔助裝置建立新 GUID。本地使用者必須擁有本地管理員權限才能使用此選項。
  • k︰可讓您使用指定的註冊金鑰註冊裝置。
  • p︰可讓您指定管理區域管理員的密碼。
  • u︰可讓您指定管理區域管理員的使用者名稱。

範例:

zac reg -k key1 https://123.456.78.90

zac reg -k key1 -u administrator -p novell https://zenserver.novell.com:8080

只有在 ZENworks 伺服器未使用標準的 HTTP 埠 (80) 時,才要求提供埠號碼。若沒有提供使用者名稱及密碼,系統會進行提示。

reregister (rereg)[-u <使用者名稱> -p <密碼>] <新 GUID>

在目前區域中註冊裝置,並為其指定現有裝置物件的 GUID。目前關聯的裝置物件會刪除。

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

例如,若在更換硬碟後複製裝置影像,裝置便會獲得一個新的 GUID。但是,使用 reregister 指令可以在更換硬碟前指定裝置的 GUID。

範例:

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

zac reregister -u myuser -p mypassword eaa6a76814d650439c648d597280d5d4

若要重新註冊並在提示後輸入使用者名稱與密碼:

zac reregister eaa6a76814d650439c648d597280d5d4

附註:如果伺服器上已經存在相應的裝置物件,且對該裝置物件進行了重整,則 -g-k 選項將不起作用。

unregister (unr) [-f] [-s] [-a] [-u <使用者名稱> -p <密碼>]

從管理區域移除裝置的註冊。

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

範例:

無法連接伺服器時強制在本地取消註冊裝置︰

zac unr -f -u myuser -p mypassword

在本地取消註冊且不提示使用者提供使用者名稱與密碼:

zac unr -s

使用 -a 選項可非同步執行取消註冊。若使用此選項,伺服器會非同步地刪除裝置。

-a、-f、-u-p 為可選參數。若不使用 -u-p 參數,系統會提示您輸入使用者名稱與密碼。-f 參數將忽略 ZENworks 資料庫並強制在本地取消註冊裝置;只有當 ZENworks 資料庫中刪除了裝置物件或裝置無法連接到資料庫時才需要使用此選項。如果指定 -a 選項,ZENworks 伺服器很快就會傳回取消註冊呼叫,但稍後才會從資料庫非同步地刪除裝置物件。如果您未完成裝置刪除過程就嘗試再次註冊裝置,ZENworks 伺服器將會顯示一則錯誤。如果資料庫中有大量資料與該裝置關聯,則可能需要花費較長時間才能完成刪除該裝置的程序。如果在伺服器上實際刪除裝置會花費較長時間,並會導致代理程式取消註冊指令逾時,則務必使用 -a 選項。

附註:執行 UNR 指令可能會導致佔用大量的資料庫資源。發生此情況的原因可能為以下任一種︰

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

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

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

  • 啟用了修補程式管理。

reestablish-trust (retr) [-u <使用者名稱> -p <密碼>]

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

範例:

zac retr -u myuser -p mypassword

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

遠端管理指令

request-remote-session、rrs

從受管理裝置 (即使缺少 Z 圖示) 申請遠端管理工作階段。此指令適用於安裝了 11.3.1 及更新版本的受管理裝置。

範例︰

zac request-remote-session

zac rrs

狀態指令

cache-clear (cc)

清除裝置上的 ZENworks 快取。此指令可移除快取資料庫中的所有項目,並刪除與這些項目關聯的所有快取檔案。

範例:

zac cc

附註:如果您的 ZENworks 管理員啟用了 ZENworks Agent 的自我防禦功能,您必須在執行 zac cc 指令之前提供覆寫密碼。否則,您會收到以下訊息︰

You do not have permission to clear the cache. Please contact your ZENworks administrator.

您必須請 ZENworks 管理員提供覆寫密碼。如果管理員尚未設定覆寫密碼,必須由其先進行設定,之後您才能使用此指令。收到密碼後︰

  1. 連按兩下 ZENworks 系統匣中的 ZENworks 圖示 (z 圖示),然後按一下「狀態」下的「代理程式」,再按一下「代理程式安全性設定」區段的「規則覆寫」連結,以顯示「關於」方塊。

  2. 按一下「覆寫規則」並輸入覆寫密碼,然後按一下「覆寫」

  3. 轉至指令行提示字元並執行 zac cc 指令。

  4. 成功清除快取之後返回「關於」方塊,並按一下「載入規則」以停用密碼覆寫。

dump-prop-pages (dpp) <目標目錄>

將 ZENworks 圖示之內容頁中顯示的 HTML 頁面輸出到指定目標目錄中的檔案。

範例:

zac dpp c:\temp

get-settings (gs) <金鑰>

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

範例︰

zac gs key1

所有有效的 ZENworks 設定金鑰都儲存在 %ZENWORKS_HOME%\cache\zmd\settings 目錄中。

列出遠端管理設定的範例:

zac gs RemoteManagement

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

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

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

範例:

zac ref general bypasscache

zac ref partial bypasscache

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

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

選項包括:

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

範例︰

IPv4:

zac sp 123.456.78.90:2349 administrator novell

zac sp /default 123.456.78.90:2349

zac sp /clear

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

winproxy-refresh (wpr)

在管理區域中查詢是否存在要指定給此裝置的代理工作。

範例:

zac wpr

zenhttp-status(zhs)

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

範例:

zac zhs

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

info-collect (zeninfo) [<目標檔案>] [-q]

收集 ZENworks 支援資訊,其中包括快取資料、組態資料、除錯記錄、產品安裝資訊、重新整理時間、狀態事件以及基本系統資訊。支援資訊會封裝到 ZIP 檔案,並存放到您指定的位置。如果沒有指定位置,則 Windows 系統會使用 ${TEMP}\zeninfo-${DateTime}.zip,Linux 系統會使用 ${TMPDIR}\zeninfo-${DateTime}.zip。如果受管理裝置發生問題,Micro Focus 支援部門可能會要求您執行此指令,並將產生的 ZIP 檔案傳送至 Micro Focus 以協助進行疑難排解。

若要在背景中執行 zeninfo 程序,請執行以下指令。這些指令僅適用於 Linux︰

zac zeninfo /tmp/zeninfo/ & echo $! > /tmp/zeninfo/zeninfo.pid

若要停止 zeninfo 程序,請執行以下指令:

kill `cat /tmp/zeninfo/zacinfo.pid`

您可以使用以下選項︰

  • q︰收集後不啟動檔案總管。

zeninfo 指令可以由本地管理員執行。如果您不是本地管理員,但要執行此指令,系統會提示您輸入管理員身分證明。您也可以將 AllowZenInfoWithoutAdminPwd 字串值設定為 True,以允許所有使用者執行 zeninfo 指令。若要設定 AllowZenInfoWithoutAdminPwd 字串值,請執行以下操作:

  1. 開啟「登錄編輯程式」。

  2. 轉至 HKLM\Software\Novell\ZCM\

  3. AllowZenInfoWithoutAdminPwd 字串值設定為 True

警告:如果 AllowZenInfoWithoutAdminPwd 字串值已設定為 True,則本地管理員以外的使用者也可以看到機密的 ZENworks Configuration Management 設定和組態資訊。

zone-config (zc) [-l]

裝置要存取組態資訊之 ZENworks 伺服器 (組態伺服器) 的相關資訊,或列出組態伺服器的資訊。

範例:

zac zc

zac zc -l

statussender (sts)

此指令會將狀態資訊彙總到主要伺服器。您可以彙總自上次彙總狀態以來更新的資訊,也可以彙總完整的狀態資訊。

範例︰

若要彙總自上次成功彙總狀態以來更新的狀態資訊,請執行︰

zac sts rollup

若要使用同一個線串彙總狀態資訊,請執行︰

zac sts rollup syn

若要彙總完整的狀態資訊,請執行︰

zac sts rollup full

附註:自 ZENworks 2020 版本起,已廢棄 zac bsr 指令。執行 zac sts 指令可以彙總套裝軟體狀態資訊。

系統更新指令

zac zeus-refresh / zeus-ref

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

ZENworks Endpoint Security Management 指令

zac zesm-refresh / zesm-ref

重設受管理裝置上的 ZENworks Endpoint Security Managemen 快取。