适用于 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) <key>

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

校验复制到重建储存库的服务器证书和密钥文件是否有效,并将结果更新到服务器。