Name
zman
- 用于管理 Micro Focus ZENworks 产品(包括资产管理、配置管理、端点安全性管理和全盘加密)的命令行界面。
说明
zman 命令行界面提供了快速访问大多数 ZENworks 管理操作的途径。利用脚本中的 zman 命令,您可以自动执行许多 ZENworks 管理任务。
以下部分介绍针对 ZENworks 产品提供的所有命令的相关信息。这些命令适用于所有产品,但也有以下例外:
语法
zman <类别>-<命令> [-选项] [自变量]
一般而言,zman 命令有简称和全称两种形式。全称是“类别-操作”的组合形式。例如,使用 registration-list 命令会列出注册文件夹中的所有注册。虽然命令的数量众多,但其中的大多数都非常好记,因为它们被分成了各个类别(工作站、服务器、分发包、策略、管理员、注册等)以及可对这些类别执行的大多数常见操作(列出、创建、修改、删除)。
每个命令的简称均使用全称中每个单词的其中一个字母。按照这种方式,admin-list 可简化为 al。为保持简称的唯一性,此规则也有一些例外。例如,bc 是 bundle-create 的简称,而 bcp 是 bundle-copy 的简称。
命令可以使用选项和自变量。选项可以在命令中的任意位置指定。自变量依赖于位置。
选项
选项包括开关和标志选项两类。每一类都有各自的全称和简称。简称的前面有一个连字符,全称的前面则有两个连字符。例如,-n 和 --namefilter 分别是某个标志选项的简称和全称,用于按名称过滤 bundle-list 命令的显示结果。
自变量
命令自变量的排序方式通常与命令自身的排序方式相同。例如,server-add-bundle 会先命名服务器,然后再命名分发包。
使用指南
这一部分包含有关一般命令格式和约定的指南。
- 管理员
-
zman 中的每个操作都受到管理员访问限制条件的控制。在初始安装期间创建的初始“管理员”帐户拥有对全部对象的权限。而创建的其他管理员帐户则默认只会授予只读权限。对于这些帐户,必须显式授予对要管理对象的权限。
- 帮助
-
zman 命令行界面提供几个级别的帮助。通过操作系统本身的 more 命令,提供滚动输出的一系列帮助。
-
对于每个类别,列出专用于该类别的可用命令。
示例:zman policy /?
-
在每个命令级别上,提供特定命令的用法、详细帮助和示例。
示例:zman policy-list --help
-
-h 和 --help 都是可用的 help 选项。
- 文件夹
-
如果没有为带有文件夹自变量的命令指定文件夹,命令就会采用根文件夹。要指定文件夹路径,请从根文件夹开始列出每个文件夹,并以正斜杠 (/) 分隔。例如,如果根文件夹中有一个名为 folder1 的文件夹,该文件夹又包含名为 subfolder1 的子文件夹,则可以通过 folder1/subfolder1 来引用此文件夹。所指定的每个文件夹都必须存在。
- 强制自变量和可选自变量
-
括在圆括号 ( ) 中的自变量为强制自变量,括在方括号 [ ] 中的自变量为可选自变量。
- 省略号 (...)
-
省略号表示命令允许最后一个自变量类型有多个项。必须根据命令以空格或逗号分隔各自变量。例如:
zman server-add-bundle [选项] (服务器) (分发包) [...]
省略号表示 server-add-bundle 可以接受多个分发包。在命令级帮助中,为明确起见,会以 [(分发包) (分发包) ... (分发包)] 的形式提供多项自变量帮助。
最后一个自变量包含多项的所有命令还会使用 f|--folder 选项。如果自变量的所有项都在同一个文件夹中,则此选项会很有用。项的路径将根据此文件夹路径进行计算。例如:
zman server-add-bundle server1 bundlefolder/bundle1 bundlefolder/bundle2
也可以是:
zman server-add-bundle server bundle1 bundle2 --folder bundlefolder
- ZENworks 对象的路径
-
如果所需的自变量是 ZENworks 对象的路径,则必须指定相对于该对象根文件夹的路径,并使用正斜杠 (/) 分隔,除非命令帮助中指定要输入绝对路径。例如:
zman server-add-bundle serverfolder/server bundlefolder/bundle1
其中,自变量的绝对路径为:
/devices/servers/serverfolder/server 和 /bundles/bundlefolder/bundle1
- 将对象导出到文件
-
您可以使用 bundle-export-to-file、policy-export-to-file 和 settings-export-to-file 等 zman 命令,分别将分发包、策略和设置定义导出到 XML 格式的特定文件中。该文件使用指定的名称和文件扩展名创建。如果未指定文件扩展名,默认将添加 .XML 扩展名。您可以使用这些文件来创建分发包、策略和设置。
zman 服务
现在,您可以将 zman 作为一项服务运行。将 zman 当作服务运行可以在服务模式下执行 zman 命令,缩短命令的执行时间。
zman 服务命令属于外壳类别,使用语法如下:
- zman shell-start-as-service (ssas) [选项]
-
启动 zman 服务。
接受下列选项:
- -s 或 --servicePort:指定 zman 服务运行时所用的端口。默认端口为 2020
-
zman shell-stop-service (sss)
-
停止 zman 服务。
-
zman shell-status (ssts)
-
显示 zman 服务状态。
要将 zman 命令作为一项服务运行,您必须执行以下操作:
-
在启动 zman 服务之前,先运行 zman admin-store-credential(asc) 命令保存身份凭证。zman 服务会使用保存的身份凭证以服务模式运行 zman 命令。
-
如果您选择以服务模式运行任何需要文件路径的 zman 命令,则必须指定完整的文件路径,而不是相对文件路径。默认情况下,工作目录会初始化到启动 zman 服务的位置。
-
如果您将 zman 作为一项服务运行,请确保在服务器上完成系统更新后重启动该服务。
以下 zman 命令会以单独的进程运行(即便 zman 服务在正常运行):
-
zman shell-stop-service(sss)
-
zman admin-create(ac)
-
zman admin-store-credential(asc)
-
zman certificate-authority-export(cae)
-
zman certificate-authority-import(cai)
-
zman zenserver-backup(zsb)
-
zman zenserver-restore(zsr)
- zman zenserver-backup(zsb) 和 zman zenserver-restore(zsr) 已弃用,请改为使用 zen-backup-restore 实用程序来备份或恢复 ZENworks 服务器。
Asset Management 命令
这些命令用于装载购买记录文件和刷新合规性引擎。它们仅适用于 ZENworks Asset Management。
-
asset-management-import-contract|amic (-f|--fileName=文件路径)
-
将合同导入文件。此命令会将需要加载器处理的导入任务排入队列。加载器随后会从该文件加载合同。
此命令采用异步方式,也就是说 zman 不会等待导入完成,而是立即返回。这是因为命令可能会运行很长一段时间。您可以查看该命令创建的日志文件来检查导入的进度。
接受下列选项:
- -f、--filename=[文件路径]:指定要导入的逗号分隔文件(.csv 或 .txt)的完整路径。
-
asset-management-load-purchase-record (amlpr)
-
装载购买记录文件。购买记录加载器会查找购买记录文件,并将其装载到主服务器的文件夹 ZENWORKS_HOME/temp/PurchaseRecordImport/uploaded 中。如果还未从 ZENworks 控制中心使用购买记录加载器,则需要创建此文件夹。
此命令采用异步方式,即 zman 不会等待命令完成,而是立即返回。这是因为命令可能会运行很长一段时间。您可以从 ZENworks 控制中心检查此进程的状态。
-
asset-management-refresh-compliance-data (amrcd)
-
运行软件合规性引擎,以刷新软件许可合规性数据。
此命令采用异步方式,即 zman 不会等待命令完成,而是立即返回。这是因为命令可能会运行很长一段时间。您可以从 ZENworks 控制中心检查此进程的状态。
审计设置命令
这些命令用于导入和导出审计配置细节。审计命令的全称以 audit- 开头,简称以字母 a 开头。以下命令接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
audit-settings-export-to-file|asetf [-s|--source=源设备或设备文件夹路径] [-a|--auditEventStatus=事件状态] [-t|--type=类型] [-e|--effective] (XML 文件路径) [<设置名称> <设置名称>... <设置名称>]
-
将针对区域、设备文件夹或设备级别的更改和代理审计事件设置导出到 XML 文件。
-s、--source=<源设备或设备文件夹路径>:必须从中导出设置的设备或设备文件夹路径(相对于 /设备)。如果未指定,则会从管理区域级别导出设置。
-a、--auditEventStatus=<事件状态>:事件状态为 enabled、disabled 或 all。默认为 all。
-t、--type=<类型>:事件类型可以是 AgentEvents、ChangeEvents 或 all。默认值为 all。
-e、--effective:如果指定该选项,将检索有效的设置,否则只会检索源路径中所定义或覆盖的设置。
(XML 文件路径):要将设置数据以 XML 格式储存到的文件。如果文件不存在,则会创建新文件。
[设置名称][...]:要导出的设置的名称。如果未指定,则会导出所有设置。如果已指定,将检索有效设置,否则只会检索源路径下已定义或已覆盖的设置。
- audit-settings-import-from-file (asiff)[选项] (XML 文件路径) [目标设备或设备文件夹路径][...]
-
从 XML 文件导入针对区域、设备文件夹或设备级别的更改和代理审计事件设置。
(XML 文件路径):包含导出的设置信息的 XML 文件。使用 audit-settings-export-to-file (asetf) 可将设置信息导出到 XML 文件。
[目标设备或设备文件夹路径][...]:要对其指定设置的设备或设备文件夹的路径(相对于 /设备)。如果未指定,则将在管理区域级别下设置。
管理员命令
这些命令用于创建和管理管理员帐户。管理员命令的全称以 admin- 开头,简称以字母 a 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
admin-clear-credential (acc)
-
使用 admin-store-credential 命令清除储存的 ZENworks 用户名和口令。每次执行完命令后都删除储存的身份凭证会比较安全,也是一个好习惯。
-
admin-create (ac) <管理员或用户> [选项]
-
创建 ZENworks 管理员帐户。
(管理员或用户):管理员名称或用户来源中某个用户的完整路径。
接受下列选项:
- -f、--fullname=[全名]:ZENworks 管理员的全名。
- -a、--assign-same-rights:赋予新管理员与执行此命令的管理员相同的权限。
命令提示您提供管理员口令,以免以明文的形式输入口令。如果管理员帐户是基于用户的,则会使用用户来源中定义的同一个身份凭证,因此命令将不会提示您提供口令。
-
admin-delete (ad) <ZENworks 管理员名称> [...]
-
删除 ZENworks 管理员帐户。
(ZENworks 管理员名称) [...]:ZENworks 管理员的名称。对象名称中可以使用通配符 *,但需要将它以引号括住。如果在删除对象时使用通配符,请务必小心。
-
admin-list (al) [选项]
-
列出所有 ZENworks 管理员帐户。
接受下列选项:
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
admin-list-roles (alr) <ZENworks 管理员名称> [选项]
-
列出指派给 ZENworks 管理员帐户的角色。
接受下列选项:
- -l、--longnames:显示权限名称。默认情况下会显示权限的简称。
-
admin-rename (ar) <ZENworks 管理员名称> (新名称)
-
重命名 ZENworks 管理员帐户。
-
admin-rights-delete (ard) <ZENworks 管理员名称> [选项] [对象路径]
-
删除指派给 ZENworks 管理员帐户的权限。
[对象路径] [...]:ZENworks 对象的完整路径,以正斜杠 (/) 开头。
接受下列选项:
- -c、--category=[权限类别]:权限所属类别的名称。要查看类别列表,请运行 zman admin-rights-set --help | more。
-
admin-rights-info (ari) <ZENworks 管理员名称> [对象路径] [选项]
-
显示指派给 ZENworks 管理员帐户的权限。
[对象路径] [...]:ZENworks 对象的完整路径,以正斜杠 (/) 开头。
接受下列选项:
- -c、--category=[权限类别]:权限所属类别的名称。要查看类别列表,请运行 zman admin-rights-set --help | more。
- -e、--effective:显示管理员的有效权限。有效权限包括从指派给管理员的角色继承的权限。如果未指定此选项,则显示直接指派给管理员的权限。
- -l、--longnames:显示权限名称。默认情况下会显示权限的简称。
注:此命令会列出指派给管理员帐户的所有权限。不过,要列出管理员组帐户的权限,则不应在命令中包含对象路径。
-
admin-rights-set (ars) <ZENworks 管理员名称> [权限类别] [对象路径] [...] [选项]
-
允许或拒绝 ZENworks 管理员帐户的权限。
[权限类别]:权限所属类别的名称。要查看类别列表,请运行 zman admin-rights-set --help | more。
[对象路径] [...]:要对其实施权限的 ZENworks 对象的完整路径,以正斜杠 (/) 开头。要查看允许的对象类型(可为其指派各权限类别中的权限)的根文件夹,请运行 zman admin-rights-modify --help | more。
接受下列选项:
- -a、--allow=[权限][...]:要允许的权限全称或简称的逗号分隔列表。要查看每个类别的权限,请运行 zman admin-rights-set --help | more。
- -A、--allow-all:允许“权限”类别的所有权限。
- -d、--deny=[权限][...]:要拒绝的权限全称或简称的逗号分隔列表。要查看每个类别的权限,请运行 zman admin-rights-set --help | more。
- -D、--deny-all:拒绝“权限”类别的所有权限。
- -f、--folder=[文件夹名]:文件夹的完整路径。如果指定此选项,对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个对象。
- -H、--help:显示有关可用权限类别的详细帮助,以及每个类别中各权限的全称和简称。如果指定了类别名称,则会为该类别提供帮助。
-
admin-store-credential (asc) <ZENworks 管理员名称>
-
储存 ZENworks 用户名和口令以配合每个命令使用,这样就无需为每个命令输入身份凭证。身份凭证存储在登录用户的主目录中,并且仅供该登录用户使用。在 Linux 中,确保用户有主目录。如果您与其他 ZENworks 管理员共享同一个计算机登录帐号,则执行完命令后,必须使用 admin-clear-credential 命令清除您的身份凭证。
指派命令
这些命令用于计算区域中所有设备的指派。指派命令的全称以 assignments- 开头,简称以字母 a 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。
-
assignments-compute-effective-assignments (area)
-
计算区域中所有受管设备的有效指派。
-
assignments-bundle-status-recompute (absr)
-
计算区域中所有受管设备的分发包指派状态。
批命令
批命令是用于执行文本文件中一系列 zman 命令的实用程序命令。由于只需要登录 ZENworks 一次,无需针对每个命令进行登录,因此这些命令的执行速度较快。批命令的全称以 batch- 开头,简称以字母 b 开头。
此命令接受“全局选项”部分列出的选项标志。此外,它还接受随该命令列出的各个选项。
-
batch-execute (bex) (文件路径) [...] [选项]
-
从批中的文本文件(不要与 Windows 批文件相混淆)执行 zman 命令。
(文件路径) [...]:包含待执行 zman 命令的文本文件的路径。以 #、rem、REM、; 和 // 开头的行被视为注释,不予处理。有关示例文件,请参见位于以下位置的 BatchExecuteCommands.txt:
接受下列选项:
- -e、--exit-on-failure:如果命令部分或全部失败,则停止执行此命令并退出。对于使用多个自变量的命令,如果其中有一个或多个自变量处理不成功,则称此命令部分失败。例如,如果系统无法找到或删除 bundle-delete 命令中的某个自变量,则称此命令部分失败。默认情况下,文件中的命令将连续执行而不会检查其中是否发生失败。
示例:
-
在多个文件中执行 zman 命令:
zman bex c:\filetxt c:\filetxt
文件会按照输入的顺序执行。
-
在多个文件中执行 zman 命令并在命令失败时退出:
zman bex /home/user1/file1 /home/user1/file2 -e
文件会按照输入的顺序执行。
分发包命令
这些命令用于创建、修改和管理分发包。分发包命令的全称以 bundle- 开头,简称以字母 b 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。这些命令只适用于 ZENworks Configuration Management。
-
bundle-add-actions (baa) (分发包路径) (操作 XML 文件) [...] [选项]
-
将操作添加到分发包。
(操作 XML 文件) [...]:包含要添加的操作信息的 XML 文件。这些操作会分到以下其中一个操作集中:分发、安装、起动、校验、卸装、终止。XML 文件中含有一个 ActionSet 元素,其中包含操作集中要添加的操作的信息。可以将多份 XML 文件指定为输入文件,以便将操作添加到分发包的不同操作集中。要创建 XML 文件,只需使用 bundle-export-actions 命令导出现有分发包的操作即可。
接受下列选项:
- -a、--actioninfo=[操作的内容和依赖项]:包含操作(有文件内容或依赖项在其他分发包上)的内容和分发包依赖性信息的 XML 文件。例如,对于安装 MSI 操作,要安装的 MSI 文件就是文件内容。安装分发包操作会将其他分发包当作依赖项。这些数据需要另外指定,才能使这些操作正常运作。有关 XML 格式模板,请参考位于以下位置的 ActionInfo.xml:
- 在 Windows 上: %ZENSERVER_HOME%\Micro Focus\Zenworks\share\zman\samples\bundles
-
在 Linux 上:
/opt/microfocus/zenworks/share/zman/samples/bundles
注:如果选择“卸装”操作集类型,则 Linux 分发包和 Linux 增补程序分发包不支持以下选项:DaysBeforeUninstallWhenNotUsed、DisplayUninstallMessage、IgnoreUninstallAfterUnassociation、IgnoreChainedDependencies 以及 AllowToCancelUninstall。
-
bundle-assign (ba) (设备类型或用户类型) (分发包或分发包组) (设备对象路径或用户对象路径) [...] [选项]
-
将分发包或分发包组指派给一个或多个设备对象或用户对象。
(设备类型或用户类型):有效值为 device、server、workstation 和 user。
(设备对象路径或用户对象路径) [...]:相对于所指定设备或用户类型根文件夹的设备对象路径或用户对象路径。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
- -I、--icon-location=[应用程序位置 XML 文件]:包含分发包应用程序图标的放置位置的 XML 文件。有关 XML 文件格式,请参考位于以下位置的 IconLocation.xml:
-
在 Windows 上:
%ZENSERVER_HOME%\micro focus\zenworks\share\zman\samples\bundles
-
在 Linux 上:
/opt/microfocus/zenworks/share/zman/samples/bundles
- -d、--distribution-schedule=[分发日程安排 XML 文件]:包含分发日程安排的 XML 文件。
- -l、--launch-schedule=[起动日程安排 XML 文件]:包含起动日程安排的 XML 文件。
- -a、--availability-schedule=[可用性日程安排 XML 文件]:包含可用性日程安排的 XML 文件。有关日程安排 XML 文件模板,请参考位于以下位置的 XML 文件:
- 在 Windows 上: %%ZENSERVER_HOME%\Micro Focus\Zenworks\share\zman\samples\ schedules
-
在 Linux 上:
/opt/microfocus/zenworks/share/zman/samples/schedules
- -i、--install-immediately:分发后立即安装分发包。要使用此选项,还必须指定分发日程安排。使用 --distribution-schedule、--distribute-now 或 --distribute-on-device-refresh 选项可以指定分发日程安排。
- -L、--launch-immediately:安装后立即起动分发包。要使用此选项,还必须指定分发日程安排。使用 --distribution-schedule、--distribute-now 或 --distribute-on-device-refresh 选项可以指定分发日程安排。
- -n、--distribute-now:将分发日程安排设置为立即分发分发包。如果指定此选项,则会忽略 --distribution-schedule 和 --distribute-on-device-refresh 选项。--distribute-now、--distribute-on-device-refresh 和 --distribution-schedule 三个选项相互排斥,均用于设置分发日程安排。会优先考虑 --distribute-now 选项,然后才是 --distribute-on-device-refresh 和 --distribution-schedule。
- -r、--distribute-on-device-refresh:将分发日程安排设置为在刷新设备时分发分发包。如果指定此选项,则会忽略 --distribution-schedule 选项。
- -s、--launch-on-device-refresh:将起动日程安排设置为在刷新设备时起动分发包。如果指定此选项,则会忽略 --launch-schedule 选项。
- -w、--wakeup-device-on-distribution:如果分发分发包时设备处于关机状态,则使用网络唤醒功能将其唤醒。要使用此选项,还必须指定分发日程安排。使用 --distribution-schedule、--distribute-now 或 --distribute-on-device-refresh 选项可以指定分发日程安排。
- -B、--broadcast=[广播地址][...]:用于广播网络唤醒魔术包的地址逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。有效值为有效的 IP 地址。
- -S、--server=[相对于 /设备的主服务器对象或代理服务器对象的路径][...]:用于唤醒设备的主服务器对象或代理服务器对象的逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。
- -C、--retries=[重试次数]:向设备发送网络唤醒魔术包的次数。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 0 和 5 之间。默认值是 1。
- -T、--timeout=[重试的时间间隔]:两次重试之间的时间间隔。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 2 和 10(分钟)之间。默认值是 2。
- -N、--app-installation-now-schedule:设置 APP 安装日程安排,以立即安装分发包。如果指定此选项,则会忽略 –app-installation-schedule 选项。
- -M –app-installation-schedule=<APP 安装日程安排 XML 文件>:包含安装日程安排的 XML 文件。有关日程安排模板的详细信息,请参见:
-
在 Windows 上
:%ZENSERVER_HOME%\Micro Focus\ZENworks\share\zman\samples\schedules
- 在 Linux 上:/opt/microfocus/zenworks/share/zman/samples/schedule
- -c、--conflicts=[分发包冲突解决顺序]:确定分发包冲突的解决方式。
- 有效值为“userprecedence”或“1”、“deviceprecedence”或“2”。如果值为“userprecedence”,会先应用与用户关联的分发包,再应用与设备关联的分发包。如果值为“deviceprecedence”,会先应用与设备关联的分发包,再应用与用户关联的分发包。如果未指定此选项,则默认值为“userprecedence”。
-
bundle-copy (bcp) (分发包路径) (分发包名称) [父文件夹] [选项]
-
复制分发包。
接受下列选项:
- -d、--desc=[说明]:分发包的说明。
- -i、--icon-file=[分发包图标文件]:要充当分发包图标的图像所在图像文件的路径。如果未指定此选项,则不会列出子文件夹的内容。
-
bundle-create (bc) (分发包名称) (分发包 XML 文件) [父文件夹] [选项]
-
创建新分发包。
(分发包 XML 文件):包含导出的分发包信息的 XML 文件。使用 bundle-export-to-file (betf) 可将现有分发包的信息导出到 XML 文件中。如果您想重新使用文件,则可以使用通过“ZENworks 控制中心”创建的分发包来创建 XML 模板文件。有关示例 XML 文件,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/bundles 目录或 Windows 服务器上安装目录 :\Micro Focus\Zenworks\share\zman\samples\bundles 目录中的 WindowsMSIBundle.xml。
接受下列选项:
- -d、--desc=[说明]:分发包的说明。
- -a、--actioninfo=[操作的内容和依赖项]:包含操作(有文件内容或依赖项在其他分发包上)的内容和分发包依赖性信息的 XML 文件。例如,对于安装 MSI 操作,要安装的 MSI 文件就是文件内容。安装分发包操作会将其他分发包当作依赖项。还需指定此数据才能使这些操作正常运作。有关 XML 格式模板,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/bundles 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\bundles 目录中的 ActionInfo.xml。
- -i、--icon-file=[分发包图标文件]:要充当分发包图标的图像所在图像文件的路径。
- -s、--create-as-sandbox=[创建为沙箱]:将分发包创建为沙箱。
- -x、--actions-as-in-xml:为新分发包创建模板 XML 文件中包含的默认操作。例如,如果您删除分发包的“校验安装”默认操作(针对“校验”操作类型),然后将分发包信息导出到一个 XML 文件中,则使用此选项将会为新分发包创建该 XML(“校验安装”默认操作不在其中)中包含的所有默认操作。如果不指定此选项,将创建一个具有所有默认操作(包括 XML 文件中未包含的“校验安装”默认操作)的分发包。
- -n、--create-with-new-guid:使用新的 GUID 创建策略对象。如果不指定该选项,命令将验证策略 XML 文件中导入的 GUID 对应的策略对象。如果导入的 GUID 不存在,将会创建新 GUID,否则,将保留导入的 GUID。
注:如果选择“卸装”操作集类型,则 Linux 分发包和 Linux 增补程序分发包不支持以下选项:DaysBeforeUninstallWhenNotUsed、DisplayUninstallMessage、IgnoreUninstallAfterUnassociation、IgnoreChainedDependencies 以及 AllowToCancelUninstall。
-
bundle-delete (bd) (分发包对象路径) [...][选项]
-
删除一个或多个分发包对象。
(分发包对象路径) [...]:相对于 /分发包的分发包对象(分发包、分发包文件夹或分发包组)路径。对象名称中可以使用通配符 *,但需要将它以引号括住。如果在删除对象时使用通配符,请务必小心。
接受下列选项:
- -r、--recursive:以递归方式删除文件夹中的对象。
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
-
bundle-delete-version (bdv) (分发包路径) [分发包版本号] [选项]
-
删除分发包的一个或多个版本。
[分发包版本号] [...]:要删除的分发包的版本。
接受下列选项:
- -a --all:删除分发包的所有旧版本。
- -p、--previous:删除早于指定版本的所有分发包版本。
示例:
删除分发包 zenbundle 的 5.0 版:
zman bdv zenbundle 5
删除分发包 zenbundle 的所有版本:
zman bdv zenbundle -a
删除分发包 zenbundle 3.0 版之前的所有版本:
zman bdv zenbundle version -p 3
-
bundle-disable (bdl) (分发包路径) [...] [选项]
-
禁用分发包。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
-
bundle-enable (bel) (分发包路径) [...] [选项]
-
启用分发包。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
-
bundle-export-actions (bea) (分发包路径) (XML 文件路径) (操作集类型) [操作的位置] [...]
-
将添加到分发包操作集的操作导出到文件。该文件可作为 bundle-add-actions 命令的输入文件。
[操作集类型]:操作集的类型。如果指定此选项,则只会列出此操作集的操作。有效值为 Install、Launch、Verify、Uninstall、Terminate 和 Preboot。
注:Linux 分发包和 Linux 增补程序分发包不支持“终止”操作集。
[操作的位置] [...]:操作集中操作位置的逗号分隔列表。第一项操作位于位置 1。使用 bundle-list-actions 命令可以查看操作集中特定操作的位置。此选项是可选的,但是如果没有指定,系统会导出指定操作集中的所有操作。
-
bundle-export-to-file (betf) (分发包路径) (XML 文件路径) [分发包版本][-c|--export-content]
-
将分发包信息以 XML 格式导出到文件中。该 XML 文件会在创建分发包时用作输入文件。
(XML 文件路径):分发包信息要导出到其中的 XML 文件的完整路径。
[分发包版本]:要导出的分发包版本。如果未指定此选项,则会考虑使用分发包的发布版本。要导出分发包的沙箱版本,请指定沙箱。
[-c|--export-content]:将分发包内容导出到 XML 文件(分发包信息将导出到其中)所在目录的子目录中。如果未指定该选项,则不会导出分发包内容。
示例:
将名为 zenbundle 的分发包的沙箱版本导出到名为 bundle.xml 的 xml 文件中:
zman betf 分发包文件夹/zenbundle C:\bundles\bundle.xml sandbox
将名为 zenbundle 的分发包的第 3 版导出到名为 bundle.xml 的 xml 文件中:
zman betf 分发包文件夹/zenbundle C:\bundles\bundle.xml 3
将名为 zenbundle 的分发包的第 5 版导出到名为 bundle.xml 的 xml 文件,并将分发包内容导出到目录 C:\bundles\bundle_content:
zman betf 分发包文件夹/zenbundle C:\bundles\bundle.xml 5 -c
-
bundle-folder-create (bfc) (文件夹名称) [父文件夹] [选项]
-
创建包含分发包的新文件夹。
接受下列选项:
-
bundle-group-add (bga) (分发包组路径) (分发包路径) [...] [选项]
-
将分发包添加到分发包组。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
-
bundle-group-create (bgc) (组名) [父文件夹] [选项]
-
创建分发包组并为其添加成员。
接受下列选项:
- --desc=[说明]:组的说明。
- -m、--members=[分发包路径][...]:相对于 /分发包的分发包路径。
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
-
bundle-group-members (bgm) (分发包组路径) [选项]
-
列出分发包组的成员。
接受下列选项:
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
bundle-group-remove (bgr) (分发包组路径) (分发包路径) [...] [选项]
-
从分发包组中去除分发包。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
-
bundle-increment-version (biv) (分发包路径) [...] [选项]
-
增加分发包版本。此命令适用于 ZENworks 11 SP1 之前的版本。在 ZENworks 11 SP1 或更高版本中,此命令已由 bundle-sandbox-publish (bsp) 命令取代
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
-
bundle-list (bl) [选项] [文件夹]
-
列出分发包对象。
接受下列选项:
- -r、--recursive:以递归方式列出结果(包括子文件夹)。如果未指定此选项,则不会列出子文件夹的内容。
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -c、--count:显示结果的计数。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
bundle-list-actions (bla) (分发包路径) [操作集类型]
-
列出添加到分发包的操作。
[操作集类型]:操作集的类型。如果指定此选项,则只会列出此操作集的操作。有效值为 Install、Launch、Verify、Uninstall、Terminate 和 Preboot。
注:Linux 分发包和 Linux 增补程序分发包不支持“终止”操作集。
-
bundle-list-assignments (blas) (分发包或分发包组) [选项]
-
列出分发包的设备和用户指派。
接受下列选项:
-t、--typefilter=[指派类型]:按指派类型过滤。有效值为 device 和 user。
-s、--scrollsize=[滚动大小]:每次显示的结果数。
-
bundle-list-groups (blg) (分发包路径) [选项]
-
列出指定分发包所属的分发包组。
接受下列选项:
-s、--scrollsize=[滚动大小]:每次显示的结果数。
示例:
列出 bundle1 所属的所有分发包组(一次显示五条结果):
zman blg bundlefolder/bundle1 -s 5
-
bundle-list-version (blv) (分发包路径)
-
列出分发包的所有版本。
示例:
列出分发包 zenbundle 的所有版本:
zman blv zenbundle
-
bundle-move (bmv) (分发包对象路径) [目标文件夹路径]
-
将分发包对象移到其他文件夹。
(分发包对象路径):分发包对象(分发包、分发包文件夹或分发包组)的路径(相对于“/分发包”)
[目标文件夹路径]:分发包对象要移到的分发包文件夹路径(相对于“/分发包”)。
-
bundle-remove-actions (bra) (分发包路径) (操作集类型) [操作的位置] [...]
-
从分发包中去除操作。
(操作集类型):包含操作的操作集类型。有效值为 Install、Launch、Verify、Uninstall、Terminate 和 Preboot。
注:Linux 分发包和 Linux 增补程序分发包不支持“终止”操作集。
[操作的位置] [...]:操作集中操作位置的逗号分隔列表。第一项操作位于位置 1。使用 bundle-list-actions 命令可以查看操作集中特定操作的位置。此选项是可选的,但是如果没有指定,系统会去除指定操作集中的所有操作。
-
bundle-rename (br) (分发包对象路径) (新名称) [选项]
-
重命名分发包对象。
(分发包对象路径):分发包对象(分发包、分发包文件夹或分发包组)的路径(相对于“/分发包”)。
(新名称):要为分发包对象指定的新名称。
- -p、--publish =[发布]:如果指定此选项并对分发包的显示名称进行编辑,便可立即发布分发包。但是,如果分发包的当前显示名称与现有分发包名称不同,或分发包的沙箱已存在,则指定此选项将无任何作用。
-
bundle-relocate-actions (brla) (分发包路径) (操作集类型) (目标操作集类型) [<操作的位置>, <操作的位置>,...,<操作的位置>]
-
将源操作集类型中的操作重定位到分发包的目标操作集类型。
- (分发包路径):分发包的路径(相对于“/分发包
- ”)。(操作集类型):包含源操作的操作集类型。有效值为 Install、Launch、Verify、Uninstall、Terminate 和 Preboot。
- [目标操作集类型]:包含目标操作的操作集类型。有效值为 Install、Launch、Verify、Uninstall、Terminate 和 Preboot。
- [操作的位置]:操作集中每个操作位置的逗号分隔列表。第一项操作位于位置 1。使用 bundle-list-actions 命令可以确定操作集中特定操作的位置。此选项是可选的,如果没有指定,系统会重定位指定的操作集中的所有操作。
- 示例:
- 将“起动”操作集中的所有操作重定位到分发包的“安装”操作集:zman brla bundlefolder/bundle1 Launch Install
- 将“安装”操作集中的前三个操作重定位到分发包的“起动”操作集:zman brla bundle1 Install Launch 1,2,3
注:Linux 分发包和 Linux 增补程序分发包不支持终止操作集。
-
bundle-reorder-actions (broa) (分发包路径) (操作集类型) (当前位置) (新位置)
-
重新排序分发包操作集中的操作。
(操作集类型):包含操作的操作集类型。有效值为 Install、Launch、Verify、Uninstall、Terminate 和 Preboot。
(当前位置):操作在操作集中的当前位置。第一项操作位于位置 1。
(新位置):操作要移到的新位置。第一项操作位于位置 1。
注:Linux 分发包和 Linux 增补程序分发包不支持“终止”操作集。
-
bundle-sandbox-create (bsc) (分发包路径) [分发包版本] [选项]
-
从分发包的现有版本创建沙箱
[分发包版本]:指定要用于创建沙箱的分发包的版本。
接受下列选项:
- -f、--force =[强制]:重写所有现有沙箱。
示例:
从分发包 zenbundle 的 2.0 版创建沙箱:
zman bsc zenbundle 2
-
bundle-sandbox-publish (bsp) (分发包路径) [选项]
-
发布沙箱以创建发布版本。
接受下列选项:
- -f、--force =[强制]:如果主分发包的依赖子分发包只有沙箱版本,则必须指定此选项才能发布同时对主分发包和依赖分发包所做的更改。如果未指定此选项,则主分发包的发布也会失败。
- -c、--allChild =[所有子项]:如果主分发包的依赖子分发包具有沙箱版本,则可以指定此选项,以发布同时对主分发包和依赖子分发包所做的更改。
- -i、--incAllParent =[提升所有父项]:如果主分发包拥有父分发包,则可以指定此选项来提升父分发包的版本,以便将新发布的主分发包更改应用到指派给父分发包的设备。
- -p、--forceParent =[强制父项]:如果主分发包拥有父分发包,并且您选择提升父分发包的版本,则必须指定此选项,才能发布已拥有沙箱版本的所有父分发包。
示例:
发布分发包 zenbundle 的沙箱版本:
zman bsp zenbundle
发布名为 zenbundle1 的分发包的沙箱版本及其所有依赖分发包:
zman bsp zenbundle1 -f -c
-
bundle-sandbox-publish-to-newbundle (bsptn) (原始分发包路径) (新分发包名称) [父文件夹] [选项]
-
将沙箱发布至新分发包。
接受下列选项:
- -s、--createAsSandbox =[创建为沙箱]:将分发包创建为沙箱。
- -g、--groups:将新创建的分发包添加到主分发包所属的所有组。
- -d、--deviceAssignments:将主分发包中的所有设备指派复制到新的分发包。
- -u、--userAssignments:将主分发包中的所有用户指派复制到新的分发包。
- -f、--force =[强制]:如果主分发包的依赖子分发包只有沙箱版本,则必须指定此选项才能发布同时对主分发包和依赖分发包所做的更改。如果未指定此选项,则主分发包的发布也会失败。
- -c、--allChild =[所有子项]:如果主分发包的依赖子分发包具有沙箱版本,则可以指定此选项,以发布同时对主分发包和依赖子分发包所做的更改。
- -i、--incAllParent =[提升所有父项]:如果主分发包拥有父分发包,则可以指定此选项来提升父分发包的版本,以便将新发布的主分发包更改应用到指派给父分发包的设备。
- -p、--forceParent =[强制父项]:如果主分发包拥有父分发包,并且您选择提升父分发包的版本,则必须指定此选项,才能发布已拥有沙箱版本的所有父分发包。
- -n、--depsToNewFolder =[将依赖分发包发布至新文件夹]:将依赖分发包作为新分发包发布到其中的分发包文件夹路径。此文件夹不应包含任何选定发布的依赖分发包,因为新分发包会使用与原始依赖分发包相同的名称发布。
示例:
将名为 zenbundle1 的分发包的沙箱版本发布为名为 zenbundle2 的新分发包:
zman bsptn zenbundle1 zenbundle2 /Bundles/Folder1
将名为 zenbundle1 的分发包的沙箱版本发布为名为 zenbundle2 的新分发包,并将 zenbundle1 的依赖分发包发布为新分发包:
zman bsptn zenbundle1 zenbundle2 /Bundles/Folder1 --depsToNewFolder=/Bundles/Folder2
-
bundle-sandbox-revert (bsr) (分发包路径)
-
删除沙箱并将其还原为分发包的最新版本。
示例:
删除分发包 zenbundle 的沙箱并将其还原为分发包的最新版本:
zman bsr zenbundle
-
bundle-unassign (bua) (设备类型或用户类型) (分发包或分发包组) (设备或用户对象路径) [...] [选项]
-
从一个或多个设备对象或用户对象解除指派分发包或分发包组。
(设备类型或用户类型):有效值为 device、server、workstation 和 user。
(设备对象路径或用户对象路径) [...]:相对于所指定设备或用户类型根文件夹的设备对象路径或用户对象路径。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
-
bundle-update-assignment (bupa) (设备类型或用户类型) (分发包或分发包组) (设备对象路径或用户对象路径) [...] [选项]
-
更新分发包或分发包组与设备对象或用户对象之间的指派。
(设备类型或用户类型):有效值为 device、server、workstation 和 user。
(设备对象路径或用户对象路径) [...]:相对于所指定设备或用户类型根文件夹的设备对象路径或用户对象路径。
接受下列选项:
- -f、--folder=[设备文件夹或用户文件夹]:相对于对应根文件夹的设备文件夹路径或用户文件夹路径。如果指定此选项,设备对象或用户对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个设备对象或用户对象。
- -I、--icon-location=[应用程序位置 XML 文件]:包含分发包应用程序图标的放置位置的 XML 文件。有关 XML 文件格式,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/bundles 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\bundles 目录中的 IconLocation.xml。
- -d、--distribution-schedule=[分发日程安排 XML 或 NoSchedule]:包含分发日程安排的 XML 文件,或 NoSchedule(如果必须去除日程安排)。
- -l、--launch-schedule=[起动日程安排 XML 文件或 NoSchedule]:包含起动日程安排的 XML 文件,或 NoSchedule(如果必须去除日程安排)。
- -a、--availability-schedule=[可用性日程安排 XML 文件或 NoSchedule]:包含可用性日程安排的 XML 文件,或 NoSchedule(如果必须去除日程安排)。有关日程安排 XML 文件模板,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/schedules 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\schedules 目录中的 XML 文件。
- -i、--install-immediately=[yes 或 no]:分发后立即安装分发包,或在分发包指派过程中去除相同的选项集。有效值为 true 或 yes 以及 false 或 no。
- -L、--launch-immediately=[yes 或 no]:安装后立即起动分发包,或在分发包指派过程中去除相同的选项集。有效值为 true 或 yes 以及 false 或 no。
- -n、--distribute-now=[yes 或 no]:将分发日程安排设置为立即分发分发包。如果指定此选项,则会忽略 --distribution-schedule 和 --distribute-on-device-refresh 选项。--distribute-now、--distribute-on-device-refresh 和 --distribution-schedule 三个选项相互排斥,均用于设置分发日程安排。会优先考虑 --distribute-now 选项,然后才是 --distribute-on-device-refresh 和 --distribution-schedule。
- -r、--distribute-on-device-refresh=[yes 或 no]:将分发日程安排设置为在设备刷新时分发分发包,或在分发包指派过程中去除相同的选项集。有效值为 true 或 yes 以及 false 或 no。如果此选项的值为 true 或 yes,则会忽略 ‑‑distribution-schedule 选项,并重写之前设置的所有分发日程安排。
- -s、--launch-on-device-refresh=[yes 或 no]:将起动日程安排设置为在设备刷新时起动分发包。如果指定此选项,则会忽略 --launch-schedule 选项。
- -w、--wakeup-device-on-distribution=[yes 或 no]:如果在分发分发包时设备处于关机状态,则使用网络唤醒功能将其唤醒,或在分发包指派过程中去除相同的选项集。有效值为 true 或 yes 以及 false 或 no。
- -B、--broadcast=[广播地址][...]:用于广播网络唤醒魔术包的地址逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。有效值为有效的 IP 地址。
- -S、--server=[相对于“/设备”的主服务器或代理服务器对象的路径][...]:用于唤醒设备的主服务器或代理服务器对象的逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。
- -C、--retries=[重试次数]:向设备发送网络唤醒魔术包的次数。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 0 和 5 之间。默认值是 1。
- -T、--timeout=[重试的时间间隔]:两次重试之间的时间间隔。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 2 和 10(分钟)之间。默认值是 2。
- -M -–app-installation-schedule=<APP 安装日程安排 XML 文件>:包含安装日程安排的 XML 文件。
- -c、--conflicts=[分发包冲突解决顺序]:确定分发包冲突的解决方式。
- 有效值为“userprecedence”或“1”、“deviceprecedence”或“2”。如果值为“userprecedence”,会先应用与用户关联的分发包,再应用与设备关联的分发包。如果值为“deviceprecedence”,会先应用与设备关联的分发包,再应用与用户关联的分发包。如果未指定此选项,则默认值为“userprecedence”。
-
bundle-view-advanced-deployment-status (bvads) (分发包路径) [选项]
-
显示分发包的高级部署状态。
接受下列选项:
- -d、--device=[设备路径]:只显示指定设备的部署状态。相对于 /设备的设备路径。
- -u、--user=[用户路径]:只显示指定用户的部署状态。相对于 /用户的用户路径。如果还指定了设备,则显示登录到指定设备的指定用户的状态细节。
- -n、--namefilter=[目标设备名称]:按设备名称过滤。显示符合指定过滤的选项。通配符 * 和 ? 可以用引号括住进行使用。
- --statusfilter=[状态类型][...]:按“分发包分发和安装事件”的状态过滤。有效值为“S”、“F”和“P”(成功、失败和待处理)。可以提供状态类型的逗号分隔列表。
- -t、--typefilter=[目标设备类型或目标用户类型][...]:按目标类型过滤。有效值为 Server、Workstation 和 User。可以提供目标类型的逗号分隔列表。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-v、--version [值]
以下值为有效值:
-
published:使用此选项可显示部署了该分发包的非测试设备数。
-
sandbox:使用此选项可显示部署了该分发包沙箱版本的测试设备数。
-
[对象的版本]:使用版本号可获取相关分发包版本的状态。
默认值为 published。
-c、--status-calculation [值]
默认值为 version。
-
bundle-view-assignment-schedule (bvas) (设备类型或用户类型) (分发包或分发包组) (设备对象路径或用户对象路径)
-
显示指派给设备对象或用户对象的分发包的部署日程安排。
(设备类型或用户类型):有效值为 device、server、workstation 和 user。
(设备对象路径或用户对象路径) [...]:要指派的分发包组相对的设备对象或用户对象的路径。
-
bundle-view-summary-totals (bvst) (分发包路径) [选项]
-
显示特定分发包部署状态的摘要。
接受下列选项:
-v、--version [值]
以下值为有效值:
-
published:使用此选项可显示部署了该分发包的非测试设备数。
-
sandbox:使用此选项可显示部署了该分发包沙箱版本的测试设备数。
-
[对象的版本]:使用版本号可获取相关分发包版本的状态。
默认值为 published。
-c、--status-calculation [值]
默认值为 version。
-
linux-export-actions (lea) (操作类型) (操作 XML 文件路径) (内容文件位置路径) [选项]
-
创建 XML 文件以导出包元数据。使用 baa 命令将导出的内容添加到服务器。
- (操作类型):指定要创建 XML 文件的操作。支持的操作类型包括安装 RPM 和分发 RPM。
- (操作 XML 文件路径):生成的操作定义 XML 文件的位置。
- (内容文件位置路径):本地计算机上 RPM 内容文件的位置。
接受下列选项:
- -t、--target:为包指定有效的 Linux 发行套件目标。
-
bundle-appdata-calculation (bac) (分发包路径或分发包 GUID) [...]
-
将一个用于计算并超速缓存分发包的应用程序数据的加载器操作排入队列,并等到操作完全执行。超速缓存的数据将用于准备 Web 服务响应及增强性能。
注:zman bac 命令仅适用于 ZENworks Patch Management 中的增补程序策略。
分发包设置命令
这些命令用于设置和修改分发包设置。设置命令的全称以 settings- 开头,简称以字母 s 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
bundle-settings-copy (bscp) (源分发包或分发包文件夹路径) (目标分发包或分发包文件夹路径) [...] [选项]
-
复制设置。
(源分发包或分发包文件夹路径):需要从中复制设置的分发包或分发包文件夹路径(相对于 /分发包)。
(目标分发包或分发包文件夹路径) [...]:必须将设置复制到其中的分发包或分发包文件夹路径(相对于 /分发包)。
接受下列选项:
- -n、--names=[设置名称][...]:要从源路径复制的设置名称。如果未指定此选项,则会复制源路径中定义的所有设置。
-
bundle-settings-export-to-file (bsetf) [选项] (XML 文件路径) [设置名称] [...]
-
将设置数据以 XML 格式导出到文件中。该 XML 文件会在创建或修改设置时用作输入文件。
(XML 文件路径):设置数据要以 XML 格式储存到其中的文件。如果文件不存在,则会创建新文件。
[设置名称] [...]:要导出的设置的名称。如果未指定此选项,则会导出所有设置。
接受下列选项:
- -s、--source=[源分发包或分发包文件夹路径]:必须从中导出设置的分发包或分发包文件夹路径(相对于 /分发包)。如果未指定此选项,则会导出“区域”中的设置。
- -e、--effective:如果指定此选项,将会检索有效设置,否则只会检索源路径下已定义或覆盖的设置。
-
bundle-settings-revert (bsrt) (源分发包或分发包文件夹路径) (设置名称) [...]
-
将设置还原为父文件夹的设置。
(源分发包或分发包文件夹路径):必须还原其设置的分发包或分发包文件夹路径(相对于 /分发包)。
-
bundle-settings-set (bss) (XML 文件路径) [目标分发包或分发包文件夹路径] [...]
-
在各个级别进行设置。
(XML 文件路径):包含导出的设置信息的 XML 文件。使用 settings-export-to-file (setf) 可将设置信息导出到 XML 文件中。
接受下列选项:
[设置名称] [...]:要导出的设置的名称。如果未指定此选项,则会导出所有设置。
- -f、--force:强制所有子项(子文件夹或单个分发包)继承这些设置。
- (zml 文件路径):包含导出的设置信息的 XML 文件。使用 bundle-setting-export-to-file (bsetf) 可将设置信息导出到 XML 文件中。
- (目标分发包或分发包文件夹路径):要对其指定设置的分发包或分发包文件夹的路径(相对于“/分发包”)。如果未指定,则将在管理区域级别下设置。
证书颁发机构命令
这些命令用于管理 ZENworks 服务器的证书授权者角色。证书颁发机构命令的全称以 certificate-authority- 开头,简称以字母 ca 开头。
-
(certificate-authority-export/cae) (文件路径) [选项]
-
将区域证书颁发机构的密钥对凭证导出到文件中,并选择性地禁用本地服务器的“证书颁发机构”角色。
接受下列选项:
- -d、--disable-CA-role:去除本地服务器的“证书授权者”角色。
-
certificate-authority-import (certificate-authority-import/cai) (文件路径)
-
从文件中导入区域证书授权者的密钥对凭证,并启用本地服务器上的“证书授权者”角色。
-
certificate-authority-role-disable (card)
-
禁用本地服务器上的“证书授权者”角色。
-
certificate-authority-role-enable (care)
-
启用本地服务器上的“证书授权者”角色。
-
certificate-authority-server (certificate-authority-server/cas)
-
显示具有“证书颁发机构”角色的服务器。
身份凭证命令
这些身份凭证命令用于管理需要向资源鉴定的特定 ZENworks 操作和任务所需的身份凭证。身份凭证命令的全称以 credentials- 开头,简称以字母 cr 开头。
-
credentials-create (crc) (身份凭证名称) [文件夹]) (--userName) [--userPassword] [--desc]
-
创建身份凭证。
接受下列选项:
- -u、[--userName=用户名]:用于访问资源的用户名。
- [--userPassword=口令]:用于访问资源的口令。
- -d、--desc:身份凭证的说明。
-
credentials-delete (crd) (身份凭证路径)
-
删除身份凭证。
-
credentials-folder-create (crf) (文件夹名) [父文件夹] [选项]
-
创建包含身份凭证的新文件夹。
接受下列选项:
-
credentials-list (crl) [文件夹]
-
列出身份凭证。
-
credentials-move (crm) (身份凭证名称) [目标文件夹路径]
-
移动身份凭证。
-
credentials-rename (crr) (身份凭证路径) (新身份凭证路径)
-
重命名身份凭证。
-
credentials-update (cru) (-u| --userName=用户名) [--userPassword=口令] [-d | --desc=说明]
-
创建身份凭证。
接受下列选项:
- -u、--user:要访问资源的用户名。
- --password:用于访问资源的口令。
- -d、--desc:身份凭证的说明。
内容命令
zman 内容命令让您不必在数据库中运行复杂的查询,即可轻松调试内容相关的问题。
-
content-create-pending-entry (ccpe) (服务器 GUID/路径)
-
针对给定服务器 GUID 或路径为数据库中缺少的内容创建待处理条目。
接受下列自变量:
示例:zman ccpe ce979ba8949c19fd4a2fe50aaad98470
其中的 ce979ba8949c19fd4a2fe50aaad98470 是服务器 GUID。
-
content-trigger-cleanup (ctc)
-
触发内容清理操作,这会从数据库中去除未参照的内容。
-
content-aco-names (can) (内容 GUID) (-s| --scrollsize)
-
为给定内容 GUID 检索可指派内容对象 (ACO) 名称。
分发包、策略和系统更新对象均称为 ACO。
接受下列自变量:
-
content-names-for-aco (cnfa) (ACO 路径) (-d | --display-alias) (-v | --version) (-s | --scrollsize)
-
为指定 ACO 路径检索内容 GUID。
接受下列自变量:
zman cnfa /分发包/bundle1 -v 1
其中,Bundle1 是分发包的名称,1 是版本号。
zman cnfa /分发包/bundle1 -v sandbox
其中,Bundle1 是分发包的名称,sandbox 是版本。
zman cnfa /策略/policy1
数据库命令
这些命令用于管理嵌入式 PostgreSQL 数据库。数据库命令的全称以 database- 开头,简称以字母 d 开头。
注:这些命令不可用于管理外部 PostgreSQL 数据库。
- database-get-credentials-audit (dgca) 和 database-get-credentials (dgc)
-
检索用于连接审计嵌入式 PostgreSQL 数据库和嵌入式 PostgreSQL 数据库的身份凭证。
-
database-get-credentials-antimalware (dgcam)
-
检索用于连接反恶意软件嵌入式 PostgreSQL 数据库的身份凭证。
-
database-get-credentials-superuser (dgcs)
-
检索用于连接到嵌入式 PostgreSQL 数据库的超级用户身份凭证。
-
database-backup (db) (backup directory)
-
备份嵌入式 PostgreSQL 数据库或备份的数据库文件所在的网络位置。
(备份目录):备份数据库文件所在的数据库服务器或网络位置上的本地目录。请确保父目录已存在,并且有足够的磁盘空间。将会重写目录中的任何现有数据库文件。
部署命令
这些命令用于执行部署任务。部署命令的全称以 deployment- 开头,简称以字母 dp 开头。
-
deployment-task-abort (dpta) (部署任务名称) [...]
-
中止部署任务。
-
deployment-task-create (dptc) (部署任务名称) (用户身份凭证文件) [IP 地址/DNS 名称] [...] [选项]
-
创建部署任务,使用 IP 地址或 DNS 名称在设备上部署 ZENworks 代理。
(用户身份凭证文件):包含用于连接设备的身份凭证的文件路径。该文件中的每行都应包含以空格分隔的用户名和口令。例如,“administrator password”。
接受下列选项:
- -f、--file=[IP 地址文件][...]:文件路径逗号分隔列表,路径中包含应在其上部署 ZENworks 代理的设备的 IP 地址或 DNS 名称。该文件可以包含逗号分隔值 (CSV) 格式的设备 IP 地址或 DNS 名称列表,也可以每行包含一个 IP 地址或 DNS 名称。
- -s、--schedule=[起动日程安排 XML 文件]:包含起动日程安排的 XML 文件。有关日程安排 XML 文件模板,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/schedules 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\schedules 目录中的 XML 文件。如果未指定日程安排文件或 --run-now 选项,该任务将不会运行。
- -r、--run-now:创建部署任务后安排其立即运行。
- -b、--reboot=[重引导选项]:指出部署代理之后设备必须于何时重引导。有效值为 immediate 和 manual。
- -d、--desc=[说明]:部署任务的说明。
- -f、--folder=[Windows 代理]:相对于 /设备的 Windows 设备路径。若要将部署管理代理从“Linux 主服务器”部署到 Microsoft Windows 设备,则需要一台运行 Microsoft Windows 的受管设备。如果是从“Windows 主服务器”运行部署任务,请忽略此选项。
- -t、--timeout=[超时]:指定“ZENworks 服务器”等待来自“Windows 代理”的响应的秒数。
- -k、--key=[注册密钥]:用于注册设备的注册密钥。
- [-a| --authorizationkey = 授权密钥] 用于对设备注册授权。
-
deployment-task-delete (dptd) (部署任务名称) [...]
-
删除部署任务。
-
deployment-task-list (dptl) [选项]
-
列出部署任务和状态。
接受下列选项:
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -c、--count:显示结果的计数。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
deployment-task-run-now (dptrn) (部署任务名称) [...]
-
安排指定的部署任务立即运行。任务的身份凭证应保存在数据存储中。
发现命令
这些命令用于查看有关设备发现的信息。发现命令的全称以 discovery- 开头,简称以字母 d 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
discovery-view-discovered-devices (dvdd) [选项]
-
列出发现的设备。
接受下列选项:
- -n、--nameFilter=[过滤字符串]:显示符合指定过滤的设备。使用通配符 * 时,需要将它们用引号括住。
- -t、--typefilter=[类型过滤]:显示符合指定类型的选项。有效值为 server、workstation、printer、network、thinclient、other、unknown 和 deployable。如果未指定此选项,则显示所有类型的设备。
- -o、--osfilter=[操作系统]:显示安装了指定 OS 的设备。有效值为 other、win9x、winnt、wince、win2k、win2k3、winxp、nw6、nw6_5、nwoes、suse、sles、nld、rh_es 和 rh_as。如果未指定此选项,则显示所有设备。
- -m、--management-status=[管理状态]:显示处于指定状态的设备。有效值为 discovered、inventoried、managed 和 retired。如果未指定此选项,则显示所有类型、所有状态的设备。
- --modefilter=[发现模式]:显示使用特定发现模式发现的设备。有效值为 IP、LDAP、csvimport、ZENworks-migration 和 ZAM-migration。如果未指定此选项,则显示所有设备。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
discovery-task-list (dtl) [选项]
-
列出发现任务和状态。
接受下列选项:
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
discovery-task-run-now (dtrn) (发现任务名称)
-
立即执行指定的发现任务。
-
discovery-import-preapproved-devices (dipd) (导入文件名)
-
导入文件中可用的设备并将设备添加到预先批准的设备列表中。
CSV 文件中应包含按以下顺序排列的列:设备类型、序列号、MAC 地址、DNS 名称、产品名、制造商、资产标记、失效天数、失效设备。
动态组命令
这些命令用于查看动态组、组成员以及刷新组。动态组命令的全称以 dynamic-group- 开头,简称以字母 dg 开头。
-
dynamic-group-list (dgl) (设备类型) [文件夹] [-n|--namefilter=过滤字符串] [-s|--scrollsize=滚动大小] [-r|--recursive] [-c|--count]
-
列出动态组。
接受下列选项:
- (设备类型):有效值为 server 和 workstation。
- [文件夹]:列出指定文件夹的内容。如果未指定,则会显示根文件夹的内容。
- [-n|--namefilter=过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- [-s|--scrollsize=滚动大小]:一次显示的结果数。
- [-r|--recursive]:以递归方式列出结果(包括子文件夹)。如果未指定,则不会列出子文件夹的内容。
- [-c|--count]:显示结果的计数。
-
dynamic-group-members (dgm) (设备类型) (动态组名称) [动态组文件夹的路径] [-s|--scrollsize=滚动大小]
-
列出指定动态组的成员。
接受下列选项:
- (设备类型):有效值为 server 和 workstation。
- (动态组名):动态组的名称。
- [动态组文件夹的路径]:动态组的路径。可以指定根文件夹的完整路径或相对路径。
- [-s|--scrollsize=滚动大小]:一次显示的结果数。
-
dynamic-group-refresh (dgr) (设备类型) [(动态组名称) (动态组名称)... (动态组名称)] [-f|--folder=包含动态组文件夹路径的文件夹名称] [-a|--all]
-
根据为动态组建立的准则重新计算该组中的成员资格。
接受下列选项:
- (设备类型):有效值为 server 和 workstation。
- (动态组名):动态组的名称。可以列出多个组。
- [-f|--folder=文件夹名称 (包括动态组文件夹的路径)]:动态组文件夹的名称(包括完整路径)。
- [-a|--all]:刷新所有现有的动态组。
-
dynamic-group-view-query (dgvq) (动态组文件夹的路径)
-
列出指定动态组的过滤器。
(动态组文件夹的路径):动态组的路径。可以指定完整路径或相对于根文件夹的路径
Endpoint Security Management 命令
这些命令用于导入和导出安全性策略,以及导出管理区域的安全性策略加密密钥 (KMK)。它们仅适用于 ZENworks Endpoint Security Management。
以下所有命令均接受全局选项部分中列出的选项标志,但 esmpolicy-export-to-file 和 esmpolicy-import 命令例外,它们不能远程运行,因此不接受 --host 选项。
-
esmpolicy-export-to-file (epetf) (策略路径) (XML 策略文件路径)
-
将安全性策略的信息导出到加密 XML 策略文件。可以使用 XML 策略文件将策略导入到相同或不同的管理区域。
注意:要导入策略,必须提供区域的安全性策略加密密钥 (KMK),这样才能解密加密的 XML 策略文件。使用 esmpolicy-export-kmk-to-file 命令可创建密钥文件。
(策略路径):相对于“策略”根文件夹的策略对象的路径(包括文件名)。例如,FWpolicy1 或 ESMpolicies/DEpolicy4。
(XML 策略路径):要保存 XML 策略文件的路径(包括文件名)。如果只指定文件名,文件会保存到当前目录。例如,firewallpolicy.xml 或 c:\firewallpolicy.xml。
示例:
zman epetf FWPolicy1 c:\FWpolicy1.xml
zman epetf ESMpolicies/DEpolicy4 DEpolicy4.xml
-
esmpolicy-export-kmk-to-file (epektf) (策略加密密钥文件路径)
-
将管理区域的安全性策略加密密钥 (KMK) 导出到文件。使用 esmpolicy-import 命令导入策略时,需要密钥文件才能解密从区域中的策略导出的 XML 策略文件。
(策略加密密钥文件路径):要保存安全性策略加密密钥 (KMK) 文件的路径(包括文件名)。如果只指定文件名,文件会保存到当前目录。请使用任何适用于该文件的文件名。扩展名并不重要,您可以使用任何扩展名或者不使用扩展名。例如,KMK.txt、key.xml、KMK 和 decryption.file 都是有效的文件名。
示例:
zman epektf c:\key.txt
zman epektf EncryptionKey.xml
-
esmpolicy-import(epi) (策略名称) (策略加密密钥文件路径) (XML 策略文件路径) [父文件夹]
-
从 esmpolicy-export-to-file 命令所创建的加密 XML 文件导入安全性策略。
(策略名称):指派给策略对象的名称。
(策略加密密钥文件路径):从中导出策略的管理区域的安全性策略加密密钥 (KMK) 文件的完整路径(包括文件名)。解密加密的 XML 文件需要此文件。如果密钥文件位于当前目录中,则只需指定文件名。
(XML 策略文件路径):加密 XML 策略文件的完整路径(包括文件名)。如果文件位于当前目录中,则只需指定文件名。
[父文件夹]:要在其中创建策略对象的“策略”文件夹。如果要在根文件夹中创建对象,请忽略此选项。
示例:
zman epi FWPolicy c:\key.txt c:\FWpolicy.xml
zman epi DEPolicy key.txt encryptionpolicy.xml esmpolicies/encryption
-
esmpolicy-purge-effective-policies (epep) [(设备路径)(设备路径)...(设备路径)] [-b|--begin-date=yyyy-MM-dd HH:mm:ss] [-e|end-date=yyyy=MM-dd HH:mm:ss] [-u|--unregisteredDevices]
-
从 ZENworks 数据库中清除有效策略报告记录。可以使用以下选项指定特定设备或特定时间段的报告记录。
[(设备路径) (设备路径) ... (设备路径)]:要清除特定设备的有效策略报告记录,请指定每个设备的完整路径。忽略此选项会清除所有设备的报告。
此命令接受以下选项:
[-b|--begin-date=yyyy-MM-dd HH:mm:ss]:要清除自特定日期开始的有效策略报告记录,请指定开始日期。时戳在开始日期当天或之后的所有记录都会清除。将此选项和 end-date 选项结合使用可指定特定的时间段。
[-e|--end-date=yyyy=MM-dd HH:mm:ss]:要清除到特定日期为止的有效策略报告记录,请指定结束日期。时戳在结束日期当天或之前的所有记录都会清除。将此选项和 begin-date 选项结合使用可指定特定的时间段。
[-u|--unregisteredDevices]:清除已在区域中取消注册但 ZENworks 数据库中仍存在其报告数据的设备的有效策略报告记录。
示例:
zman epep /Devices/Workstations/device1
zman epep /Devices/Workstations/device1 -b "2010-10-10 10:10:10" -e "2010-12-31 24:00:00"
zman epep -u
全盘加密命令
这些命令仅适用于 ZENworks Full Disk Encryption。除了下面列出的参数之外,命令还接受全局选项部分列出的选项标志。
-
fdepolicy-purge-eri (fpe) [(设备路径)(设备路径)...(设备路径)] [-b|--begin-date=yyyy-MM-dd HH:mm:ss] [-e|end-date=yyyy=MM-dd HH:mm:ss] [-u|--unregisteredDevices]
-
清除 ZENworks 数据库中的紧急恢复信息 (ERI) 记录。可以使用以下选项指定特定设备或特定时间段的目标记录。
[(设备路径) (设备路径) ... (设备路径)]:要清除特定设备的 ERI 记录,请指定每个设备的完整路径。忽略此选项会清除所有设备的记录。
[-b|--begin-date=yyyy-MM-dd HH:mm:ss]:要清除自特定日期开始的 ERI 记录,请指定开始日期。时戳在开始日期当天或之后的所有记录都会清除。将此选项和 end-date 选项结合使用可指定特定的时间段。
[-e|--end-date=yyyy=MM-dd HH:mm:ss]:要清除到特定日期为止的 ERI 记录,请指定结束日期。时戳在结束日期当天或之前的所有记录都会清除。将此选项和 begin-date 选项结合使用可指定特定的时间段。
[-u|--unregisteredDevices]:清除已在区域中取消注册但 ZENworks 数据库中仍存在其 ERI 记录的设备的 ERI 记录。
示例:
zman fpe /Devices/Workstations/device1
zman fpe /Devices/Workstations/device1 -b "2010-10-10 10:10:10" -e "2010-12-31 24:00:00"
zman fpe -u
-
fdepolicy-export-to-file (fpetf) (策略路径) (XML 策略文件路径)
-
将全盘加密策略的信息导出到加密的 XML 策略文件。可以使用 XML 策略文件将策略导入到相同或不同的管理区域。
注意:要导入策略,还必须提供区域的全盘加密策略加密密钥 (KMK),这样才能解密加密的 XML 策略文件。使用 fdepolicy-export-kmk-to-file 命令可创建密钥文件。
(策略路径):相对于“策略”根文件夹的策略对象的路径(包括文件名)。例如 FDEpolicies/FDEpolicy4。
(XML 策略路径):要保存 XML 策略文件的路径(包括文件名)。如果只指定文件名,文件会保存到当前目录。例如 FDEpolicy.xml。
示例:
zman fpetf FDEPolicy1 c:\FDEpolicy1.xml
-
fdepolicy-import (fpi) (策略名称) (策略加密密钥文件路径) (XML 策略文件路径) [父文件夹]
-
从 fdepolicy-export-to-file 命令所创建的加密 XML 文件导入全盘加密策略。
(策略名称):指派给策略对象的名称。
(策略加密密钥文件路径):从中导出策略的管理区域的全盘加密策略加密密钥 (KMK) 文件的完整路径(包括文件名)。解密加密的 XML 文件需要此文件。如果密钥文件位于当前目录中,则只需指定文件名。
(XML 策略文件路径):加密 XML 策略文件的完整路径(包括文件名)。如果文件位于当前目录中,则只需指定文件名。
[父文件夹]:要在其中创建策略对象的“策略”文件夹。如果要在根文件夹中创建对象,请忽略此选项。
示例:
zman fpi FDEPolicy c:\key.txt c:\FDEpolicy.xml
-
fdepolicy-export-kmk-to-file (fpektf) (策略加密密钥文件路径)
-
将管理区域的全盘加密策略加密密钥 (KMK) 导出到文件。使用 fdepolicy-import 命令导入策略时,需要用该密钥文件来解密从区域中的策略导出的 XML 策略文件。
(策略加密密钥文件路径):要保存全盘加密策略加密密钥 (KMK) 文件的路径(包括文件名)。如果只指定文件名,文件会保存到当前目录。请使用任何适用于该文件的文件名。扩展名并不重要,您可以使用任何扩展名或者不使用扩展名。例如,KMK.txt、key.xml、KMK 和 decryption.file 都是有效的文件名。
示例:
zman fpektf c:\key.txt
zman fpektf EncryptionKey.xml
功能命令
这些命令用于启用 ZENworks 中的特定功能。除了下面列出的参数之外,命令还接受全局选项部分列出的选项标志。
-
feature-enable-platform-ipados (fepi)...[选项]
-
此命令用于在区域中启用 iPadOS 平台。启用此平台后:
Hotlist 命令
此命令用于查看有未确认警告或错误的设备的列表。Hotlist 命令的全称以 hotlist- 开头,简称以字母 hl 开头。
此外,它还接受随该命令列出的各个选项。
-
hotlist-view (hlv) [选项]
-
列出有未确认警告或错误的设备。
接受下列选项:
- -c、--count:只显示 Hotlist 项目的计数。
- -t、--type=[错误类型]:按 Hotlist 项目的错误类型过滤。有效值为 Noncompliant、Critical 和 Warning。
- -o、--operator=[比较运算符]:如果指定此运算符,它将用于基于错误计数的过滤。有效值为“>”、“>=”、“=”、“<”和“<=”。请将这些运算符用双引号括住,以免系统将“>”和“<”视为重定向运算符。
- -e、--errorcount=[错误计数]:按指定错误类型的计数过滤。如果未指定比较运算符,默认会使用 >=。如果未指定错误类型,则以不兼容错误数、严重错误数和警告错误数之和作为计数结果。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。可以使用 messages-acknowledge 命令确认警告或错误。设备的所有警告或错误经确认后,将不再显示在 Hotlist 中。
- 示例:要查看 hotlist 中出现 5 个以上严重错误的设备,请运行以下命令:
-
zman hlv --type critical --operator ">" --error-count 5
Intel AMT 命令
这些命令用于对 Intel AMT 设备执行预配置、配置和管理操作。Intel AMT 命令的全称以 iamt- 开头,简称以字母 i 开头。
ZENworks 中支持的 iAMT 版本为 3、4、5 和 6。
-
iamt-root-certificate-hash (irch)
-
打印 ZENworks 根证书哈希。
-
iamt-create-mgmtcert (icmc) [选项]
-
在每台作为 iAMT 配置或管理服务器的主服务器中创建或导入 .DER 格式的 Intel AMT 配置或管理证书。
如果要导入的是外部证书,将接受以下选项:
- -p、--certpath:指定由外部 CA 签名的 Intel AMT 配置/管理证书的路径。证书应为 .DER 格式
例如,要导入外部证书,请运行以下命令:
zman icmc --certpath C:\Certificate.DER
-
iamt-create-csr (icc) (isCA) (类型) [选项]
-
为外部 CA 环境中的 Intel AMT 配置/管理服务器或 AMT 设备创建证书请求。
- isCA:有效值为 True 或 False。如果为 True,则证书请求会为 Intel AMT 管理区域生成证书。
- 类型:有效值为 mgmt 或 device。系统会为管理区域或管理区域中的特定设备创建证书请求。
接受下列选项:
- -c、--country=[国家/地区名称]:指定国家/地区的名称。
- -s、--state=[州名称]:指定州的名称。
- -o、--organization=[组织名称]:指定组织的名称。
- -u、--orgunit=[组织单位]:指定组织单位。
- -n、--commonname=[常用名]:指定证书的常用名。
- -d、--destination-folder=[目标文件夹]:指定要在其中复制证书签名请求文件的目标文件夹的路径。
-
iamt-clear-mgmtcert (idmc)
-
清除 Intel AMT 配置/管理证书。
-
iamt-cacert-import (icai) [isclear] [选项]
-
在服务器上导入外部 CA 或其从属 CA。
- [isclear]:有效值为 True 或 False。如果为 True,则导入的外部 CA 或其从属 CA 会被删除。
导入外部 CA 或其从属 CA 时接受以下选项:
- -i、--inform:指定证书格式是 PEM 还是 DER。
映像命令
此命令用于执行映像操作。映像命令的全称以 imaging- 开头,简称以字母 i 开头。
-
imaging-apply-assigned-imaging-bundle (iaaib) (设备类型) (设备名称)
-
应用直接指派给选定设备的最新预引导分发包。如果没有可用的直接指派,此命令将应用属于选定设备所继承指派的第一个预引导分发包。系统会在下次设备检查预引导工作时应用此分发包。
接受下列选项:
- (设备类型):有效值为 server 和 workstation。
- (设备名称):服务器或工作站对象的名称。
例如,如果要将指派的映像分发包应用到名称为 server1 的服务器,则运行以下命令:
zman iaaib server server1
如果设备对象位于某个文件夹中,请使用以下命令:
iaaib (设备类型) (设备的文件夹/路径)/(设备名称)
其中设备的文件夹/路径是设备在工作站或服务器文件夹中的相对路径。
如果一个目录中有多个工作站,并且工作站名称以常用字母字符开头(例如,dev091、dev092、...dev099),则在 Linux 服务器中使用以下命令可将指派的映像分发包同时应用到多个设备上:
zman iaaib workstation folderx/dev{09{1,2,3,4,5,6,7,9}}
分发包随即应用到 dev091、dev092 等设备。
库存命令
这些命令用于启动扫描,并将库存数据集合表单发送到受管设备。库存命令的全称以 inventory- 开头,简称以字母 i 开头。
-
inventory-collection-wizard-run-now (icwrn) (设备对象路径) [...] [选项]
-
将库存数据集合表单发送到一个或多个设备。
接受下列选项:
- -f、--folder=[设备文件夹]:相对于 /设备的设备文件夹路径。如果指定此选项,设备对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个设备对象。
- (inventory-scan-now|isn) (<设备对象路径> <设备对象路径>...<设备对象路径>) [选项]
-
启动一个或多个设备的库存扫描。
接受下列选项:
- -f、--folder=[设备文件夹]:相对于 /设备的设备文件夹路径。如果指定此选项,设备对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个设备对象。
-
inventory-export-localproducts|ielp (路径名)
-
导出管理员定义的本地产品和产品指纹。只有拥有 CDLP 权限的管理员才能导出本地产品。
导出产品数据:
zman ielp {路径名}。
示例:
将所有管理员定义的本地产品从 ZENworks Configuration Management 导出到 ./output/lpexports.txt 中的某个文件:
zman ielp ./output/lpexports.txt。
-
inventory-import-localproducts|iilp (路径名) [dokbmerge]
-
导入管理员定义的本地产品和产品指纹。只有拥有 CDLP 权限的管理员才能导入本地产品。
- dokbmerge:在导入本地产品后触发 KB 合并。
导入产品数据:
zman iilp {路径名} [-U (Administrator)] [-P (口令)]。
示例:
将管理员定义的本地产品从 ./output/lpimports.txt 中的某个文件导入到 ZENworks Configuration Management:
zman iilp ./output/lpimports.txt -U Administrator -P novell。
许可证命令
这些命令用于激活 ZENworks 服务器或显示许可信息。许可证命令的全称以 license- 开头,简称以字母 l 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
license-activate (la) (产品名) (许可证密钥)
-
激活 ZENworks 产品(Asset Inventory for Linux、ZENworks Configuration Management、ZENworks Asset Management、ZENworks Full Disk Encryption、ZENworks Endpoint Security Management)或 ZENworks Suite。
-
license-deactivate (ld) (产品名)
-
停用 ZENworks 产品。只需将产品名称用作自变量。
-
license-info (li)
-
显示许可信息。
-
license-refresh (lr)
-
强制系统刷新通常每天自动更新一次的所储存的许可超速缓存。使用此命令可随时更新超速缓存,例如在评估许可可能失效但超速缓存尚未反映出来的时候。
-
license-show-active-components (lsac)
-
列出所有已知 ZENworks Configuration Management 组件和 DataModel 插件的当前许可状态(分为两张独立的列表)。
位置命令
这些命令用于查看和管理位置。一个位置由一个或多个网络环境构成。当 ZENworks 代理确定其当前环境与某个位置所关联的网络环境匹配时,就会实施指派到该位置的所有安全性策略和最近的服务器规则。
位置命令的全称以 location- 开头,简称以字母 l 开头。以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
location-assign-device-folder (ladf) (设备文件夹或设备对象路径) [<位置对象> <位置对象>...<位置对象>] [-a|--allLocations]
-
将一个位置指派到特定的设备文件夹或设备对象。
(设备文件夹或设备对象路径):设备文件夹或设备对象的完整路径。
[位置对象] [...]:位置对象的名称。
-a、--allLocations:指定此参数可将所有位置和网络环境指派到设备文件夹或设备对象。
-
location-audit-upload (lau) (位置名称) (状态)
-
为指定的位置配置审计数据上载。
(位置名称):位置的名称。
(状态):选择状态:
-
location-create (lc) (位置名称) [-d|--desc=<说明>] [网络环境名称] [...]
-
创建一个位置,并将网络环境指派到该位置(可选)。
(位置名称):要指派给新位置的名称。
[网络环境名称]:要指派到位置的现有网络环境的名称。您可以添加多个网络环境。可以选择在创建位置的过程中添加网络环境,也可以使用 location-nwenv-assign 命令在创建位置之后添加网络环境。
[网络环境名称]:要指派到位置的现有网络环境的名称。您可以添加多个网络环境。可以选择在创建位置的过程中添加网络环境,也可以使用 location-nwenv-assign 命令在创建位置之后添加网络环境。
接受下列选项:
如果您希望此位置的设备先尝试使用 IPv4 URL 与服务器通讯,然后再尝试使用 IPv6 URL,请指定 IPv4。
如果您希望此位置的设备先尝试使用 IPv6 URL 与服务器通讯,然后再尝试使用 IPv4 URL,请指定 IPv6。
-
location-delete (ldel) (位置名称) [...]
-
删除位置。
(位置名称):要删除的位置的名称。可指定一个或多个位置名称。
-
location-delete-all-network-assignments (ldana) (位置名称)
-
从某个位置去除所有网络环境。
(位置名称):要从其中去除所有指派的网络环境的位置名称。
-
location-delete-network-assignments (ldna) (位置名称) [网络环境名称] [...]
-
从某个位置去除特定的网络环境。
(位置名称):要从其中去除网络环境的位置名称。
[网络环境名称]:要去除的网络环境的名称。可以去除多个网络环境。
-
location-list (ll) [选项]
-
列出位置。
接受下列选项:
- -c、--count:显示结果的计数。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
location-list-network-assignments (llna) (位置名称)
-
列出指派到某个位置的网络环境。
(位置名称):要查看其网络环境的位置名称。
接受下列选项:
- -c、--count:显示结果的计数。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
location-list-relationships (llrel) (位置名称) [-c count]
-
列出与指定位置关联的 ZENworks 对象,例如策略和分发包。
(位置名称):要查看其 ZENworks 对象的位置名称。
接受下列选项:
-
location-network-assign (lna) (位置名称) (网络环境名称) [...]
-
将网络环境添加到某个位置。
(位置名称):要为其指派网络环境的位置名称。
[网络环境名称]:要添加到位置的现有网络环境的名称。您可以添加多个网络环境。
-
location-rename (lrn) (旧名称) (新名称)
-
重命名位置。
(旧名称):要重命名的位置的名称。
(新名称):位置的新名称。
-
location-response-recompute|lrr [<设备文件夹或设备对象路径> <设备文件夹或设备对象路径>...<设备文件夹或设备对象路径>] [-f|--forceRecompute]
-
请求服务器重新计算位置配置响应,使请求设备可以获取最新更改。
[设备文件夹或设备对象路径][...]:指定设备文件夹或设备对象的路径。
-f、--forceRecompute:强制重新计算所有位置配置响应。
-
location-throttle (lt) (位置名称) (节流率)
-
设置将内容分发到使用指定位置识别的设备时的带宽节流率。为最大程度地发挥 ZENworks 服务器和网络系统的性能,高带宽环境可能会使用其中一组节流率,而低带宽环境可能会使用另一组节流率。可以在分发包中覆盖节流率,这样就可以快速部署优先级高的增补程序和分发包内容。
(位置名称):要为其定义带宽节流率的位置的名称。
(节流率):最大带宽率,以 KB/秒 (kbps) 为单位。
-
location-unknown-throttle (lut) (节流率)
-
设置将内容分发到使用“未知”位置识别的设备时的带宽节流率。
(节流率):最大带宽率,以 KB/秒 (kbps) 为单位。
-
location preferred protocol communication | lppc <位置名称> [选项]
-
编辑现有位置。
<位置名称>:指定位置的名称。
接受下列选项:
讯息命令
这些命令用于查看和管理讯息。讯息命令的全称以 message- 开头,简称以字母 m 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
(messages-acknowledge|ma) [对象路径] [选项]
-
确认与 ZENworks 受管设备、分发包或策略相关的讯息。
[对象路径]:有关联讯息的对象的完整路径。对象可以是服务器、工作站、分发包或策略。
接受下列选项:
- -b、--begin-date=[讯息记录日期]:确认在此日期及之后所记录的讯息。日期格式为 YYYY-MM-DD。
- --e、--end-date=[讯息记录日期]:确认在此日期及之前所记录的讯息。日期格式为 YYYY-MM-DD。
- -a、--all:确认为对象记录的所有讯息。如果未指定对象,则会确认所有记录的讯息。
- -l、--logID=[日志 ID][...]:要确认的讯息的日志 ID 逗号分隔列表。可以使用 messages-view 命令来获取日志 ID。
- -L、--logID-file=[文件路径]:包含讯息日志 ID 的文件的路径。该文件中的每行都应包含讯息日志 ID。可以使用此选项来代替 --log-ID 选项输入日志 ID。
- (messages-delete|md) [对象路径] [选项]
-
删除与 ZENworks 受管设备相关的讯息。
[对象路径]:有关联讯息的对象的完整路径。对象可以是服务器、工作站、分发包或策略。
接受下列选项:
- -b、--begin-date=[讯息记录日期]:删除在此日期及之后所记录的讯息。日期格式为 YYYY-MM-DD。
- -e、--end-date=[讯息记录日期]:删除在此日期及之前所记录的讯息。日期格式为 YYYY-MM-DD。
- -l、--logID=[日志 ID][...]:要删除的讯息的日志 ID 逗号分隔列表。可以使用 messages-view 命令来获取日志 ID。
- -L、--logID-file=[文件路径]:包含讯息日志 ID 的文件的路径。该文件中的每行都应包含讯息日志 ID。可以使用此选项来代替 --log-ID 选项输入日志 ID。
-
messages-view (mv) [选项] [对象路径]
-
列出与 ZENworks 受管设备、分发包或策略相关的讯息。
- -S、--severity=[严重性 [ ...]:按讯息严重性过滤。有效值为 critical、warning 和 info。
- -t、--type=[讯息类型]:按讯息来源过滤。有效值为 server 和 client。按服务器过滤会列出由 ZENworks 服务器生成的讯息,按客户端过滤会列出由该设备上的 ZENworks 代理生成的讯息。
- -D、--date-condition=[日期条件]:按日期范围过滤讯息。有效值为 before、since 和 between。使用 --begin-date 选项和 --end-date 选项可以指定日期。如果已使用日期条件,但未指定日期,默认会采用当前日期。
- -b、--begin-date=[讯息记录日期]:记录讯息的日期。日期格式为 YYYY-MM-DD。此选项会与日期条件选项结合使用。如果未指定日期条件,则会显示在此日期之前记录的讯息。
- -e、--end-date=[讯息记录日期]:记录讯息的日期。日期格式为 YYYY-MM-DD。如果日期条件选项值指定为 between,则需要指定此选项。
- -a、--acknowledged:按已确认的讯息过滤。
- -n、--not-acknowledged:按未确认的讯息过滤。
- -m、--messagefilter=[本地化的讯息]:按本地化的讯息过滤。
- -c、--count:只显示讯息的计数。
- -o、--sort-order=[排序顺序]:按日期、严重性和确认状态对讯息排序。
- -A、--asc:指定列表的排序方向。默认为降序。
- -d、--detailed:返回有关讯息的更多信息。
- -s、--scrollsize=[滚动大小]:一次显示的结果数。
网络环境命令
这些命令用于查看和管理网络环境。网络环境由用于标识环境的服务(网关、DNS 服务器、DHCP 服务器等)构成。
网络环境是构成位置的基础元素。当 ZENworks 代理确定其当前环境与指派给某个位置的网络环境匹配时,就会实施指派到该位置的所有安全性策略和最近的服务器规则。
网络环境命令的全称以 network-environment- 开头,简称以字母 ne 开头。以下所有命令均接受“全局选项”部分列出的标志。此外,它们还接受随每个命令列出的各个选项。
-
network-environment-audit-upload (neau) (网络环境名称) (状态)
-
为指定的网络环境配置审计数据上载设置。
(网络环境名称):网络环境的名称。
(状态):选择状态:
-
0 表示还原到为设备关联的位置所配置的审计数据上载设置。
-
1 表示允许关联网络环境中的设备将审计事件数据上载到任何从属服务器(收集角色)或主服务器。
-
2 表示禁止关联网络环境中的设备将审计事件数据上载到任何从属服务器(收集角色)或主服务器。
-
network-environment-create (nec) (网络环境名称) [-d|--desc=<说明>] [网络环境 XML 文件]
-
通过指定 XML 文件中包含的信息创建网络环境。
(网络环境名称):要指派给新网络环境的名称。
-d、--desc=<说明>:网络环境的说明。
[网络环境 XML 文件]:包含创建网络环境所需信息的 XML 文件的路径名。如果您没有 XML 文件,请使用 network-environment-export-to-file 命令导出现有网络环境的信息。然后便可使用该 XML 文件作为创建新网络环境文件的模板。
-
network-environment-delete (ned) (网络环境名称) [...]
-
删除网络环境。
(网络环境名称):要删除的网络环境的名称。可指定一个或多个名称。
-
network-environment-export-to-file (neetf) (网络环境名称) (XML 文件路径)
-
将网络环境的信息导出到 XML 格式的文件。
network-environment-create 命令要求通过 XML 格式的文件输入网络环境信息。可以用此文件作为模板,根据需要进行修改,在其中加入创建新网络环境时要使用的信息。
(网络环境名称):要将其信息导出到文件中的网络环境名称。
(XML 文件路径):导出文件的文件路径和名称。
-
network-environment-list (nel) [选项]
-
列出网络环境。
接受下列选项:
- -c、--count:显示结果的计数。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
network-environment-list-relationships (nelr) (网络环境名称) [-cr count]
-
列出与指定网络环境关联的 ZENworks 对象,例如策略和分发包。
(网络环境名称):要查看其 ZENworks 对象的网络环境的名称。
接受下列选项:
-
network-environment-rename (ner) (旧名称) (新名称)
-
重命名网络环境。
(旧名称):要重命名的网络环境的名称。
(新名称):网络环境的新名称。
-
network-environment-throttle (net) (网络环境名称) (节流率)
-
设置将内容分发到位于特定网络环境中的设备时的带宽节流率。为最大程度地发挥 ZENworks 服务器和网络系统的性能,高带宽环境可能会使用其中一组节流率,而低带宽环境可能会使用另一组节流率。可以在分发包中覆盖节流率,这样就可以快速部署优先级高的增补程序和分发包内容。
(网络环境名称):要为其定义带宽节流率的网络环境的名称。
(节流率):最大带宽率,以 KB/秒 (kbps) 为单位。
-
(network-preferred-protocol-communication | neppc) (网络环境名称) [选项]
-
创建网络环境
<网络环境名称>:指定网络环境的名称。
接受下列选项:
Micro Focus Customer Center 注册命令
此命令用于将主服务器注册到 Micro Focus Customer Center。
Micro Focus Customer Center 注册命令的全称以 ncc-register 开头,简称以 nccreg 开头。此命令接受“全局选项”部分列出的标志。此外,它还接受随该命令列出的各个选项。
-
(ncc-register|nccreg) (abc@xyz.com) (注册密钥) [主服务器路径] [-i|--nccConfigXML=ncc-config.xml] [-r|--reRegister]
-
将主服务器注册到 Micro Focus Customer Center。
(abc@xyz.com):用于将主服务器注册到 Micro Focus Customer Center 服务器的电子邮件地址。
(注册密钥):用于将主服务器注册到 Micro Focus Customer Center 服务器的注册密钥。
[主服务器路径]:注册到 Micro Focus Customer Center 服务器的主服务器的路径。
-i、--nccConfigXML=ncc-config.xml:包含产品、版本、结构和发布等注册信息的 XML 文件。
-r、--reRegister:将主服务器注册到 Micro Focus Customer Center 服务器。
示例:
要将本地主服务器注册到 Micro Focus Customer Center 服务器,请运行以下命令:
zman nccreg 电子邮件 注册密钥
要将特定的主服务器注册到 Micro Focus Customer Center 服务器,请运行以下命令:
zman nccreg 电子邮件 注册密钥 服务器路径
要将本地主服务器重新注册到 Micro Focus Customer Center 服务器,请运行以下命令:
zman nccreg 电子邮件 注册密钥 -r
要将特定的主服务器重新注册到 Micro Focus Customer Center 服务器,请运行以下命令:
zman nccreg 电子邮件 注册密钥 服务器路径 -r
移动设备命令
这些命令用于管理移动设备。移动设备命令的全称以 mobile- 开头,简称以字母 m 开头。
-
mobile-copy-relationships (mcr) (移动设备路径) (移动对象路径) [...] [选项]
-
将源移动设备的关系复制到目标移动设备。移动设备关系包括分发包指派、策略指派和组成员资格。
接受下列选项:
-r、--relationship-type:要复制的关系类型。有效值包括 bundles、policies 和 groups。bundles 选项会将源移动设备的所有关联的分发包指派复制到目标移动设备。policies 选项会将源移动设备的所有关联的策略指派复制到目标移动设备。groups 选项会将目标设备添加为源设备所属组的成员。
-a、--assignment-options:指派选项。有效值包括 、 和 。 选项会将源的指派复制到目标组的成员。 选项会将源的指派复制到目标文件夹中的设备。 选项会将源的指派复制到目标文件夹及其子文件夹中的设备。如果未指定值,则会直接为目标文件夹或组建立指派。
-c、--conflict-resolution:现有指派的冲突解决选项。有效值包括 和 。 选项会删除目标设备的所有现有指派。 选项会将目标设备的现有指派替换为选定的指派。如果未指定值,则会保留目标设备的现有指派。
-g、--group-membership:组和文件夹这两种目标对象类型的组成员资格选项。有效值包括 和 。 选项会将目标文件夹及其子文件夹中的设备添加为源设备所属组的成员。 选项会删除目标设备的现有组成员资格。如果目标包含组,则这些组的所有成员都将添加到选定组。如果目标包含文件夹,则默认情况下该文件夹中的所有设备都将以非递归方式添加到选定组。
-p、--export-path:复制关系结果需导出到的 CSV 格式文件的完整路径。您可以连同扩展名为 .csv 的文件名一起指定文件路径。如果未指定路径,CSV 文件将导出到默认路径(Linux:/var/opt/microfocus/zenworks/tmp;Windows:%zenworks_home%\work\tmp)。
-f、--continue-on-failure:此选项不是必需的。如果指定此选项,即使发生失败,复制关系操作也将继续执行。如果未指定此选项,发生失败时,复制关系操作将会终止。
例如:
要将源移动设备的所有关系复制到多种移动设备类型,请运行以下命令:
zman mobile-copy-relationships mobilefolder/sourcemobile --relationship-type=bundles,policies,groups mobilefolder/mobile mobilefolder/mobilefolder1 mobilefolder/mobilegroup
要将源移动设备的策略指派以递归方式复制到目标移动设备文件夹中的移动设备,请运行以下命令:
zman mcr mobilefolder/sourcemobile --relationship-type=policies mobilefolder1 mobilefolder2 -assignment-options=assign-to-folder-members-recursively
要在复制源移动设备的指派时替换目标移动设备的冲突分发包指派,请运行以下命令:
zman mcr mobilefolder/sourcemobile -r=bundles mobilefolder/mobile1 -conflict-resolution=replace-existing-assignments
要将目标移动设备组的移动设备添加到源移动设备的组,请运行以下命令:
zman mcr mobilefolder/sourcemobile -r=groups mobilegroup
要将目标移动设备组的移动设备添加到源移动设备的组,同时指定选项和 选项(导出到 C:\temp\ 文件夹),请运行以下命令:
zman mcr mobilefolder/sourcemobile -r=groups mobilegroup -f -p=C:\temp\
-
mobile-folder-create (mfc) (移动设备对象路径) [...] [选项]
-
创建新的移动设备文件夹。
接受下列选项:
-
mobile-group-create (mgc) (组名) [父文件夹] [选项]
-
创建移动设备组并为其添加成员。
接受下列选项:
- --desc=[说明]:组的说明。
- -m、--members=[移动设备路径][...]:相对于 /设备/移动设备的移动设备路径。
- -f、--folder=[移动设备文件夹]:相对于 /设备/移动设备的移动设备文件夹路径。如果指定此选项,移动设备对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个移动设备对象。
-
mobile-move (mmv) (移动设备对象路径) [目标文件夹路径]
-
将移动设备对象移到其他文件夹。
-
mobile-rename (mr) (移动设备对象路径) (新名称)
-
重命名移动设备对象。
-
mobile-delete (mdl) (移动设备对象路径) [...] [选项]
-
删除一个或多个移动设备对象。
(移动设备对象路径) [...]:相对于 /设备/移动设备的移动设备对象(移动设备、移动设备文件夹或移动设备组)路径。对象名称中可以使用通配符 *,但需要将它以引号括住。如果在删除对象时使用通配符,请务必小心。
接受下列选项:
- -r、--recursive:以递归方式删除文件夹中的对象。
- -f、--folder=[移动设备文件夹]:相对于 /设备/移动设备的移动设备文件夹路径。如果指定此选项,移动设备对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个移动设备对象。
-
mobile-group-add (mga) (移动设备组路径) (移动设备路径) [...] [选项]
-
将移动设备添加到移动设备组。
接受下列选项:
- -f、--folder=[移动设备文件夹]:相对于 /设备/移动设备的移动设备文件夹路径。如果指定此选项,移动设备对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个移动设备对象。
-
mobile-list (ml) [文件夹] [选项]
-
列出移动设备对象。
接受下列选项:
- -r、--recursive:以递归方式列出结果(包括子文件夹)。如果未指定此选项,则不会列出子文件夹的内容。
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -t、--typefilter=[类型过滤器][...]:显示与指定对象类型的逗号分隔列表相匹配的结果。有效值为 device、group 和 folder。
- -c、--count:显示结果的计数。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
- -f、--flagfilter=[标志过滤器][...]:显示与指定标志的逗号分隔列表相匹配的结果。有效值为 retired、notretired、test 和 non-test。
-
mobile-group-members (mgm) (移动设备组路径) [选项]
-
列出移动设备组或动态移动设备组的成员。
接受下列选项:
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
mobile-group-remove (mgr) (移动设备组路径) (移动设备路径) [...] [选项]
-
去除移动设备组中的移动设备。
接受下列选项:
- -f、--folder=[移动设备文件夹]:相对于 /设备/移动设备的移动设备文件夹路径。如果指定此选项,移动设备对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个移动设备对象。
-
mobile-list-groups (mlg) (移动设备路径) [选项]
-
列出给定移动设备所属的组。
接受下列选项:
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
mobile-add-policy (map) (移动设备对象路径) (策略或策略组) [...] [选项]
-
将策略指派给移动设备对象。
接受下列选项:
- -c、--conflicts=[策略冲突解决顺序]:确定策略冲突的解决方式。有效值为 userlast 或 1、devicelast 或 2、deviceonly 或 3、useronly 或 4。使用 userlast 会先应用与设备关联的策略,然后再应用与用户关联的策略。使用 devicelast 会先应用与用户关联的策略,然后再应用与设备关联的策略。使用 deviceonly 将忽略与用户关联的策略。使用 useronly 将忽略与设备关联的策略。如果未指定此选项,默认会使用 userlast。
- -e、--enforce-now:立即对所有指派的设备实施策略。
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
mobile-remove-policy (mrp) (移动设备对象路径) (策略或策略组) [...] [选项]
-
去除指派给移动设备对象的策略。
接受下列选项:
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
mobile-list-policies (mlp) (移动设备对象路径) [选项]
-
列出指派给移动设备对象的策略。
接受下列选项:
- -a、--all:同时列出有效策略和无效策略。
- -e、--effective:只列出有效策略。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
mobile-reorder-policies (mrop) (移动设备对象路径) (当前位置) (新位置)
-
更改指派给移动设备的策略的顺序。使用 mobile-list-policies 命令可以获取所指派策略的顺序。
-
mobile-view-all-policies-status (mvaps) (移动设备路径) [选项]
-
显示指派给移动设备的策略的高级部署状态。
接受下列选项:
- --statusfilter=[状态类型][...]:按“策略应用事件”的状态过滤。有效值为“S”、“F”和“P”(成功、失败和待处理)。可以提供状态类型的逗号分隔列表。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
mobile-set-as-test (msat) (移动设备对象路径)
-
将移动设备设为测试设备。
示例:
要将 mobiledevice1 设为测试设备:
zman msat mobiledevice1
-
mobile-set-as-nontest (msan) (移动设备对象路径)
-
将移动设备设为非测试设备。
示例:
要将 mobiledevice1 设为非测试设备:
zman msan mobiledevice1
-
mobile-refresh (mrf) (移动设备对象路径) [...] [选项]
-
刷新移动设备。
接受下列选项:
-f、--folder=[移动设备文件夹]:相对于 /设备/移动设备的移动设备文件夹路径。如果指定此选项,移动设备对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个移动设备。
--notify=<分钟数>:通知所有设备的分钟数。
--expire=<分钟数>:快速任务创建后到失效前的分钟数。指定 0 会立即失效。
--expirenever:快速任务在主服务器中从不失效。
-
mobile-activationlockbypass-export-to-file (malbetf) [文件名]
-
将该区域中所有受监控 iOS 设备的激活锁定绕过代码导出到 ZIP 文件中。
[文件名] 指定应用于保存绕过代码的 ZIP 文件的文件名。这是一个可选字段。
执行命令后,系统将提示您输入口令。
ZIP 文件会保存在当前的命令提示符目录中。
只有超级管理员有权执行该命令。
示例:malbetf lock_code
在此示例中,生成的 ZIP 文件将以 lock_code 的名称保存。文件名是可选字段。执行命令后,系统将提示您输入口令。
-
mobile-frpaccount-export-to-file|mfetf (ZIP 文件路径)
-
将恢复出厂设置保护 (FRP) 细节导出到 CSV 文件(这些细节是有权在硬恢复出厂设置后配置设备的用户的公司帐户细节),然后合并这些文件以创建 ZIP 档案文件。
(ZIP 文件路径)指定应将包含 CSV 文件的 ZIP 档案所保存到位置的完整路径。
示例:
zman mfetf C:\frpbackup\frpaccounts.zip
导出包含 FRP 细节的 CSV 文件,并在路径 C:\frpbackup 下创建名称为 frpaccounts.zip 的 ZIP 档案文件。
-
mobile-frpaccount-purge-records|mfpr
-
从 ZENworks 数据库中清除所有已删除设备的恢复出厂设置保护 (FRP) 细节。
对象命令
这些是在 ZENworks 对象上进行操作的有效且方便的命令。对象命令的全称以 object- 开头,简称以字母 o 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
object-get-GUID (ogg) (对象路径)
-
获取 ZENworks 对象的 GUID。
(对象路径):ZENworks 对象的完整路径,以正斜杠 (/) 开头。
-
object-get-name (ogn) (ZENworks GUID)
-
获取 ZENworks 对象的名称。
(ZENworks GUID):对象的 ZENworks GUID,由 32 个字符组成。
-
object-get-path (ogp) (ZENworks GUID)
-
根据指定 GUID 获取 ZENworks 对象的路径。
(ZENworks GUID):对象的 ZENworks GUID,由 32 个字符组成。
主服务器命令
这些命令用于管理主服务器上的内容。主服务器命令以 primary-server- 开头。
- primary-server-replicate-content (psrc) (分发包路径 | 策略路径)
-
复制主服务器上的指定分发包或策略的内容。
示例:
将分发包的内容复制到当前服务器:zman psrc /Bundle/bundle1
将策略的内容复制到当前服务器:zman psrc /Policy/policy1
- primary-server-cleanup-content (pscc) (分发包) (分发包路径 | 策略路径)
-
清理主服务器上的指定分发包/策略的内容。
示例:
清理当前服务器中的分发包内容:zman pscc /Bundle/bundle1
清理当前服务器中的策略内容:zman pscc /Policy/policy1
策略命令
这些命令用于创建、修改和管理策略。策略命令的全称以 policy- 开头,简称以字母 p 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
policy-assign (pa) (设备类型或用户类型) (策略或策略组) (设备对象路径或用户对象路径) [...] [选项]
-
将策略或策略组指派给一个或多个设备对象或用户对象。
(设备类型或用户类型):有效值为 device、server、workstation 和 user。
(设备对象路径或用户对象路径) [...]:相对于所指定设备或用户类型根文件夹的设备对象路径或用户对象路径。
接受下列选项:
- -c、--conflicts=[策略冲突解决顺序]:确定策略冲突的解决方式。有效值为 userlast 或 1、devicelast 或 2、deviceonly 或 3、useronly 或 4。使用 userlast 会先应用与设备关联的策略,然后再应用与用户关联的策略。使用 devicelast 会先应用与用户关联的策略,然后再应用与设备关联的策略。使用 deviceonly 将忽略与用户关联的策略。使用 useronly 将忽略与设备关联的策略。如果未指定此选项,默认会使用 userlast。
- -e、--enforce-now:立即对所有指派的设备实施策略。
- -f、--folder=[设备文件夹或用户文件夹]:相对于对应根文件夹的设备文件夹路径或用户文件夹路径。如果指定此选项,设备对象或用户对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个设备对象或用户对象。
-
policy-create (pc) (策略名称) (策略 XML 文件) [父文件夹] [选项]
-
创建策略。
(策略 XML 文件):包含导出的策略信息的 XML 文件。使用 policy-export-to-file (petf) 可以将策略的信息导出到 XML 文件中。如果您想重新使用文件,则可以使用通过“ZENworks 控制中心”创建的策略来创建 XML 模板文件。
接受下列选项:
- -d、--desc=[说明]:策略的说明。
- -a、--actioninfo=[策略的文件内容]:XML 文件,包含要关联至策略并与其一起封装的文件内容的相关信息。例如,对于打印机策略,要安装的驱动程序文件就是文件内容。有关 XML 格式模板,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/policies 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\policies 目录中的 ActionInfo.xml。
- -s、--create-as-sandbox=[创建为沙箱]:将策略创建为沙箱。
- -n、--create-with-new-grid:用新 GUID 创建策略对象。如果不指定该选项,命令将验证策略 XML 文件中导入的 GUID 对应的策略对象。如果导入的 GUID 不存在,将会创建新 GUID,否则将保留导入的 GUID。
-
policy-copy (pcp) (策略路径) (策略名称) [父文件夹] [选项]
-
复制策略。
接受下列选项:
-
policy-delete (pd) (策略对象路径) [...] [选项]
-
删除一个或多个策略对象。
(策略对象路径) [...]:相对于 /策略的策略对象(策略、策略文件夹或策略组)路径。对象名称中可以使用通配符 *,但需要将它以引号括住。如果在删除对象时使用通配符,请务必小心。
接受下列选项:
- -r、--recursive:以递归方式删除文件夹中的对象。
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
policy-disable (pdl) (策略路径) [...] [选项]
-
禁用策略。
接受下列选项:
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
policy-delete-version (pdv) (策略路径) [要删除的策略版本] [选项]
-
删除策略的一个或多个版本。
示例:
删除策略 zenpolicy 的 3.0 版:
zman pdv zenpolicy 3
删除策略 zenpolicy 的所有版本:
zman pdv zenpolicy -a
删除早于指定版本的策略 zenpolicy 的所有版本:
zman pdv zenpolicy version -p
-
policy-enable (pel) (策略路径) [...] [选项]
-
启用策略。
接受下列选项:
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
policy-export-to-file (petf) (策略路径) (XML 文件路径) [策略版本] [-c|--export-content]
-
将策略信息以 XML 格式导出到文件中。该 XML 文件会在创建策略时用作输入文件。
(XML 文件路径):策略信息要导出到其中的 XML 文件的完整路径。
[策略版本]:要导出策略的版本。如果未指定版本,则会导出策略的发布版本。要导出策略的沙箱版本,请指定沙箱。
[-c|--export-content]:将策略内容导出到 XML 文件(策略信息将导出到其中)所在目录的子目录中。如果未指定该选项,则不会导出策略内容。
示例:
将名为 zenpolicy 的策略的沙箱版本导出到名为 policy.xml 的 XML 文件中:
zman petf policyfolder/zenpolicy C:\policies\policy.xml sandbox
将名为 zenpolicy 的策略的第 3 版导出到名为 policy.xml 的 XML 文件中:
zman petf policyfolder/zenpolicy C:\policies\policy.xml 3
将名为 zenpolicy 的策略的第 5 版导出到名为 policy.xml 的 xml 文件中,并将策略内容导出到 C:\policies\ 中,请运行:
zman petf policyfolder/zenpolicy C:\policies\policy.xml 5 -c
-
policy-folder-create (pfc) (文件夹名称) [父文件夹] [选项]
-
创建包含策略的新文件夹。
接受下列选项:
-
policy-group-add (pga) (策略组路径) (策略路径) [...] [选项]
-
将策略添加到策略组。
接受下列选项:
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
policy-group-create (pgc) (组名) [父文件夹] [选项]
-
创建策略组并为其添加成员。
接受下列选项:
- --desc=[说明]:组的说明。
- -m、--members=[策略路径][...]:相对于 /策略的策略路径。
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
policy-group-members (pgm) (策略组路径) [选项]
-
列出策略组的成员。
接受下列选项:
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
policy-group-remove (pgr) (策略组路径) (策略路径) [...] [选项]
-
从策略组中去除策略。
接受下列选项:
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
policy-list (pl) [选项] [文件夹]
-
列出策略对象。
接受下列选项:
- -r、--recursive:以递归方式列出结果(包括子文件夹)。如果未指定此选项,则不会列出子文件夹的内容。
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -c、--count:显示结果的计数。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
policy-list-assignments (plas) (策略或策略组) [选项]
-
列出策略的设备和用户指派。
接受下列选项:
- -t、--typefilter=[指派类型]:按指派类型过滤。有效值为 device 和 user。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
policy-list-groups (plg) (策略路径) [选项]
-
列出指定策略所属的组。
接受下列选项:
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
policy-list-version (plv) (策略路径)
-
列出所有策略版本。
示例:
列出策略 zenpolicy 的所有版本:
zman plv zenpolicy
-
policy-move (pmv) (策略对象路径) [目标文件夹路径]
-
将策略对象移到其他文件夹。
-
policy-sandbox-create (psc) (策略路径) [策略版本] [选项]
-
从策略的现有版本创建沙箱
[策略版本]:指定要用于创建沙箱的策略版本。
接受下列选项:
- -f、--force =[强制]:重写所有现有沙箱。
示例:
从策略 zenpolicy 的 2.0 版创建沙箱:
zman psc zenpolicy 2
-
policy-sandbox-publish (psp) (策略路径)
-
发布沙箱以创建策略的发布版本。
示例:
发布策略 zenpolicy 的沙箱
zman psp zenpolicy
-
policy-sandbox-publish-to-newpolicy (psptn) (策略路径) (策略名称) [父文件夹] [选项]
-
将策略的沙箱版本发布为新策略。
(策略路径):相对于 /策略根文件夹的策略对象的路径。
(策略名称):要创建的新策略的名称。
[父文件夹]:要在其中创建新策略的文件夹。如果不指定父文件夹,则会在根文件夹中创建策略。
接受下列选项:
- -s、--createAsSandbox=[创建为沙箱]:将策略创建为沙箱。
- -g、--groups:将新创建的策略添加到源策略所属的所有组。
- -d、--deviceAssignments:将源策略中的所有设备指派复制到新创建的策略。
- -u、--userAssignments:将源策略中的所有用户指派复制到新创建的策略。
示例:
将策略的沙箱版本发布为新策略。
zman psptn policy1 policy2 /策略/Folder1
-
policy-sandbox-revert (psr) (策略路径)
-
删除沙箱并将其还原为策略的最新发布版本。
示例:
删除沙箱并将其还原为策略的最新发布版本:
zman psr zenpolicy
-
policy-rename (pr) (策略对象路径) (新名称) [选项]
-
重命名策略对象。
- -p、--publish =[发布]:如果指定此选项并对分发包的显示名称进行编辑,便可立即发布分发包。但是,如果分发包的当前显示名称与现有分发包名称不同,或分发包的沙箱已存在,则指定此选项将无任何作用。
-
policy-unassign (pua) (设备类型或用户类型) (策略或策略组) (设备对象路径或用户对象路径) [...] [选项]
-
从一个或多个设备对象或用户对象解除指派策略或策略组。
(设备类型或用户类型):有效值为 device、server、workstation 和 user。
(设备对象路径或用户对象路径) [...]:相对于所指定设备或用户类型根文件夹的设备对象路径或用户对象路径。
接受下列选项:
- -f、--folder=[设备文件夹或用户文件夹]:相对于对应根文件夹的设备文件夹路径或用户文件夹路径。如果指定此选项,设备对象或用户对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个设备对象或用户对象。
-
policy-view-advanced-deployment-status (pvads) (策略路径) [选项]
-
显示策略的高级部署状态。
接受下列选项:
- -d、--device=[设备路径]:只显示指定设备的部署状态。相对于 /设备的设备路径。
- -u、--user=[用户路径]:只显示指定用户的部署状态。相对于 /用户的用户路径。如果还指定了设备,则显示登录到指定设备的指定用户的状态细节。
- -n、--namefilter=[目标设备名称]:按设备名称过滤。显示符合指定过滤的选项。通配符 * 和 ? 可以用引号括住进行使用。
- --statusfilter=[状态类型][...]:按“策略应用事件”的状态过滤。有效值为 S、F 和 P(表示成功、失败和待处理)。可以提供状态类型的逗号分隔列表。
- -t、--typefilter=[目标设备类型或目标用户类型][...]:按目标类型过滤。有效值为 Server、Workstation 和 User。可以提供目标类型的逗号分隔列表。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
- -v、--version [值]
- 以下值为有效值:
- published:使用此选项可显示部署了该策略的非测试设备数。
- sandbox:使用此选项可显示部署了策略沙箱版本的测试设备数。
- [对象的版本]:使用版本号可获取相关策略版本的状态。
- 默认值为 published。
- -c、--status-calculation [值]
- 以下值为有效值:
- consolidated:使用此选项可显示部署了此策略的设备总数。
- version:使用此选项可显示特定版本的状态。
- 默认值为 version。
-
policy-view-summary-totals (pvst) (策略路径) [选项]
-
显示特定策略部署状态的摘要。
接受下列选项:
-v、--version [值]
以下值为有效值:
-
published:使用此选项可显示部署了该策略的非测试设备数。
-
sandbox:使用此选项可显示部署了策略沙箱版本的测试设备数。
-
[对象的版本]:使用版本号可获取相关策略版本的状态。
默认值为 published。
-c、--status-calculation [值]
默认值为 version。
策略设置命令
这些命令用于设置和修改策略设置。设置命令的全称以 settings- 开头,简称以字母 s 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
policy-settings-copy (pscp) (策略源路径) (目标策略或策略文件夹路径) [...] [选项]
-
复制设置。
(源策略或策略文件夹路径):必须从中复制设置的策略或策略文件夹路径(相对于 /策略)。
(目标策略或策略文件夹路径) [...]:必须将设置复制到其中的策略或策略文件夹路径(相对于 /策略)。
接受下列选项:
- -n、--names=[设置名称][...]:要从源路径复制的设置名称。如果未指定此选项,则会复制源路径中定义的所有设置。
-
policy-settings-export-to-file (psetf) (XML 文件路径) [设置名称] [选项] [...]
-
将设置数据以 XML 格式导出到文件中。该 XML 文件会在创建或修改设置时用作输入文件。
(XML 文件路径):设置数据要以 XML 格式储存到其中的文件。如果文件不存在,则会创建新文件。
[设置名称] [...]:要导出的设置的名称。如果未指定此选项,则会导出所有设置。
接受下列选项:
- -s、--source=[源策略或策略文件夹路径]:必须从中导出设置的策略或策略文件夹路径(相对于 /策略)。如果未指定此选项,则会导出“区域”中的设置。
- -e、--effective:如果指定此选项,将会检索有效设置,否则只会检索源路径下已定义或覆盖的设置。
-
policy-settings-revert (psrt) (策略源路径) (设置名称) [...]
-
将设置还原为父文件夹的设置。
(源策略或策略文件夹路路径):必须还原其设置的策略或策略文件夹路径(相对于 /策略)。
-
policy-settings-set (pss) [选项] (XML 文件路径) [目标策略或策略文件夹路径] [...]
-
在各个级别进行设置。
(XML 文件路径):包含导出的设置信息的 XML 文件。使用 settings-export-to-file (setf) 可将设置信息导出到 XML 文件中。
接受下列选项:
[设置名称] [...]:要导出的设置的名称。如果未指定此选项,则会导出所有设置。
- f、--force:强制所有子项(子文件夹和单个策略)继承这些设置。
- -s、--source=[源策略或策略文件夹路径]:必须设定其设置的策略或策略文件夹路径(相对于 /策略)。如果未指定此选项,则会在“区域”级别进行设置。
查询命令
这些命令用于列出和运行已保存的搜索。查询命令的全称以 query- 开头,简称以字母 q 开头。
-
query-list-savedsearches|qls [-d|--detailed]
-
列出已保存的搜索。
接受下列选项:
- [-d、--detailed]:列出已保存搜索的过滤准则。
-
query-run-savedsearch|qrs (已保存搜索) [文件夹路径] [-r|--recursive] [-s|--scrollsize=滚动大小]
-
运行已保存的搜索。
接受下列选项:
- (已保存的搜索):要执行的已保存搜索。
- [文件夹路径]:要在其中执行搜索并与 /设备相对的设备文件夹的路径。默认文件夹为 /设备。
- [-r、--recursive]:ZENworks 11 SP3 中已弃用此选项。如果您指定此选项,它将被忽略。递归值取自保存的搜索。
- [-s、--scrollsize=滚动大小]:一次显示的结果数。
队列命令
需要修改队列时,可以使用这些命令。队列可以处理异步事件(例如客户机刷新和内容清理),且在大多数情况下不需要对其进行修改。队列命令的全称以 queue- 开头,简称以字母 q 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
queue-flush (qf) (队列状态)
-
通过去除队列项清理队列。
(队列状态) [...]:按队列项的状态过滤。有效值为“N”、“I”、“C”、“S”和“F”(“新建”、“进行中”、“已取消”、“成功”和“失败”)。
-
queue-list (ql) [服务器路径] [选项]
-
列出队列项。
[服务器路径]:相对于 /设备/服务器的服务器路径。只列出属于指定服务器的队列项。
接受下列选项:
- -t、--type=[队列操作类型]:按队列项的类型过滤。例如,content.cleanup 就是一种队列项类型。
- -s、--status=[队列状态]:按队列项的状态过滤。有效值为“N”、“I”、“C”、“S”和“F”(“新建”、“进行中”、“已取消”、“成功”和“失败”)。
-
queue-reset (qr) [服务器路径]
-
重设置队列,将失败队列项的状态设为“新建”。
[服务器路径]:相对于 /设备/服务器的服务器路径。只重新设置属于指定服务器的队列项。
-
queue-exclude-servers (qes) (操作类型) [-g|--guids=<服务器 GUID>,<服务器 GUID>,...,<服务器 GUID>] [--clear]
-
更新在执行特定队列操作时应排除的主服务器的列表。此命令只能由超级管理员运行。
(操作类型):需要为其创建排除服务器列表的队列操作类型。
-g、--guids=<服务器 GUID>[...]:执行所有或特定队列操作时需要排除的主服务器 GUID 的列表。
--clear:去除为特定队列操作创建的排除服务器列表。
-
queue-exclude-servers-list (qesl) [-t|--actionType=操作类型]
-
更新在执行特定队列操作时应排除的主服务器的列表。
(操作类型):需要为其创建排除服务器列表的队列操作类型。
-t、--actionType=<操作类型>:需要为其显示排除服务器列表的队列操作类型。
注册命令
这些命令可用于创建和更改注册。它们要求指定设备类型。命令可以确定与注册密钥关联的设备文件夹和设备组的类型,从而确定注册设备的类型。注册命令的全称以 registration- 开头,简称以字母 r 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
registration-add-device-groups (radg) (设备类型) (注册密钥) (设备组路径) [...] [选项]
-
在指定的设备组中,为使用指定的注册密钥注册的设备添加成员资格。
(设备类型):注册设备的类型。有效值为 server 和 workstation。
接受下列选项:
- -f、--folder=[设备文件夹]:相对于指定设备类型的根文件夹的设备文件夹路径。如果指定此选项,设备对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个设备对象。
-
registration-create-key (rck) (设备类型) (注册密钥) [注册文件夹路径] [选项]
-
创建新的注册密钥。
(设备类型):注册设备的类型。有效值为 server 和 workstation。
接受下列选项:
- -f、--devicefolder=[设备文件夹]:相对于指定设备类型的根文件夹的设备文件夹路径。注册设备将放入此文件夹。
- -g、--devicegroup=[设备组路径][...]:设备组路径的逗号分隔列表。指定的路径应相对于指定设备类型的根文件夹。注册设备会成为这些设备组的成员。
- --desc=[说明]:注册密钥的说明。
- --site=[地点]:设备所在的地点。这些地点信息会填入注册设备。
- --dept=[部门]:使用设备的部门。这些部门信息会填入注册设备。
- --loc=[位置]:设备的物理位置。这些位置信息会填入注册设备。
- --limit=[限制]:此注册密钥可用于注册设备的次数。
-
registration-copy (rcp) (注册密钥) (新名称)
-
复制注册密钥。
(注册密钥):注册密钥的名称。
(新名称):复制的注册密钥的名称。
-
registration-delete (rd) (注册对象路径) [...] [选项]
-
删除注册对象。
(注册对象路径) [...]:相对于 /注册密钥的注册对象(注册密钥或文件夹)路径。对象名称中可以使用通配符 *,但需要将它以引号括住。如果在删除对象时使用通配符,请务必小心。
接受下列选项:
- -r、--recursive:以递归方式删除文件夹中的对象。
- -f、--folder=[注册文件夹]:相对于 /注册密钥的注册文件夹路径。如果指定此选项,注册对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个注册对象。
-
registration-folder-create (rfc) (文件夹名称) [父文件夹] [选项]
-
创建新的注册文件夹。
接受下列选项:
-
registration-info (ri) (注册密钥)
-
显示有关注册密钥的详细信息。
-
registration-list (rl) [选项] [文件夹]
-
列出所有注册对象。
接受下列选项:
- -r、--recursive:以递归方式列出结果(包括子文件夹)。如果未指定此选项,则不会列出子文件夹的内容。
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
registration-list-device-groups (rldg) (注册密钥)(rd)
-
列出与某个注册密钥相关联的设备组。
-
registration-move (rmv) (注册对象路径) [目标文件夹路径]
-
将注册对象移到其他注册文件夹。
-
registration-remove-device-groups (rrdg) (设备类型) (注册密钥) (设备组路径) [...] [选项]
-
去除设备组与注册密钥之间的关联。
(设备类型):注册设备的类型。有效值为 server 和 workstation。
接受下列选项:
- -f、--folder=[设备文件夹]:相对于指定设备类型的根文件夹的设备文件夹路径。如果指定此选项,设备对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个设备对象。
-
registration-rename (rr) (注册对象路径) (新名称)
-
重命名注册对象。
-
registration-update-key (ruk) (设备类型) (注册密钥) [选项]
-
更新注册密钥。
接受下列选项:
- -f、--devicefolder=[设备文件夹]:相对于指定设备类型的根文件夹的设备文件夹路径。注册设备将放入此文件夹。
- --desc=[说明]:注册密钥的说明。
- --site=[地点]:设备所在的地点。这些地点信息会填入注册设备。
- --dept=[部门]:使用设备的部门。这些部门信息会填入注册设备。
- --loc=[位置]:设备的物理位置。这些位置信息会填入注册设备。
- --limit=[限制]:此注册密钥可用于注册设备的次数。
- --unlimited:此注册密钥可以不限次数地用于注册设备。
-
registration-import-devices (rid) (CSV 文件路径) (注册密钥)
-
从 CSV 文件(用于指定设备信息)导入设备。
(CSV 文件路径):含路径的 CSV 文件名。文件中的每一项都包含工作站或服务器的细节。
文件中工作站或服务器项目的格式为版本、主机名、序列号及 MAC 地址。
工作站或服务器的版本为 WS_1.0。
版本和主机名的值必须提供,序列号和 MAC 地址的值则是可选的。
(注册密钥):注册密钥的名称。
例如:
要使用注册密钥 regkey 注册 CSV 文件 devicesInfo 中的设备,请运行 zman rid c:\devicesInfo.csv regkey 命令。
角色命令
这些命令用于为管理员帐户创建和管理角色,以进行基于权限的管理。角色命令的全称以 role- 开头,简称以字母 rl 开头。
-
role-add-admins (rlaa) [角色名称] [ZENworks 管理员名称] [...] [权限类别] [对象路径] [...] [选项]
-
向一个或多个 ZENworks 管理员指派角色,并将角色中的权限类别与不同的对象环境关联。
[权限类别]:权限所属类别的名称。要查看类别列表,请运行 zman role-rights-add-admins --help | more。
[对象路径][...]:应对其实施权限类别中权限的 ZENworks 对象的完整路径,以正斜杠“/”开头。要查看可与权限类别关联的对象类型的根文件夹,请运行 zman role-add-admins --help | more。
接受下列选项:
- -f、--folder=[文件夹名]:文件夹的完整路径。如果指定此选项,对象的路径便会相对于此文件夹来确定。这在指定同一文件夹下的多个对象时十分方便。
- -H、--help:显示有关可用权限的类别的详细帮助,以及可对其实施权限的对象类型的根文件夹。
-
role-create (rlc) (角色名称)
-
创建 ZENworks 管理员角色。
-
role-delete (rld) (角色名称) [...]
-
重命名 ZENworks 管理员角色。
(角色名称) [...]:角色的名称。对象名称中可以使用通配符 *,但需要将它以引号括住。使用通配符删除对象时,请务必小心。
-
role-list (rll) [选项]
-
列出所有 ZENworks 管理员角色。
接受下列选项:
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -N、--name-only:仅显示角色名称。
- -T、--name-and-type:仅显示角色名称和特权类型。
- -l、--longnames:显示权限的名称。默认情况下会显示权限的简称。
-
role-list-admins (rlla) [角色名称]
-
列出具有指定角色的 ZENworks 管理员以及与该角色权限类别关联的环境。
-
role-remove-admins (rlra) (角色名称) (ZENworks 管理员名称) [...] [权限类别] [对象路径] [...] [选项]
-
去除一个或多个 ZENworks 管理员的角色指派,或去除权限类别与对象环境的关联。
[权限类别]:权限所属类别的名称。要查看类别列表,请运行 zman role-rights-add-admins --help | more。
[对象路径] [...]:应对其实施权限类别中的权限的 ZENworks 对象的完整路径,以“/”开头。要查看可与权限类别关联的对象类型的根文件夹,请运行 zman role-add-admins --help | more。
接受下列选项:
- -f、--folder=[文件夹名]:文件夹的完整路径。如果指定此选项,对象的路径便会相对于此文件夹来确定。这在指定同一文件夹下的多个对象时十分方便。
-
role-rename (rlr) (角色名称) (新名称)
-
重命名 ZENworks 管理员角色。
-
role-rights-delete (rlrd) (角色名称) [权限类别]
-
删除指派给 ZENworks 管理员角色的权限。
[权限类别]:权限所属类别的名称。要查看类别列表,请运行 zman role-rights-set --help | more。
-
role-rights-info (rlri) (角色名称) [选项]
-
显示指派给 ZENworks 管理员角色的权限。
接受下列选项:
- -c、--category=[权限类别]:权限所属类别的名称。要查看类别列表,请运行 zman role-rights-set --help | more。
- -l、--longnames:显示权限的名称。默认情况下会显示权限的简称。
-
role-rights-set (rlrs) [角色名称] [权限类别] [选项]
-
允许或拒绝 ZENworks 管理员角色的权限。
[权限类别]:权限所属类别的名称。要查看类别列表,请运行 zman role-rights-set --help | more。
接受下列选项:
- -a、--allow=[权限][...]:要允许的权限全称或简称的逗号分隔列表。要查看每个类别的权限,请运行 zman role-rights-set --help | more。
- -A、--allow-all:允许权限类别的所有权限。
- -d、--deny=[权限][...]:要拒绝的权限全称或简称的逗号分隔列表。要查看每个类别的权限,请运行 zman role-rights-set --help | more。
- -D、--deny-all:拒绝权限类别的所有权限。
- -u、--unset=[权限][...]:要将其设为未设置的权限全称或简称的逗号分隔列表。要查看每个类别的权限,请运行 zman role-rights-set --help | more。
- -H、--help:显示有关可用权限类别的详细帮助,以及每个类别中各权限的全称和简称。如果指定了类别名称,则会在右侧提供该类别的帮助。
规则集命令
这些命令用于创建和修改注册规则集。规则集将应用到在 ZENworks 服务器上注册且没有注册密钥的新设备。命令要求指定设备类型,然后它便可确定与规则集关联的设备文件夹和设备组的类型,从而确定注册设备的类型。规则集命令的全称以 ruleset- 开头,简称以字母 rs 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
ruleset-add-device-groups (rsadg) (设备类型) (规则集名称或位置) (设备组路径) [...] [选项]
-
在指定的设备组中,为通过指定规则集导入的设备添加成员资格。
(设备类型):注册设备的类型。有效值为 server 和 workstation。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
(设备组路径):指定相对于设备类型的根文件夹的设备组路径。
接受下列选项:
- -f、--folder=[设备文件夹]:相对于指定设备类型的根文件夹的设备文件夹路径。如果指定此选项,设备对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个设备对象。
-
ruleset-add-rule (rsar) (规则集名称或位置) (添加模式) (规则组位置) (规则文件)
-
为规则集添加规则或规则组。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
(添加模式):指定添加模式,即是要添加规则还是规则组。有效值为 rule 和 rulegroup。如果模式为 rule,则将选择并添加输入文件内规则组中的的所有规则。
(规则组位置):指定规则组的位置。如果要添加的是规则组,则为新组必须插入的位置。如果要添加的是规则,则为规则组中需要添加新规则的位置。要指向最后一个规则组,请指定 last。要在新规则组中添加规则或在列表末尾添加规则组,请指定 makenew。第一个规则组位于位置 1 处。
(规则文件):包含要添加到规则集中的规则或规则组信息的 XML 文件路径。使用 ruleset-export-rules-to-file 命令导出现有规则集的规则,便可创建该 XML 文件。XML 文件中指定的连接词无关紧要。或者,您也可以只添加规则,这样旧格式将仍可使用。
有关文件格式,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/rulesets 目录或 Windows 服务器上 <安装目录>:\Micro Focus\Zenworks\share\zman\samples\rulesets 目录中的 AddRulesToRuleSet.txt。
例如:
向规则集中的位置 4 添加规则组:
zman rsar ruleset2 rulegroup 4 C:\RuleGroups.xml
向规则集的第 3 个规则组添加规则:
zman rsar ruleset2 rule 3 C:\Rules.xml
向规则集的最后一个规则组添加规则:
zman rsar ruleset2 rule last C:\Rules.xml
将规则添加为规则集中的新规则组:
zman rsar ruleset2 rule makenew C:\Rules.xml
-
ruleset-create (rsc) (设备类型) (规则集名称) (规则文件) [位置] [选项]
-
创建要在不使用注册密钥注册设备时应用的新规则集。
(设备类型):注册设备的类型。有效值为 server 和 workstation。
(规则集名称):指定规则集的名称。
(规则文件):包含新规则集的规则或规则组信息的 XML 文件路径。使用 ruleset-export-rules-to-file 命令导出现有规则集的规则,便可创建该 XML 文件。或者,您也可以只添加规则(连接词为“AND”),这样旧格式将仍可使用。
有关文件格式的示例,请参见 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/rulesets 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\rulesets 目录中的 AddRulesToRuleSet.txt 文件。
(位置):数个规则集中该规则集所在的位置。第一个规则集位于位置 1。
接受下列选项:
- -f、--devicefolder=[设备文件夹]:相对于指定设备类型的根文件夹的设备文件夹路径。注册设备将放入此文件夹。
- -g、--devicegroup=[设备组路径][...]:设备组路径的逗号分隔列表。指定的路径应相对于指定设备类型的根文件夹。注册设备将成为这些设备组的成员。
- --desc=[说明]:规则集的说明。
- --site=[地点]:设备所在的地点。这些地点信息会填入注册设备。
- --dept=[部门]:使用设备的部门。这些部门信息会填入注册设备。
- --loc=[位置]:设备的物理位置。这些位置信息会填入注册设备。
例如:
创建用于注册服务器的规则集:
zman rsc server ruleset1 C:\RuleSet1.xml --devicefolder serverfolder --desc "导入服务器的规则" --site "A 座" --dept 财务 --loc 巴西
对此规则集中定义的规则计算结果都为 true 值的所有注册设备,都会采用指定的地点、部门和位置值放在文件夹“/设备/服务器/serverfolder”中。
创建用于注册工作站(这些工作站可能会成为某些工作站组的成员)的规则集:
zman rsc workstation ruleset3 --devicegroup wsgroup,wsgroup1,wsfolder/wsgroup2
您也可以在创建规则集后,使用 ruleset-add-device-group 命令创建设备组与规则集的关联。
-
ruleset-copy (rscp) (规则集名称或位置) (新名称) [位置]
-
复制规则集。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
(新名称):指定给规则集副本的新名称。
(位置):数个规则集中该规则集所在的位置。第一个规则集位于位置 1。
例如:
将规则集复制到首位:
zman rscp ruleset3 newruleset 1
注意:如果指定的新位置为 0 或大于规则集数量,则规则集会复制到列表的开头(前一种情况)或结尾(后一种情况)。
-
ruleset-export-rules-to-file (rsertf) (规则集名称或位置) (XML 文件路径)
-
将规则集中的规则导出到文件。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
(XML 文件路径):指定将以 XML 格式储存规则的文件。
例如:
从规则集导出规则:
zman rsertf ruleset1 C:\ExportedRuleSet.xml
-
ruleset-delete (rsd) (规则集名称或位置)
-
删除规则集。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
-
ruleset-info (rsi) (规则集名称或位置)
-
显示有关规则集的详细信息。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
例如:
显示有关规则集 MyRegRule 的细节:
zman rsi MyRegRule
-
ruleset-list (rsl)
-
列出所有规则集。
-
ruleset-list-device-groups (rsldg) (规则集名称或位置)
-
列出与某个规则集相关联的设备组。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
-
ruleset-move (rsmv) (规则集名称或位置) (新位置)
-
更改规则集的位置。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
(新位置):指定规则集需要移往的新位置。
例如:
zman rsmv ruleset3 1
注意:如果指定的新位置为 0 或大于规则集数量,则规则集会相应移到列表的开头或结尾。
-
ruleset-remove-device-groups (rsrdg) (设备类型) (规则集名称或位置) (设备组路径) [...] [选项]
-
去除设备组与规则集之间的关联。
(设备类型):注册设备的类型。有效值为 server 和 workstation。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
(设备组路径):相对于指定设备类型的根文件夹的设备组路径。
接受下列选项:
- -f、--folder=[设备文件夹]:相对于指定设备类型的根文件夹的设备文件夹路径。如果指定此选项,设备对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个设备对象。
-
ruleset-remove-rule (rsrr) (规则集名称或位置) (规则位置) [...]
-
从规则集中去除规则或规则组。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
(规则位置):指定要去除的规则的位置。第一个规则组标示为 G1,G1 中的前两个规则标示为 G1:1,2。该位置可以是组,也可以是组中的特定规则。
例如:
去除规则集中的第二个规则组:
zman rsrr ruleset2 G2
去除特定的规则组以及不同规则组中特定的规则:
zman rsrr ruleset2 G1:3 G2:2,5,6 G3 G6:4,9 G8
-
ruleset-rename (rsr) (规则集名称或位置) (新名称)
-
重命名规则集。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
(新名称):指定要为规则集赋予的新名称。
-
ruleset-update (rsu) (设备类型) (规则集名称或位置) [选项]
-
更新规则集。
(设备类型):注册设备的类型。有效值为 server 和 workstation。
(规则集名称或位置):指定规则集的名称或者其在数个规则集中的位置。第一个规则集位于位置 1。
接受下列选项:
- -f、--devicefolder=[设备文件夹]:相对于指定设备类型的根文件夹的设备文件夹路径。注册设备将放入此文件夹。
- --desc=[说明]:规则集的说明。
- --site=[地点]:设备所在的地点。这些地点信息会填入注册设备。
- --dept=[部门]:使用设备的部门。这些部门信息会填入注册设备。
- --loc=[位置]:设备的物理位置。这些位置信息会填入注册设备。
例如:
更新注册服务器的规则集:
zman rsu server ruleset1 --devicefolder serverfolder1 --desc "导入服务器的规则" --site "B 座" --dept 交通运输 --loc 巴西
要修改导入的服务器所属的服务器组,请使用 ruleset-add-device-group 和 ruleset-remove-device-group 命令。
将设备文件夹从工作站文件夹更新为服务器根文件夹:
zman rsu server ruleset2
此命令可将需要放置注册设备的文件夹从“/设备/工作站”更改为“/设备/服务器”。
从属服务器命令
这些命令用于查看、创建和去除从属服务器。从属服务器命令以 satellite-server- 开头。
注:从 ZENworks 2020 版本开始,不再支持将 32 位设备提升为从属服务器角色,或者将某个角色添加到现有的 32 位从属服务器。
-
satellite-server-add-content-replication-setting (ssacrs) (设备路径) (内容类型) [-s|--scheduleFileName=文件路径] [-t|--throttleRate=节流率] [-d|--duration=持续时间] [--noSchedule]
-
satellite-server-add-imagingrole|ssaimg) (设备路径) [父主服务器] [-p|--proxydhcp=Proxy DHCP 服务] [-s|--serverPort=从属服务器端口] (-r|--Content-Replication-Schedule=从属服务器内容复制日程安排) [--force-port-change] [--force-parent-change]
-
satellite-server-create (ssc) (设备路径) ((角色),(角色),...(角色)) [父主服务器] [从属服务器端口] [从属服务器安全 HTTPS 端口] [从属服务器输出节流率] [--enable-ssl=<角色名称>,<角色名称>,...,<角色名称>] [--force-port-change] [--force-parent-change]
-
satellite-server-enable-ssl (sses) (从属服务器路径) (<角色>,<角色>,...,<角色>)
-
satellite-server-enable-ssl (sses) (-f|--fileName=文件路径) (-r|--role=<角色>,<角色>,...,<角色>)
-
satellite-server-update-joinproxy-settings (ssujs) (设备路径) [-j|--jpport=连接代理端口] [-m|--maxconnections=最大连接数] [-c|--connectionCheckInterval=连接检查间隔]
-
satellite-server-delete (ssd) (设备路径) [(角色),(角色),...(角色)][-f|--force]
-
satellite-server-configure-authentication-user-source (sscaus) (设备路径) (用户来源) [用户连接, 用户连接,...,用户连接]
-
satellite-server-edit-imagingrole (sseimg) (设备路径) (对 Proxy DHCP 服务的操作)
-
satellite-server-export-content (ssec) (设备路径) (导出目录) [选项]
-
satellite-server-export-content-replication-setting-schedule (ssecrss) (设备路径) (内容类型) (-s | --scheduleFileName = 文件路径)
-
satellite-server-list-authentication-settings (sslas) (设备路径)
-
satellite-server-list-imagingservers (sslimg)
-
satellite-server-list-content-replication-settings (sslcrs) (设备路径)
-
satellite-server-list-roles (sslr) [受管设备]
-
Satellite-server-list-servers (ssls)
-
satellite-server-remove-content-replication-setting (ssrcrs) (设备路径) (内容类型)
-
satellite-server-remove-imagingrole (ssrimg) (设备路径) [-r|--removeImageFiles]
-
satellite-server-update-content-replication-setting (ssucrs) (设备路径) (内容类型) (-s| --scheduleFileName=文件路径) [选项]
-
satellite-server-add-content-replication-setting (ssacrs) (设备路径) (内容类型) [-s|--scheduleFileName=文件路径] [-t|--throttleRate=节流率] [-d|--duration=持续时间] [--noSchedule]
-
将内容类型复制日程安排和节流设置添加到从属设备。
- (设备路径):要添加复制设置的从属设备的完整名称。
- (内容类型):其复制设置要添加到从属设备的内容类型名称。
- -s、--scheduleFileName=<文件路径>:包含复制设置日程安排数据的 XML 格式文件的完整路径。
- -t、--throttleRate=<节流率>:将复制设置添加到从属设备的节流率 (kbps)。
- -d、--duration=<持续时间>:内容复制持续时间段(以分钟为单位)。
- --noSchedule:如果不想为内容复制指定日程安排,请使用此选项。
-
satellite-server-add-imagingrole|ssaimg) (设备路径) [父主服务器] [-p|--proxydhcp=Proxy DHCP 服务] [-s|--serverPort=从属服务器端口] (-r|--Content-Replication-Schedule=从属服务器内容复制日程安排) [--force-port-change] [--force-parent-change]
-
将受管设备提升为具备“映像”服务器角色的“从属服务器”。如果受管设备已用作“从属服务器”,此命令将添加“映像”服务器角色。
接受下列选项:
- (设备路径):受管设备的相对路径(相对于 /设备)或绝对路径。
- [父主服务器]:要作为新从属服务器的父服务器的主服务器的相对路径(相对于 /设备)或绝对路径。
- -p、--proxydhcp=<ProxyDHCP 服务>:启动或停止 Proxy DHCP 服务。有效值为 start 和 stop。
- -s、--serverPort=<从属服务器端口>:从属服务器用来侦听受管设备请求的端口。如果未指定,将使用端口 80。
- -r、--Content-Replication-Schedule=<从属服务器内容复制日程安排>:包含内容复制日程安排的 XML 文件。在内容复制日程安排中输入从父主服务器更新从属服务器内容的频率(天数、小时数和分钟数)。有关 XML 格式模板,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/schedules 目录或 Windows 服务器上 <安装目录>:\Micro Focus\Zenworks\share\zman\samples\schedules 目录中的 ContentReplicationSchedule.xml。
- --force-port-change:如果受管设备已用作从属服务器,您可以使用该选项更改此设备上的所有从属服务器组件用来侦听受管设备请求的端口。
- --force-parent-change::如果受管设备已用作从属服务器,您可以使用该选项更改设备上的所有从属服务器组件的父级主服务器。
注:将受管设备提升为从属设备之前,请确保该受管设备上安装的 ZENworks 版本与主服务器上所安装的版本相同。此外,您不能将以下设备提升为从属设备:
-
安装了旧版 ZENworks 代理的受管设备。
-
ZENworks 测试设备。
-
satellite-server-create (ssc) (设备路径) ((角色),(角色),...(角色)) [父主服务器] [从属服务器端口] [从属服务器安全 HTTPS 端口] [从属服务器输出节流率] [--enable-ssl=<角色名称>,<角色名称>,...,<角色名称>] [--force-port-change] [--force-parent-change]
-
可让您配置“从属”角色。
接受下列选项:
- (设备路径):要创建为从属设备的受管设备的全名。
- (角色):要添加至受管设备的“从属”角色。角色包括鉴定、集合、内容及连接代理。如果要指派映像从属角色或将受管设备提升为含映像服务器角色的从属设备,则必须使用 zman ssaimg 命令代替此命令。如果要重新配置“连接代理”角色设置,则必须使用 zman ssujs 命令。
- [父主服务器]:“从属”设备将向其聚集集合数据或获取其内容的“主服务器”的全名。如果受管设备已经是“从属”设备,则此字段为可选字段。
- [从属服务器端口]:“从属”设备用来侦听集合聚集请求或从父“主服务器”获取内容的端口。如果未指定,则会使用端口 80。
- [从属服务器安全 HTTPS 端口]:从属服务器用于侦听鉴定安全 HTTPS 请求的端口。如果未指定,则将使用端口 443。
- [从属服务器输出节流率]:从属服务器输出节流率(以 KB/秒为单位)。
- [--enable-ssl=<角色名称>,<角色名称>,...,<角色名称>]:需要为其启用 SSL 的从属服务器角色。有效角色包括“Content”和“Collection”。
- [--force-port-change]:如果受管设备已用作“从属”设备,您可以使用此选项来更改此设备上所有“从属”组件用于侦听请求或获取内容的端口。
- [--force-parent-change]:如果受管设备已用作“从属”设备,您可以使用此选项来更改设备上所有“从属”组件的父“主服务器”。
注:将受管设备提升为从属设备之前,请确保该受管设备上安装的 ZENworks 版本与主服务器上所安装的版本相同。此外,您不能将以下设备提升为从属设备:
-
安装了旧版 ZENworks 代理的受管设备。
-
ZENworks 测试设备。
非根用户只有在已添加到 ZENworks 用户组后方可在 Linux 主服务器上成功执行此命令 (zman ssc)。要将非根用户添加到 ZENworks 用户组,请使用 usermod -A 非根用户名命令。
-
satellite-server-enable-ssl (sses) (从属服务器路径) (<角色>,<角色>,...,<角色>)
-
对所导入具有内容和/或收集角色的从属服务器的列表启用 SSL。
-f、--fileName=<文件路径>:要导入的逗号分隔值文件(.csv 或 .txt)的完整路径。文件应包含从属服务器 GUID 或从属服务器路径的列表。
-r、--role=<角色>[...]:需要启用 SSL 的从属服务器角色。有效角色包括“Content”和“Collection”。
-
satellite-server-enable-ssl (sses) (-f|--fileName=文件路径) (-r|--role=<角色>,<角色>,...,<角色>)
-
对所导入具有内容和/或收集角色的从属服务器的列表启用 SSL。
接受下列选项:
- -f、--fileName=<文件路径>:要导入的逗号分隔值文件(.csv 或 .txt)的完整路径。文件应包含从属服务器 GUID 或从属服务器路径的列表。
- 示例 GUID:422d4e7dc31506ef2c44b54a2a2fa7db
- 示例服务器路径:/Devices/Workstations/Linux-SS-01
- -r、--role=<角色>[...]:需要启用 SSL 的从属服务器角色。有效角色包括“Content”和“Collection”。
示例:zman sses|satellite-server-enable-ssl -f "satellite_server_guids.csv|satellite_server_guids.txt" -r "Content|Collection|Content,Collection"
-
satellite-server-update-joinproxy-settings (ssujs) (设备路径) [-j|--jpport=连接代理端口] [-m|--maxconnections=最大连接数] [-c|--connectionCheckInterval=连接检查间隔]
-
更新从属服务器中的“连接代理”设置。您可以只将 Windows 或 Linux 受管设备升级为“连接代理”从属角色。主服务器默认拥有“连接代理”角色。
接受下列选项:
- (设备路径):要更新“连接代理”设置的从属服务器的完整名称。
- -j、--jpport=<连接代理端口>:连接代理将用于侦听连接的端口。
- -m、--maxconnections=<最大连接数>:允许连接到连接代理的最大设备数。
- -c、--connectionCheckInterval=<连接检查间隔>:连接代理定期检查设备是否仍与其连接的时间间隔。
注:如果您不使用 ssujs 命令,连接代理从属服务器将会配置为以下默认值:
-
端口:7019
-
最大连接数:100
-
连接检查间隔:1 分钟
- satellite-server-delete (ssd) (设备路径) [(角色),(角色),...(角色)][-f|--force]
-
可让您从设备中删除“从属”角色。如果去除所有角色,则系统会自动将设备从 ZENworks 控制中心的“服务器层次”列表中删除。
如果管理区域中包含 ZENworks 主服务器和 ZENworks Configuration Management 从属服务器,则您无法从从属服务器中去除单个角色。只能将从属设备降级为受管设备。您可以删除安装了任一版本的 ZENworks 代理的从属设备。
接受下列选项:
- (设备路径):要删除其中的从属角色的从属服务器的完整名称。
- [角色]:要从设备中删除的“从属”角色。如果未指定任何角色,则会从设备中删除所有“从属”角色。您可以删除以下角色:鉴定、收集、内容及连接代理。要去除映像角色,请使用 satellite-server-remove-imagingrole (ssrimg) 命令而不是此命令。
[-f|--force]:在去除所有指定现有角色的同时,将从属服务器强制降级为受管设备。仅当从属服务器永久脱机且无法与 ZENworks 服务器通讯时,或者已去除所有角色,但由于从属服务器上的 ZENworks 版本低于主服务器上的 ZENworks 版本,因而无法从 ZCC 的“服务器层次”中去除从属服务器时,才使用此选项。
-
satellite-server-configure-authentication-user-source (sscaus) (设备路径) (用户来源) [用户连接, 用户连接,...,用户连接]
-
配置具备“鉴定”角色的从属设备所使用的用户来源连接。执行此命令会成倍增加为同一台从属设备上的多个用户来源配置连接所需的时间,并且配置时一次指定一个不同的用户来源。如果执行此命令时不指定连接,会从从属设备的鉴定角色中去除指定的用户来源。
接受下列选项:
- (设备路径):要为其配置鉴定角色用户来源的从属设备的完整名称。
- (用户来源):要配置的用户来源的名称。
- [用户连接]:按此从属设备用来针对指定用户来源鉴定用户的顺序列出的用户连接。
-
satellite-server-edit-imagingrole (sseimg) (设备路径) (对 Proxy DHCP 服务的操作)
-
启动或停止“映像从属”的 Proxy DHCP 服务。
- (设备路径):设备的相对路径(相对于 /设备/工作站)。指定的设备必须为具备“映像”角色的“从属”设备。
- (对 ProxyDHCP 服务的操作):启动或停止 Proxy DHCP 服务。有效值为 start 和 stop。
-
satellite-server-export-content (ssec) (设备路径) (导出目录) [选项]
-
从内容储存库中导出内容文件,以便手动导入到从属设备的内容储存库中。要将内容导入到受管设备上的内容储存库中,请使用 zac cdp-import-content (cic) 命令。
- (设备路径):要导出其内容文件的从属设备的完整名称。
- (导出目录):要从中导出内容文件的目录的完整路径。
接受下列选项:
- -a、--exportAll:导出指派给从属设备的所有内容(默认情况下仅导出缺少内容)。
-
satellite-server-export-content-replication-setting-schedule (ssecrss) (设备路径) (内容类型) (-s | --scheduleFileName = 文件路径)
-
将从属设备的内容类型复制日程安排导出到文件。
- (设备路径):要从中导出复制设置日程安排的从属设备的完整名称。
- (内容类型):要从从属设备中导出的复制设置的内容类型名称。
- -s、--scheduleFileName =<文件路径>:要将日程安排数据导出到的文件的完整路径。
-
satellite-server-list-authentication-settings (sslas) (设备路径)
-
列出从属设备上的鉴定角色设置。
- (设备路径):要列出其鉴定角色设置的从属设备的完整名称。
-
satellite-server-list-imagingservers (sslimg)
-
列出具备“映像”角色的“从属”设备。
-
satellite-server-list-content-replication-settings (sslcrs) (设备路径)
-
按内容类型列出从属服务器上的内容复制日程安排和节流设置。
- (设备路径):要列出其复制设置的从属设备的完整名称。
-
satellite-server-list-roles (sslr) [受管设备]
-
列出先前定义的“从属”角色。
接受下列选项:
- [受管设备]:为其列出“从属”角色的受管设备的全名。如果未指定,则会显示所有可用的“从属”角色。
-
Satellite-server-list-servers (ssls)
-
列出从属设备及其角色。
-
satellite-server-remove-content-replication-setting (ssrcrs) (设备路径) (内容类型)
-
从从属设备中去除内容类型复制日程安排和节流设置。
- (设备路径):要从中去除复制设置的从属设备的完整名称。
- (内容类型):要从从属设备中去除的复制设置的内容类型名称。
-
satellite-server-remove-imagingrole (ssrimg) (设备路径) [-r|--removeImageFiles]
-
从受管设备去除“从属映像”服务器角色。
如果管理区域中包含 ZENworks 主服务器和 ZENworks Configuration Management 从属服务器,则您无法从从属服务器中去除单个角色。只能将从属设备降级为受管设备。您可以删除安装了任一版本的 ZENworks 代理的从属设备。
- (设备路径):受管设备的相对路径(相对于 /设备/工作站)。指定的设备必须为具备“映像”角色的“从属”设备。
- -r、--removeImageFiles:从指定设备中删除映像文件。
-
satellite-server-update-content-replication-setting (ssucrs) (设备路径) (内容类型) (-s| --scheduleFileName=文件路径) [选项]
-
将内容类型复制日程安排和节流设置更新至从属设备。
- (设备路径):要更新复制设置的从属设备的完整名称。
- (内容类型):要更新至从属设备的复制设置的内容类型名称。
- -s、--scheduleFileName=(文件路径):其中的复制设置日程安排数据以 XML 格式保存的文件的完整路径。
接受下列选项:
- -d、--duration=<持续时间>:内容复制持续时间段(以分钟为单位)。
- -t、--throttleRate=<节流率>:将复制设置更新至从属设备的节流率 (kbps)。
服务器命令
这些命令用于管理服务器。服务器命令的全称以单词 server- 开头,简称以字母 s 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
server-add-bundle (sab) (服务器对象路径) (分发包或分发包组) [...] [选项]
-
将分发包指派给服务器对象。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
- -I、--icon-location=[应用程序位置 XML 文件]:包含分发包应用程序图标的放置位置的 XML 文件。有关 XML 文件格式,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/bundles 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\bundles 目录中的 IconLocation.xml。
- -d、--distribution-schedule=[分发日程安排 XML 文件]:包含分发日程安排的 XML 文件。
- -l、--launch-schedule=[起动日程安排 XML 文件]:包含起动日程安排的 XML 文件。
- -a、--availability-schedule=[可用性日程安排 XML 文件]:包含可用性日程安排的 XML 文件。有关日程安排 XML 文件模板,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/schedules 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\schedules 目录中的 XML 文件。
- -D、--dry-run:测试并显示请求的操作,但并不实际执行这些操作。
- -i、--install-immediately:分发后立即安装分发包。要使用此选项,还必须指定分发日程安排。使用 --distribution-schedule、--distribute-now 或 --distribute-on-device-refresh 选项可以指定分发日程安排。
- -L、--launch-immediately:安装后立即起动分发包。要使用此选项,还必须指定分发日程安排。使用 --distribution-schedule、--distribute-now 或 --distribute-on-device-refresh 选项可以指定分发日程安排。
- -n、--distribute-now:将分发日程安排设置为立即分发分发包。如果指定此选项,则会忽略 --distribution-schedule 和 --distribute-on-device-refresh 选项。--distribute-now、--distribute-on-device-refresh 和 --distribution-schedule 三个选项相互排斥,均用于设置分发日程安排。会优先考虑 --distribute-now 选项,然后才是 --distribute-on-device-refresh 和 --distribution-schedule。
- -r、--distribute-on-device-refresh:将分发日程安排设置为在刷新设备时分发分发包。如果指定此选项,则会忽略 --distribution-schedule 选项。
- -s、--launch-on-device-refresh:将起动日程安排设置为在刷新设备时起动分发包。如果指定此选项,则会忽略 --launch-schedule 选项。
- -w、--wakeup-device-on-distribution:如果分发分发包时设备处于关机状态,则使用网络唤醒功能将其唤醒。要使用此选项,还必须指定分发日程安排。使用 --distribution-schedule、--distribute-now 或 --distribute-on-device-refresh 选项可以指定分发日程安排。
- -B、--broadcast=[广播地址][...]:用于广播网络唤醒魔术包的地址逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。有效值为有效的 IP 地址。
- -S、--server=[相对于 /设备的主服务器对象或代理服务器对象的路径][...]:用于唤醒设备的主服务器对象或代理服务器对象的逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。
- -C、--retries=[重试次数]:向设备发送网络唤醒魔术包的次数。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 0 和 5 之间。默认值是 1。
- -T、--timeout=[重试的时间间隔]:两次重试之间的时间间隔。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 2 和 10(分钟)之间。默认值是 2。
-
server-add-certificate (sacert) (服务器对象路径) (证书文件路径)[-f]
-
在低于 ZENworks 11 SP4 的版本中,此命令用于为服务器添加新的有效证书,替换即将到期的现有证书。在 ZENworks 11 SP4 中引入 SSL 管理功能后,此命令已被弃用。
要添加数据库中缺少的证书,您可以使用此命令并带上 force(-f、--force)选项。不过,如果数据库中已存在一个活动证书,则无法使用此命令。
(服务器对象路径):相对于 /设备/服务器的服务器对象(服务器、服务器文件夹或服务器组)路径。
(证书文件路径):DER 格式的证书文件的路径。
- -f、--force:强制添加该证书作为活动证书。仅当数据库中没有活动证书时,此选项才能起作用。
-
server-add-policy (sap) (服务器对象路径) (策略或策略组) [...] [选项]
-
将策略指派给服务器对象。
接受下列选项:
- -c、--conflicts=[策略冲突解决顺序]:确定策略冲突的解决方式。有效值为 userlast 或 1、devicelast 或 2、deviceonly 或 3、useronly 或 4。使用 userlast 会先应用与设备关联的策略,然后再应用与用户关联的策略。使用 devicelast 会先应用与用户关联的策略,然后再应用与设备关联的策略。使用 deviceonly 将忽略与用户关联的策略。使用 useronly 将忽略与设备关联的策略。如果未指定此选项,默认会使用 userlast。
- -e、--enforce-now:立即对所有指派的设备实施策略。
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
server-copy-relationships (scr) (服务器路径) (服务器对象路径) [...] [选项]
-
将选定服务器的关系复制到其他服务器。服务器关系包括分发包指派、策略指派和组成员资格。
接受下列选项:
- -r、--relationship-type:要复制的关系类型。有效值为 、 和 。使用选项 会复制源设备的所有关联分发包指派。使用选项 会复制源设备的所有关联策略指派。使用选项 会将目标设备添加为与源设备关联的组的成员。您可以通过逗号分隔值提供多种类型。
- -a、--assignment-options:指派选项。有效值为 、 和 。使用选项 会将指派复制到目标组的成员。使用选项 会将指派复制到目标文件夹中的设备。 选项会将指派复制到目标文件夹及其子文件夹中的设备。如果未指定值,则会直接为目标文件夹或组建立指派。
- -c、--conflict-resolution:现有指派的冲突解决选项。有效值为 和 。使用选项 会删除目标设备的所有现有指派。使用选项 会将目标设备的现有指派替换为选定的指派。如果未指定值,则会保留目标设备的现有指派。
- -g、--group-membership:组和文件夹这两种目标对象类型的组成员资格选项。有效值为 、、 和 。使用选项 会将目标组的成员添加为源设备所属组的成员。使用选项 会将目标文件夹中的设备添加为源设备所属组的成员。使用选项 会将目标文件夹及其子文件夹中的设备添加为源设备所属组的成员。使用选项 会删除目标设备所属的现有组成员资格。
- -g、--group-membership:组和文件夹这两种目标对象类型的组成员资格选项。有效值为 和 。 选项会将目标文件夹及其子文件夹中的设备添加为源设备所属组的成员。 选项会删除目标设备的现有组成员资格。如果目标包含组,则这些组的所有成员都将添加为选定组的成员。如果目标包含文件夹,则该文件夹中的所有设备都将以非递归方式添加为选定组的成员。
- -p、--export-path:复制关系结果需导出到的 CSV 格式文件的完整路径。您可以连同扩展名为 .csv 的文件名一起指定文件路径。如果未指定路径,CSV 文件将导出到默认路径(Linux:/var/opt/microfocus/zenworks/tmp;Windows:%zenworks_home%\work\tmp)。
- -f、--continue-on-failure:此选项不是必需的。如果指定此选项,即使发生失败,复制关系操作也将继续执行。如果未指定此选项,发生失败时,复制关系操作将会终止。
示例:
要将源服务器的所有关系复制到多种服务器类型,请运行以下命令:
zman server-copy-relationships serverfolder/sourceserver --relationship-type=bundles,policies,groups serverfolder/server serverfolder/serverfolder1 serverfolder/servergroup
要以递归方式将源服务器的策略指派复制到目标服务器文件夹中的服务器,请运行:zman scr serverfolder/sourceserver --relationship-type=policies serverfolder1 serverfolder2 -assignment-options=assign-to-folder-members-recursively。
要在复制源服务器的指派时替换目标服务器的冲突分发包指派,请运行以下命令:
要将目标服务器组的服务器添加到源服务器的组,请运行:zman scr serverfolder/sourceserver -r=groups servergroup -group-membership=add-group-members。
zman scr serverfolder/sourceserver -r=bundles serverfolder/server1 -conflict-resolution=replace-existing-assignments
要将目标服务器组的服务器添加到源服务器的组,请运行以下命令:
zman scr serverfolder/sourceserver -r=groups servergroup
要将源服务器的所有关系复制到多个服务器,同时指定和 选项(导出到 C:\temp\),请运行以下命令:
zman server-copy-relationships serverfolder/sourceserver --relationship-type=bundles,policies,groups serverfolder/server serverfolder/serverfolder1 serverfolder/servergroup -f -p=C:\temp\
要将源服务器的策略指派以递归方式复制到目标文件夹中的服务器,同时指定“失败时终止”选项和 选项(导出到 C:\temp\copyresult.csv),请运行以下命令:
zman scr serverfolder/sourceserver --relationship-type=policies serverfolder1 serverfolder2 -assignment-options=assign-to-folder-members-recursively -p=C:\temp\copyresult.csv
-
server-delete (sd) (服务器对象路径) [...] [选项]
-
删除一个或多个服务器对象。
(服务器对象路径) [...]:相对于 /设备/服务器的服务器对象(服务器、服务器文件夹或服务器组)路径。对象名称中可以使用通配符 *,但需要将它以引号括住。如果在删除对象时使用通配符,请务必小心。
接受下列选项:
- -r、--recursive:以递归方式删除文件夹中的对象。
- -p、--preapproved:将已删除设备添加到预先批准的设备列表中。
- -f、--folder=[服务器文件夹]:相对于 /设备/服务器的服务器文件夹路径。如果指定此选项,服务器对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个服务器对象。
-
server-folder-create (sfc) [文件夹名称] [父文件夹] [选项]
-
创建包含服务器的新文件夹。
接受下列选项:
-
server-group-add (sga) (服务器组路径) [服务器路径] [...] [选项]
-
将服务器添加到服务器组。
接受下列选项:
- -f、--folder=[服务器文件夹]:相对于 /设备/服务器的服务器文件夹路径。如果指定此选项,服务器对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个服务器对象。
-
server-group-create (sgc) [组名] [父文件夹] [选项]
-
创建服务器组并为其添加成员。
接受下列选项:
- --desc=[说明]:组的说明。
- -m、--members=[服务器路径][...]:相对于 /设备/服务器的服务器路径。
- -f、--folder=[服务器文件夹]:相对于 /设备/服务器的服务器文件夹路径。如果指定此选项,服务器对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个服务器对象。
-
server-group-members (sgm) (服务器组路径) [选项]
-
列出服务器组或动态服务器组的成员。
接受下列选项:
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
server-group-remove (sgr) (服务器组路径) [服务器路径] [...] [选项]
-
从服务器组中去除服务器。
接受下列选项:
- -f、--folder=[服务器文件夹]:相对于 /设备/服务器的服务器文件夹路径。如果指定此选项,服务器对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个服务器对象。
-
server-info (si) (服务器路径)
-
列出有关服务器的详细信息。
-
server-list (sl) [选项] [文件夹]
-
列出服务器对象。
接受下列选项:
- -r、--recursive:以递归方式列出结果(包括子文件夹)。如果未指定此选项,则不会列出子文件夹的内容。
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -t、--typefilter=[类型过滤器][...]:显示与指定对象类型的逗号分隔列表相匹配的结果。有效值为 device、group 和 folder。
- -c、--count:显示结果的计数。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
- -f、--flagfilter=[标志过滤器][...]:显示与指定标志的逗号分隔列表相匹配的结果。有效值为 retired、notretired、test 和 non-test。
-
server-list-bundles (slb) (服务器对象路径) [选项]
-
列出指派给服务器对象的分发包。
接受下列选项:
- -a、--all:同时列出有效分发包和无效分发包。
- -e、--effective:只列出有效分发包。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
server-list-groups (slg) (服务器路径) [选项]
-
列出指定服务器所属的组。
接受下列选项:
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
server-list-policies (slp) (服务器对象路径) [选项]
-
列出指派给服务器对象的策略。
接受下列选项:
- -a、--all:同时列出有效策略和无效策略。
- -e、--effective:只列出有效策略。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
server-move (smv) (服务器对象路径) [目标文件夹路径]
-
将服务器对象移到其他文件夹。
-
server-refresh (srf) (服务器对象路径) [...] [选项]
-
刷新服务器中的 ZENworks 代理。
接受下列选项:
-f、--folder=[服务器文件夹]:相对于 /设备/服务器的服务器文件夹路径。如果指定此选项,服务器对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个服务器对象。
--server=<服务器/服务器文件夹/服务器组对象路径>[...]:相对于 /设备/服务器的主服务器对象(服务器、服务器文件夹或服务器组)路径,用于发送快速任务通知。
--notify=<分钟数>:通知所有设备的分钟数。
--expire=<分钟数>:快速任务创建后到失效前的分钟数。指定 0 会立即失效。
--currentserver:向当前主服务器添加快速任务。
--anyserver:在任何主服务器中添加快速任务。
--expirenever:快速任务在主服务器中从不失效。
-
server-remove-bundle (srb) (服务器对象路径) (分发包或分发包组) [...] [选项]
-
去除指派给服务器对象的分发包。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
-
server-remove-policy (srp) (服务器对象路径) (策略或策略组) [...] [选项]
-
去除指派给服务器对象的策略。
接受下列选项:
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。此选项可帮助您指定同一文件夹中的多个策略对象。
-
server-rename (sr) (服务器对象路径) (新名称)
-
重命名服务器对象。
-
server-reorder-bundles (srob) (服务器对象路径) (当前位置) (新位置)
-
更改指派给服务器的分发包的顺序。使用 workstation-list-bundles 命令可以获取已指派分发包的顺序。
-
server-reorder-policies (srop) (服务器对象路径) (当前位置) (新位置)
-
更改指派给服务器的策略的顺序。使用 server-list-policies 命令可以获取已指派策略的顺序。
-
server-retire (sret) (服务器对象路径)
-
在下次刷新所选服务器时从 ZENworks 系统中淘汰该服务器。淘汰设备不同于删除设备。淘汰设备时,将保留其 GUID(与删除设备相反,删除设备还会删除其 GUID)。因此,所有库存信息均会保留并可访问,但会去除所有策略和分发包指派。如果在将来重新激活设备,则会恢复其指派。
接受下列选项:
- -i、--immediate:强制执行设备刷新以立即淘汰设备。
-
server-set-as-test (ssat) (服务器对象路径)
-
将服务器设为测试设备。
示例
将 server1 设为测试设备:
zman ssat server1
-
server-role-zookeeper-add-server (srzas)
-
将 ZooKeeper 角色指派到主服务器。
--servers:服务器的逗号分隔列表。相对于“/设备/服务器”的服务器对象(服务器、服务器文件夹或服务器组)的 GUID、DNS 或路径。
-
server-role-zookeeper-remove-server (srzrs)
-
从 ZooKeeper 群集中去除服务器。区域中至少须有一台服务器具有 ZooKeeper 角色。
--servers:相对于“/设备/服务器”的服务器对象(服务器、服务器文件夹或服务器组)的 GUID、DNS 或路径。
-
server-role-zookeeper-list-cluster (srzlc)
-
列出 ZooKeeper 群集中当前配置的服务器。
-
server-role-zookeeper-update-cluster (srzuc) [...] [选项]
-
更新 ZooKeeper 群集的通用属性。
接受下列选项:
- -l --leader-connect-port:定义 follower 用于连接到群集中的 leader 的 leader 端口。默认端口为 6790。不过,您可以指定介于 6000 到 65535 之间的未使用端口。
- -c --client-port:定义 ZooKeeper 要用于侦听传入连接的端口。默认端口为 6789。不过,您可以指定介于 6000 到 65535 之间的未使用端口。
- -e --leader-elect-port:定义群集中的所有服务器将用于选举 leader 的选举端口。默认端口为 6791。不过,您可以指定介于 6000 到 65535 之间的未使用端口。
- -t --tick-time:定义单个心跳的时长(以毫秒表示的基本时间单位),ZooKeeper 使用它来调控检测信号与超时。默认值是 2000。
- -i --init-limit:定义 follower 可用于连接到 leader 的时长(心跳数)。默认值是 10。
- -s --sync-limit:定义 follower 可用于与 ZooKeeper 同步的时长(心跳数)。默认值是 5。
- -x --max-connections:指定 ZooKeeper 群集可接受的最大客户端连接数。默认值是 60。
-
server-role-kafka-configure-cluster (srkcc) [...] [选项]
-
配置 Kafka 群集。
- 接受以下选项:
- -a --logRetentionPeriod:指定应将 Kafka 日志保留多长时间(以小时为单位)。
- -c --replication count:指定要为每个主题创建的副本数。
- -l --logRetentionBytes:指定允许的最大日志大小,如果超过该大小,新数据会重写现有数据。默认情况下,日志大小无限制。
- -t --zkSessionTimeout:指定 ZooKeeper 会话超时(以毫秒为单位)。默认值为 30000 毫秒。如果服务器在指定的时限内未向 ZooKeeper 发出检测信号,则将该服务器视为已死。检测信号请求有助于识别服务器是否仍与 Kafka 群集保持连接。
- -r --retainDetectedLogsDuration:指定已删除日志的最长保留时间。
- -p --logCleanupPolicy:为超过允许的最长保留时限的日志段指定默认清理策略。可用的值为 Delete 和 Compact。默认值为 Delete。Delete 策略会在达到保留时间或大小限制时去除旧日志段。Compact 策略会针对主题启用日志压缩,这可以确保 Kafka 在单个主题分区数据的日志中,始终为每个讯息键至少保留最后获取的值。
- -s --schemaregistryport:指定运行 Schema Registry 的端口。默认端口为 8081。
- -k、--kafkaport:指定 Kafka 在其上侦听的端口。默认端口为 9093。
- -x、--connectport:指定 Kafka Connect 在其上侦听的端口。默认端口为 8083。
-
server-role-kafka-add-broker (srkab)
-
将中介程序添加到 Kafka 群集。
--servers:服务器的逗号分隔列表。您可以指定相对于“/设备/服务器”的服务器对象(服务器、服务器文件夹或服务器组)的 GUID、DNS 或路径。
-i --ignorewarning:指定 True 或 False。此选项用于忽略发现外部 CA 时显示的与客户端鉴定证书相关的警告讯息。您可以将此选项设为 True 以便继续。
-
server-role-kafka-remove-broker (srkrb)
-
从 Kafka 群集中去除中介程序。
--servers:相对于“/设备/服务器”的服务器对象(服务器、服务器文件夹或服务器组)的 GUID、DNS 或路径。
-
server-role-kafka-reconfig-broker (srkrcb)
-
重新配置 Kafka 中介程序。
--servers:服务器的逗号分隔列表。相对于“/设备/服务器”的服务器对象(服务器、服务器文件夹或服务器组)的 GUID、DNS 或路径。
-
server-role-kafka-update-cluster (srkuc) [...] [选项]
-
更新 Kafka 群集配置。
- 接受以下选项:
- -l --logRetentionBytes:指定允许的最大日志大小,如果超过该大小,新数据会重写现有数据。默认情况下,日志大小无限制。
- -t --zkSessionTimeout:指定 ZooKeeper 会话超时(以毫秒为单位)。默认值为 30000 毫秒。如果服务器在指定的时限内未向 ZooKeeper 发出检测信号,则将该服务器视为已死。检测信号请求有助于识别服务器是否仍与 Kafka 群集保持连接。
- -r --retainDetectedLogsDuration:指定已删除日志的最长保留时间。
- -p --logCleanupPolicy:为超过允许的最长保留时限的日志段指定默认清理策略。可用的值为 Delete 和 Compact。默认值为 Delete。Delete 策略会在达到保留时间或大小限制时去除旧日志段。Compact 策略会针对主题启用日志压缩,这可以确保 Kafka 在单个主题分区数据的日志中,始终为每个讯息键至少保留最后获取的值。
- -c、--replication count:指定要为每个主题创建的副本数。
- -s --schemaregistryport:指定运行 Schema Registry 的端口。
- -k、--kafkaport:指定 Kafka 在其上侦听的端口。
- -x、--connectport:指定 Kafka Connect 在其上侦听的端口。
-
server-role-kafka-list-cluster (srklc)
-
检索 Kafka 群集配置。
-
server-role-kafka-list-connectors (srklcn)
-
检索 Kafka 连接器列表。
-
server-role-kafka-restart-connectors (srkrcn) [...] [选项]
-
重启动指定的 Kafka 连接器。
- 接受下列选项:
- -c --connectors:指定连接器的逗号分隔列表。
-
server-role-kafka-get-connector-config (srkgcc) [...] [选项]
-
检索 Kafka 连接器配置细节。
- 接受下列选项:
- -c --connector:指定连接器的名称以检索其配置细节。
-
server-role-kafka-reconfigure-connectors (srkccn) [...] [选项]
-
重新配置指定的 Kafka 连接器。
- 接受下列选项:
- -c --connectors:指定连接器的逗号分隔列表。
-
server-role-kafka-recreate-connectors (srkrcc) [...] [选项]
-
重新创建 Kafka 连接器。在 RDBMS 之间迁移数据库时,需执行此命令。
- 接受以下选项:
- -f --force:通过删除所有现有连接器来强制重新创建 Kafka 连接器。
-
server-role-vertica-create-cluster (srvcc) [...] [选项]
-
创建包含一个或多个节点的 Vertica 群集。这是配置 Vertica 时必须运行的第一个命令。
--servers:服务器的逗号分隔列表。相对于“/设备/服务器”的服务器对象(服务器、服务器文件夹或服务器组)的 GUID、DNS 或路径。
- 接受以下选项:
- -k --replication-factor:指定数据库中应存在的数据复本数。您需要根据群集中的节点数指定值,所需的最小节点数以 2000+1 计量。Vertica 建议将 K-safety 系数设为 1。
-
server-role-vertica-add-server (srvas)
-
将服务器添加到 Vertica 群集。
--servers:服务器的逗号分隔列表。相对于“/设备/服务器”的服务器对象(服务器、服务器文件夹或服务器组)的 GUID、DNS 或路径。
-
server-role-vertica-remove-server (srvrs)
-
从 Vertica 群集中去除服务器。
--servers:服务器的逗号分隔列表。相对于“/设备/服务器”的服务器对象(服务器、服务器文件夹或服务器组)的 GUID、DNS 或路径。
-
server-role-vertica-list-cluster (srvlc)
-
列出 Vertica 群集中的服务器。
-
server-role-vertica-update-cluster (srvuc)
-
更新群集中的 K-safety 系数。
- 接受以下选项:
- -k --replication-factor:修改复制系数,以指示要在群集中保留的复本总数。
-
server-role-vertica-get-credentials (srvgc)
-
检索 Vertica 数据库身份凭证。
-
server-role-vertica-prepare-server (srvps)
-
在备份和恢复过程中准备服务器。
(服务器对象路径):服务器对象(服务器、服务器文件夹或服务器组)的 GUID、DNS 或路径(相对于“/设备/服务器”)。
-
server-set-as-nontest (ssan) (服务器对象路径)
-
将服务器设为非测试设备。
示例
将 server1 设为非测试设备:
zman ssan server1
-
server-statistics (sst) (服务器路径)
-
显示有关 ZENworks 服务器使用的统计数字。
-
server-unretire (suret) (服务器对象路径)
-
在下一次刷新所选服务器时重新激活该服务器,并重新应用该设备先前拥有的所有策略和分发包指派。
接受下列选项:
- -i、--immediate:强制执行设备刷新以立即取消淘汰设备。
-
server-view-all-bundles-status (svabs) (服务器路径) [选项]
-
显示指派给服务器的分发包的高级部署状态。
接受下列选项:
- --statusfilter=[状态类型][...]:按“分发包分发和安装事件”的状态过滤。有效值为“S”、“R”、“C”、“A”、“F”和“P”(成功、部分成功、已完成、部分完成、失败和待处理)。可以提供状态类型的逗号分隔列表。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
示例
查看指派给 server1 的分发包的部署状态:
zman svabs server1
查看指派给分发包部署状态为成功或待处理的 server1 的分发包的部署状态:
zman svabs server1 --statusfilter S,P
-
server-view-all-policies-status (svaps) (服务器路径) [选项]
-
显示指派给服务器的策略的高级部署状态。
接受下列选项:
- --statusfilter=[状态类型][...]:按“策略应用事件”的状态过滤。有效值为“S”、“F”和“P”(成功、失败和待处理)。可以提供状态类型的逗号分隔列表。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
server-wakeup (sw) (服务器对象路径) [...] [选项]
-
使用网络唤醒功能唤醒服务器。
接受下列选项:
- -f、--folder=[服务器文件夹]:相对于 /设备/服务器的服务器文件夹路径。如果指定此选项,服务器对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个服务器对象。
- -b、--broadcast=[广播地址][...]:用于广播网络唤醒魔术包的地址逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。有效值为有效的 IP 地址。
- -s、--server=[相对于 /设备的主服务器对象或代理服务器对象的路径][...]:用于唤醒设备的主服务器对象或代理服务器对象的逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。
- -C、--retries=[重试次数]:向设备发送网络唤醒魔术包的次数。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 0 和 5 之间。默认值是 1。
- -t、--timeout=[重试的时间间隔]:两次重试之间的时间间隔。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 2 和 10(分钟)之间。默认值是 2。
设置命令
这些命令用于设置和修改设置。设置命令的全称以 settings- 开头,简称以字母 s 开头。
设置命令不适用于 ZENworks Endpoint Security Management 设置(区域策略设置和数据加密密钥设置)。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
settings-copy (scp) (源设备或设备文件夹路径) (目标设备或设备文件夹路径) [...] [选项]
-
复制设置。
(源设备或设备文件夹路径):要从中复制设置的设备或设备文件夹路径(相对于 /设备)。
(目标设备或设备文件夹路径) [...]:要将设置复制到其中的设备或设备文件夹路径(相对于 /设备)。
接受下列选项:
- -n、--names=[设置名称][...]:要从源路径复制的设置名称。如果未指定此选项,则会复制源路径中定义的所有设置。
-
settings-export-to-file (setf) [选项] (XML 文件路径) [设置名称] [...]
-
将设置数据以 XML 格式导出到文件中。该 XML 文件会在创建或修改设置时用作输入文件。
(XML 文件路径):设置数据要以 XML 格式储存到其中的文件。如果文件不存在,则会创建新文件。
[设置名称] [...]:要导出的设置的名称。如果未指定此选项,则会导出所有设置。
接受下列选项:
- -s、--source=[源设备或设备文件夹路径]:要导出设置的设备或设备文件夹路径(相对于 /设备)。如果未指定此选项,则会导出“区域”中的设置。
- -e、--effective:如果指定此选项,将会检索有效设置,否则只会检索源路径下已定义或覆盖的设置。
-
settings-revert (srt) (源设备或设备文件夹路径) (设置名称) [...]
-
将设置还原为父文件夹的设置。
(源设备或设备文件夹路径):要还原其设置的设备或设备文件夹路径(相对于 /设备)。
-
settings-set (ss) (XML 文件路径) [目标设备或设备文件夹路径] [...]
-
在各个级别进行设置。
(XML 文件路径):包含导出的设置信息的 XML 文件。使用 settings-export-to-file (setf) 可将设置信息导出到 XML 文件中。
接受下列选项:
[设置名称] [...]:要导出的设置的名称。如果未指定此选项,则会导出所有设置。
- -s、--source=[源设备或设备文件夹路径]:要设置其设置的设备或设备文件夹路径(相对于 /设备)。如果未指定此选项,则会在“区域”级别进行设置。
-
settings-gcm-delete (sgd) [...]
-
删除 Google Cloud Messaging 配置的值。您需要重启动 ZENworks 服务以让更改生效。
安全性命令
以下命令用于启用或禁用将保护代理与服务器间的通讯的设置
此命令接受“全局选项”部分列出的选项标志。此外,它还接受随命令列出的各个选项。
- Security-Set-Agent-Server-Secure-Communication --option=(true/false)
-
启用或禁用将保护代理与服务器间的通讯的设置。全新安装的 ZENworks (2020 Update 2) 中默认会启用此设置。在升级后的区域中将会禁用此增强型安全性功能,以使 ZENworks 2020 Update 1 及更低版本的代理能继续与升级后的服务器通讯。但如果您要升级区域中的所有设备,则建议启用此增强型安全性功能。启用此安全性功能后,所有较低版本的设备都将无法与主服务器通讯。启用此功能后,要注册设备,您需要创建授权密钥或将该设备添加到预先批准的设备列表中。有关详细信息,请参见《ZENworks 发现、部署和淘汰参考手册》。
启用此安全性功能后,
要启用该安全性设置,请运行 zman ssassc --option=true
要禁用该安全性设置,请运行 zman ssassc --option=false
修改此设置后,您需要重启动 ZENworks Server 服务 (microfocus-zenworks-configure -c Start) 以应用更改。
订阅命令
这些命令用于创建、修改和管理订阅。订阅命令的全称以 subscription- 开头,简称以字母 sr 开头。
此命令接受“全局选项”部分列出的选项标志。此外,它还接受随命令列出的各个选项。
-
subscription-create (src) (订阅名称) (订阅 XML 文件) [父文件夹] [选项]
-
创建新订阅。
(订阅 XML 文件):包含导出的订阅信息的 XML 文件。使用 subscription-export (sre) 可将现有订阅的信息导出到 XML 文件中。如果您想重复使用文件,可以从 ZENworks 控制中心中已创建的订阅创建 XML 模板文件。如需 XML 示例文件,请参考 nu.xml(位于
在 Linux 上:
/opt/microfocus/zenworks/share/zman/samples/subscriptions
在 Windows 上:
%ZENSERVER_HOME%\Micro Focus\zenworks\share\zman\samples\subscriptions
接受下列选项:
- -s、--sysIDpath=[rhel-systemid]
-
subscription-folder-create (srfc) (文件夹名称) [父文件夹] [选项]
-
创建新的订阅文件夹。
接受下列选项:
-
subscription-move (srmv) (订阅对象路径) [目标文件夹路径]
-
将订阅对象移到其他文件夹。
-
subscription-replicate (srr) (订阅名称) [目标文件夹路径] [选项]
-
开始订阅复制。
接受下列选项:
- -s、--schedule=[XML 文件名]:包含开始订阅的日程安排的 XML 文件。Eventsch.xml 文件不适用于订阅。
- -r、--fromRepository:要从中复制内容的储存库。
注:对于 Apple VPP 订阅,执行此命令时将不会用到出站服务器。因此,您需要确保用于执行此命令的服务器可连接因特网。
-
subscription-export (sre) (订阅名称) (subscription-data.xml)
-
将订阅信息以 XML 格式导出到文件中。该 XML 文件将用作创建订阅时的输入文件。
-
subscription-delete (srd) (订阅对象) [...] [选项]
-
删除一个或多个订阅对象。无法删除处于“进行中”、“已暂停”和“已指派”状态的订阅。
接受下列选项:
- -r、--recursive:以递归方式删除文件夹中的对象。
- -b、--delete-bundles:删除由指定订阅创建的所有分发包。
- -f、--folder=[订阅文件夹]:相对于 /订阅的订阅文件夹路径。如果指定此选项,订阅对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个订阅对象。
-
subscription-list (srl) [选项]
-
列出订阅对象。
接受下列选项:
- -r、--recursive:以递归方式列出结果(包括子文件夹)。如果未指定此选项,则不会列出子文件夹的内容。
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -c、--count:显示结果的计数。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
- [文件夹]:列出指定文件夹的内容。如果未指定文件夹,则会列出根文件夹的内容。
-
subscription-modify (srm) (订阅名称) (subscription-data.xml) [父文件夹] [选项]
-
导出或修改现有订阅。
接受下列选项:
- -d、--desc=[说明]:订阅说明。
- -s、--sysIDpath=[rhel-systemid]
-
subscription-status (srs) (订阅名称) [选项]
-
返回订阅的状态。
接受下列选项:
- -s、--suspend:暂停复制并将订阅状态更改为“已暂停”。
- -c、--cancel:取消复制并将订阅状态更改为“已取消”。
注:执行试运行时不支持 Suspend 和 Cancel 任务。
-
subscription-channel-list (srcl) (订阅名称) (储存库实体类型) [选项]
-
列出分发包、编目和包等数据。
接受下列选项:
- -r、--fromRepository:跳过超速缓存,并从要复制其内容的储存库下载元数据。
- -i、--ignoreFilters:列出内容,忽略可能要配置的所有过滤器。
-
subscription-copy (srcp) (订阅路径) (订阅名称) [父文件夹] [选项]
-
复制订阅。
接受下列选项:
-
subscription-rename (srrn) (订阅对象路径) (新名称)
-
重命名订阅。
例如,要将订阅 SLES10Update 重命名为 SLED10Update,请运行以下命令:
zman srrn /Subscription/SLES10Update /Subscription/SLED10Update
-
subscription-proxy-password (srpp) [订阅代理口令]
-
配置复制期间将由任何订阅使用的代理口令。在此命令中,代理口令自变量是可选的。如果您未输入代理口令自变量,该命令将提示您输入口令。
-
Subscription-unenroll-android-enterprise |sueae [企业 ID] [NCC 用户名] [口令文件路径]
-
取消注册 Android 企业帐户。
接受下列自变量:
[企业 ID] 指定要取消注册的企业 ID。
[NCC 用户名] 指定 NCC 用户名。
[口令文件路径] 指定口令文件的位置。口令文件可以用任何文件格式保存。
示例:sueae LC046w6dx5 MFtest C:\password.txt
在此示例中,LC046w6dx5 是企业 ID,MFtest 是 NCC 用户名,C:\password.txt 是保存口令的位置。
-
Subscription-clear-ae | sca
-
删除与已取消注册的 Android 企业订阅相关的数据,例如分发包、APP、用户和其他相关数据。
系统更新/产品识别更新命令
这些命令用于管理 ZENworks 的系统更新与产品识别更新 (PRU)。这些命令的全称以 system-update 开头,简称以字母 su 开头。
-
system-update-download (sud) (系统更新或 PRU 名称)
-
下载最新的系统更新或 PRU。
(系统更新或 PRU 名称):系统更新/PRU 的名称或 UID。
-
system-update-view-available (suva) [选项]
-
显示更新服务器或更新文件中发布的所有可用更新或 PRU 的列表。
接受下列选项:
- -i、--importFile=[导入文件/目录的路径]:要查询的导入文件的完整路径。
- -u、--url=[更新服务器的 url]:要查询的系统更新服务器的 URL 格式为 http://服务器名称:[端口]/路径。
- -f、--product=[产品代码]:要检查有无更新的产品代码(如 zcm、pru)。
- -v、--version=[产品基础版本]:要检查有无更新的产品基础版本(如 10.0、10.1)。
-
system-update-status (sus) (系统更新或 PRU 名称)
-
显示指定系统更新或 PRU 的状态。
(系统更新或 PRU 名称):系统更新/PRU 的名称或 UID。
-
system-update-delete-update (sudu) (系统更新或 PRU 名称) [选项]
-
删除区域中指定的系统更新或 PRU。
(系统更新或 PRU 名称):系统更新/PRU 的名称或 UID。
接受下列选项:
- -f、--force:强制删除更新。只会从服务器中去除指派。如果您刷新设备并查看更新,则会在该设备上应用更新。使用时请务必小心,并且仅当确保更新未处于活动状态时才可使用。
-
system-update-cancel-download (sucd) (系统更新或 PRU 名称)
-
取消下载系统更新或 PRU。
(系统更新或 PRU 名称):系统更新/PRU 的名称或 UID。
-
system-update-assign (sua) (系统更新名称) [设备路径] [...] [选项]
-
将授权的系统更新指派给设备。
(系统更新名称):系统更新名称或 UID。
[设备路径] [...]:相对于 /设备的设备路径。
接受下列选项:
-
system-update-list-assign (sula) (设备路径)
-
列出指派给指定设备或组的所有更新。
[设备路径]:相对于“/设备”的设备路径。
-
system-update-authorize (suaz) (系统更新或 PRU 名称)
-
对更新或 PRU 进行授权。
(系统更新或 PRU 名称):系统更新/PRU 的名称或 UID。
-
system-update-baseline (sub) (系统更新名称)
-
安排将指定更新设置为基线更新的尝试。
(系统更新名称):系统更新名称或 UID。
- system-update-import (sui) (更新路径) [系统更新或 PRU 名称][-b、--checkbaseline]
-
将 ZIP 文件或目录中的系统更新或 PRU 导入到“区域”中。更新或 PRU 安装至 ZENworks 系统后,其管理方式与联机更新或 PRU 的管理方式相同。在 linux 服务器上,要导入的 ZIP 文件应位于 var/tmp 下。
(更新路径):更新或 PRU ZIP 文件或目录的完整路径。
(系统更新或 PRU 名称):系统更新/PRU 的名称或 UID。
(-b、--checkbaseline):检查是否有更新,并在适用时将其设为基线。系统默认不会将更新设为基线。
注:从 ZENworks 2020 Update 2 开始,无法从 /tmp 目录导入系统更新或 PRU,需改为使用 /var/tmp 目录。
-
system-update-activate-entitlement (suae) (邮件 ID) (激活代码)
-
激活管理区域中 ZENworks 软件的系统更新权利,以从 Micro Focus Customer Center 服务器接收最新版的 ZENworks 系统更新和产品识别更新 (PRU)。
(邮件 ID):用于接收 Micro Focus 来信的电子邮件地址。建议您指定购买系统更新维护权利时使用的电子邮件地址。
(激活代码):系统更新权利激活代码。
注:激活权利之前,请确保要用于激活权利的主服务器能够与 NCC 服务器通讯。
-
system-update-view-entitlement-status (suves)
-
显示系统更新权利状态。
-
system-update-rebuild-packages (surp) (系统更新名称)
-
在此服务器上使用指定的更新内容重构建部署包。
(系统更新名称):系统更新名称或 UID。
-f、--force:强制重构建包,即使更新中并不包含新包。
-
system-update-patch-file (supf) (系统更新名称) (增补程序的路径)
-
以新版文件增补更新。在 linux 服务器上,该 ZIP 文件应位于 var/tmp 下。
(系统更新名称):系统更新名称或 UID。
(增补程序的路径):增补程序文件所在的 zip 文件或文件夹的完整路径。
-
(system-update-create-package | sucp) (系统更新名称) [设备路径] [-n|--packagename=独立更新包名称] [-p|--platform=操作系统平台] [-a|--arch=体系结构]
-
创建指定的独立更新包。此命令可用于使用更新 GUID 和设备 GUID 为特定设备创建包,或者使用平台和体系结构细节为平台创建包。
(系统更新名称):系统更新名称或 UID。
[设备路径]:设备的相对路径(相对于 /设备)。
-n、--packagename=<独立更新包名称>:独立更新包的名称。如果未指定,则会根据设备名称或指定的平台计算得出该名称。
-p、--platform=<操作系统平台>:独立更新包的操作系统平台。有效值为 Windows。
-a、--arch=<体系结构>:独立更新包的设备体系结构。有效值为 32 或 64。
用户命令
这些命令用于管理属于 ZENworks 中配置的用户来源的用户。需从现有的 LDAP 权威来源(例如 e‑Directory 或 Active Directory)配置用户来源。此部分列出的用户来源命令还可让您管理和显示证书。用户命令的全称以 user- 开头,简称以字母 u 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
user-add-bundle (uab) (用户对象路径) (分发包或分发包组) [...] [选项]
-
将分发包指派给用户对象。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
- -I、--icon-location=[应用程序位置 XML 文件]:包含分发包应用程序图标的放置位置的 XML 文件。有关 XML 文件格式,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/bundles 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\bundles 目录中的 IconLocation.xml。
- -d、--distribution-schedule=[分发日程安排 XML 文件]:包含分发日程安排的 XML 文件。
- -l、--launch-schedule=[起动日程安排 XML 文件]:包含起动日程安排的 XML 文件。
- -b、--install-schedule=[安装日程安排 XML 文件]:包含安装日程安排的 XML 文件。
- -a、--availability-schedule=[可用性日程安排 XML 文件]:包含可用性日程安排的 XML 文件。有关日程安排 XML 文件模板,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/schedules 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\schedules 目录中的 XML 文件。
- -i、--install-immediately:分发后立即安装分发包。要使用此选项,还必须指定分发日程安排。使用 --distribution-schedule、--distribute-now 或 --distribute-on-device-refresh 选项可以指定分发日程安排。
- -L、--launch-immediately:安装后立即起动分发包。要使用此选项,还必须指定分发日程安排。使用 --distribution-schedule、--distribute-now 或 --distribute-on-device-refresh 选项可以指定分发日程安排。
- -n、--distribute-now:将分发日程安排设置为立即分发分发包。如果指定此选项,则会忽略 --distribution-schedule 和 --distribute-on-device-refresh 选项。--distribute-now、--distribute-on-device-refresh 和 --distribution-schedule 三个选项相互排斥,均用于设置分发日程安排。会优先考虑 --distribute-now 选项,然后才是 --distribute-on-device-refresh 和 --distribution-schedule。
- -r、--distribute-on-device-refresh:将分发日程安排设置为在刷新设备时分发分发包。如果指定此选项,则会忽略 --distribution-schedule 选项。
- -s、--launch-on-device-refresh:将起动日程安排设置为在刷新设备时起动分发包。如果指定此选项,则会忽略 --launch-schedule 选项。
-
user-add-policy (uap) (用户对象路径) (策略或策略组) [...] [选项]
-
将策略指派给用户对象。
接受下列选项:
- -e、--enforce-now:立即对所有指派的设备实施策略。
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
user-container-create (ucc) (用户来源) (用户容器) (显示名称)
-
将用户容器添加到 ZENworks 中配置的用户来源。
(用户容器):要以相对判别名 (RDN) 格式添加的用户容器,相对于 LDAP 来源的根环境。
(显示名称):显示用户容器的名称。
-
user-group-add (uga) (ZENworks 用户组路径) (用户路径) [...] [选项]
-
将用户添加到 ZENworks 用户组。
接受下列选项:
- -f、--folder=[用户文件夹]:相对于 /用户的用户文件夹路径。如果指定此选项,用户对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个用户对象。
-
user-group-create (ugc)(组名)[选项]
-
创建 ZENworks 用户组并为其添加成员。
接受下列选项:
- --desc=[说明]:组的说明。
- -m、--members=[用户路径][...]:相对于 /用户的用户路径。
- -f、--folder=[用户文件夹]:相对于 /用户的用户文件夹路径。如果指定此选项,用户对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个用户对象。
-
user-group-delete (ugd) (ZENworks 用户组路径) [...]
-
删除一个或多个 ZENworks 用户组。
(ZENworks 用户组路径) [...]:相对于 /用户/ZENworks 用户组的 ZENworks 用户组路径。
-
user-group-members (ugm) (用户组路径) [选项]
-
列出 ZENworks 用户组或 LDAP 目录用户组的成员。
接受下列选项:
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
user-source-refresh (usr)
-
在所有用户来源上启动刷新。
-
user-group-remove (ugr) (ZENworks 用户组路径) (用户路径) [...] [选项]
-
从 ZENworks 用户组中去除用户。
接受下列选项:
- -f、--folder=[用户文件夹]:相对于 /用户的用户文件夹路径。如果指定此选项,用户对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个用户对象。
-
user-info (ui) (用户路径)
-
列出有关用户的详细信息。
-
user-list (ul) [选项] [文件夹]
-
列出用户对象。
接受下列选项:
- -r、--recursive:以递归方式列出结果(包括子文件夹)。如果未指定此选项,则不会列出子文件夹的内容。
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -t、--typefilter=[类型过滤器][...]:显示与指定对象类型的逗号分隔列表相匹配的结果。有效值为 user、group 和 folder。
- -c、--count:显示结果的计数。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
user-list-bundles (ulb) (用户对象路径) [选项]
-
列出指派给用户对象的分发包。
接受下列选项:
- -a、--all:同时列出有效分发包和无效分发包。
- -e、--effective:只列出有效分发包。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
user-list-groups (ulg) (用户路径) [选项]
-
列出指定用户所属的组。
接受下列选项:
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
user-list-policies (ulp) (用户对象路径) [选项]
-
去除指派给用户对象的策略。
- -a、--all:同时列出有效策略和无效策略。
- -e、--effective:只列出有效策略。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
user-logged-in-devices (ulid) (用户路径)
-
显示用户所登录的设备。
-
user-primary-workstation (upws) (用户路径)
-
列出用户的主工作站、登录次数和用户登录主工作站的时间(以分钟计)。
-
user-remove-bundle (urb) (用户对象路径) (分发包或分发包组) [...] [选项]
-
去除指派给用户对象的分发包。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
-
user-remove-policy (urp) (用户对象路径) (策略或策略组) [...] [选项]
-
去除指派给用户对象的策略。
接受下列选项:
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
user-reorder-policies (urop) (用户对象路径) (当前位置) (新位置)
-
更改指派给用户的策略的顺序。
-
user-set-as-test (usat) (用户对象路径)
-
将用户设为测试用户。
示例
将 user1 设为测试用户:
zman usat user1
-
user-set-as-nontest (usan) (用户对象路径)
-
将用户设为非测试用户。
示例
将 user1 设为非测试用户:
zman usan user1
-
user-source-create (usc) (用户来源 XML 文件路径) [选项]
-
配置用户来源。
接受下列选项:
-a、--accept-certificate:接受选择 SSL 模式时用户来源提供的证书。使用此选项可避免在编写脚本时进入交互模式。建议先查看证书,然后再接受证书。
xml 文件中应包含以下内容:
对于 Active Directory
<UserSourceInformation xmlns="http://novell.com/zenworks/zman/usersource" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<!--Configuring a user source, allows bundle and policy objects to be assigned to identities contained in an LDAP directory-->
<!--Please enter the connection information for the LDAP directory.-->
<ConnectionInformation>
<!--Specify the IP Address of the LDAP Server. For example, 192.168.1.60-->
<Address>xxx.xxx.xx.xx</Address>
<UseSSL>true</UseSSL>
<IgnoreDynamicGroups>false</IgnoreDynamicGroups>
<Port>636</Port>
<!--389 is the default non-ssl port -->
<RootLDAPContext></RootLDAPContext>
</ConnectionInformation>
<!--Please enter the LDAP credentials that will be used when information is needed from the user source.
These credentials need to provide read access to the contexts of your tree where users reside.-->
<CredentialsInformation>
<Username>ZENworks@domain.com</Username>
<Password>Password</Password>
</CredentialsInformation>
<!--Include the containers of your user source where your users reside. In order to minimize browsing
include user containers directly. You may include any number of containers independently and manage them as a set or individually-->
<UserContainers>
<UserContainer>
<Context>cn=Users</Context>
<DisplayName>Users</DisplayName>
</UserContainer>
</UserContainers>
<!-- Optionally include authentication mechanisms to use with your user source. Add zero or more mechanism types.
Accepted mechanisms are "Username/Password" and "Kerberos". -->
<Mechanism><Type>Username/Password</Type></Mechanism>
<!--Mechanism><Type>Kerberos</Type></Mechanism-->
</UserSourceInformation>
对于 eDirectory
<UserSourceInformation xmlns="http://novell.com/zenworks/zman/usersource" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<!--Configuring a user source, allows bundle and policy objects to be assigned to identities contained in an LDAP directory-->
<!--Please enter the connection information for the LDAP directory.-->
<ConnectionInformation>
<!--Specify the IP Address of the LDAP Server. For example, 192.168.1.60-->
<Address>xxx.xx.xx.xx</Address>
<UseSSL>true</UseSSL>
<IgnoreDynamicGroups>false</IgnoreDynamicGroups>
<Port>636</Port>
<!--389 is the non-ssl port-->
<RootLDAPContext></RootLDAPContext>
</ConnectionInformation>
<!--Please enter the LDAP credentials that will be used when information is needed from the user source.
These credentials need to provide read access to the contexts of your tree where users reside.-->
<CredentialsInformation>
<Username>cn=admin,o=novell</Username>
<Password>novell</Password>
</CredentialsInformation>
<!--Include the containers of your user source where your users reside. In order to minimize browsing
include user containers directly. You may include any number of containers independently and manage them as a set or individually-->
<UserContainers>
<UserContainer>
<Context>ou=Container1,o=Novell</Context>
<DisplayName>Container1</DisplayName>
</UserContainer>
<UserContainer>
<Context>ou=Container2,o=Novell</Context>
<DisplayName>Container2</DisplayName>
</UserContainer>
</UserContainers>
<!-- Optionally include authentication mechanisms to use with your user source. Add zero or more mechanism types.
Accepted mechanisms are "Username/Password" and "Shared Secret". -->
<Mechanism><Type>Username/Password</Type></Mechanism>
<Mechanism><Type>Shared Secret</Type></Mechanism>
</UserSourceInformation>
-
user-source-list (usl)
-
列出配置的用户来源。
-
user-source-list-connections (uslc) (用户来源)
-
列出某一用户来源的服务器连接。
-
user-source-remove-connection (usrc)(用户来源)(连接名称)
-
去除某一用户来源中的服务器连接。
-
user-source-servercert-remove (ussr) (<输入参数>,<输入参数>,...,<输入参数>)
-
去除指定的用户来源服务器证书。
- (输入参数):指定相关参数:
- 要去除单个用户来源服务器证书,请按以下格式指定用户来源名称和服务器连接名称:<用户来源名称>,<服务器连接名称>
- 要去除多个用户来源服务器证书,请按以下格式指定包含用户来源名称和服务器连接名称列表的 CSV 文件的路径:<用户来源名称>,<服务器连接名称>
-
user-source-trustedcert-add (usta) (证书别名) (证书文件路径)
-
为使用安全用户来源连接处理 LDAP 搜索请求时可参考的另一个 LDAP 服务器添加其他可信证书。
- (证书别名):用来识别密钥存储区内的证书的别名。
- (证书文件路径):DER 格式的证书文件的路径。
- -c、--ca-cert:添加 CA 证书。别名必须是用户来源名称或 GUID。
- 有关用户来源细节的详细信息,请参见 user-source-list 命令。
-
user-source-trustedcert-list (ustl)
-
列出用于安全用户来源连接的其他可信证书。
-
user-source-trustedcert-remove、ustr (证书别名)
-
去除用于安全用户来源连接的可信证书。
-
user-source-add-connection (usac) (用户来源) (连接名称) (服务器地址) (服务器端口) [选项]
-
为用户来源添加新的服务器连接。
接受下列选项:
-a、--accept-certificate:接受选择 SSL 模式时用户来源提供的证书。使用此选项可避免在编写脚本时进入交互模式。建议先查看证书,然后再接受证书。
-s、--use-ssl:指定访问新的服务器时应使用 SSL。
-
user-view-all-bundles-status (uvabs) (用户路径) [选项]
-
显示指派给用户的分发包的高级部署状态。
接受下列选项:
- --statusfilter=[状态类型][...]:按“分发包分发和安装事件”的状态过滤。有效值为“S”、“F”和“P”(成功、失败和待处理)。可以提供状态类型的逗号分隔列表。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
user-view-all-policies-status (uvaps) (用户路径) [选项]
-
显示指派给用户的策略的高级部署状态。
接受下列选项:
- --statusfilter=[状态类型][...]:按“策略应用事件”的状态过滤。有效值为“S”、“F”和“P”(成功、失败和待处理)。可以提供状态类型的逗号分隔列表。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
工作站命令
这些命令用于管理工作站。工作站命令的全称以 workstation- 开头,简称以字母 w 开头。
以下所有命令均接受“全局选项”部分列出的选项标志。此外,它们还接受随每个命令列出的各个选项。
-
workstation-add-bundle (wab) (工作站对象路径) (分发包或分发包组) [...] [选项]
-
将分发包指派给工作站对象。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
- -I、--icon-location=[应用程序位置 XML 文件]:包含分发包应用程序图标的放置位置的 XML 文件。有关 XML 文件格式,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/bundles 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\bundles 目录中的 IconLocation.xml。
- -d、--distribution-schedule=[分发日程安排 XML 文件]:包含分发日程安排的 XML 文件。
- -l、--launch-schedule=[起动日程安排 XML 文件]:包含起动日程安排的 XML 文件。
- -a、--availability-schedule=[可用性日程安排 XML 文件]:包含可用性日程安排的 XML 文件。有关日程安排 XML 文件模板,请参考 Linux 服务器上 /opt/microfocus/zenworks/share/zman/samples/schedules 目录或 Windows 服务器上安装目录:\Micro Focus\Zenworks\share\zman\samples\schedules 目录中的 XML 文件。
- -b、--install-schedule=[安装日程安排 XML 文件]:包含安装日程安排的 XML 文件。
- -i、--install-immediately:分发后立即安装分发包。要使用此选项,还必须指定分发日程安排。使用 --distribution-schedule、--distribute-now 或 --distribute-on-device-refresh 选项可以指定分发日程安排。
- -L、--launch-immediately:安装后立即起动分发包。要使用此选项,还必须指定分发日程安排。使用 --distribution-schedule、--distribute-now 或 --distribute-on-device-refresh 选项可以指定分发日程安排。
- -n、--distribute-now:将分发日程安排设置为立即分发分发包。如果指定此选项,则会忽略 --distribution-schedule 和 --distribute-on-device-refresh 选项。--distribute-now、--distribute-on-device-refresh 和 --distribution-schedule 三个选项相互排斥,它们用于设置分发日程安排。会优先考虑 --distribute-now 选项,然后才是 --distribute-on-device-refresh 和 --distribution-schedule。
- -r、--distribute-on-device-refresh:将分发日程安排设置为在刷新设备时分发分发包。如果指定此选项,则会忽略 --distribution-schedule 选项。
- -s、--launch-on-device-refresh:将起动日程安排设置为在刷新设备时起动分发包。如果指定此选项,则会忽略 --launch-schedule 选项。
- -w、--wakeup-device-on-distribution:如果分发分发包时设备处于关机状态,则使用网络唤醒功能将其唤醒。要使用此选项,还必须指定分发日程安排。使用 --distribution-schedule、--distribute-now 或 --distribute-on-device-refresh 选项可以指定分发日程安排。
- -D、--dry-run:测试并显示请求的操作,但并不实际执行这些操作。
- -B、--broadcast=[广播地址][...]:用于广播网络唤醒魔术包的地址逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。有效值为有效的 IP 地址。
- -S、--server=[相对于 /设备的主服务器对象或代理服务器对象的路径][...]:用于唤醒设备的主服务器对象或代理服务器对象的逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。
- -C、--retries=[重试次数]:向设备发送网络唤醒魔术包的次数。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 0 和 5 之间。默认值是 1。
- -T、--timeout=[重试的时间间隔]:两次重试之间的时间间隔。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 2 和 10(分钟)之间。默认值是 2。
-
workstation-add-policy (wap) (工作站对象路径) (策略或策略组) [...] [选项]
-
将策略指派给工作站对象。
接受下列选项:
- -c、--conflicts=[策略冲突解决顺序]:确定策略冲突的解决方式。有效值为 userlast 或 1、devicelast 或 2、deviceonly 或 3、useronly 或 4。使用 userlast 会先应用与设备关联的策略,然后再应用与用户关联的策略。使用 devicelast 会先应用与用户关联的策略,然后再应用与设备关联的策略。使用 deviceonly 将忽略与用户关联的策略。使用 useronly 将忽略与设备关联的策略。如果未指定此选项,默认会使用 userlast。
- -e、--enforce-now:立即对所有指派的设备实施策略。
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
workstation-copy-relationships (wcr) (工作站路径) (工作站对象路径) [...] [选项]
-
将选定工作站的关系复制到其他工作站。工作站关系包括分发包指派、策略指派和组成员资格。如果未指定值,则会直接为目标文件夹或组建立指派。
接受下列选项:
- -r、--relationship-type:要复制的关系类型。有效值为 、 和 。使用选项 会复制源设备的所有关联分发包指派。使用选项 会复制源设备的所有关联策略指派。使用选项 会将目标设备添加为与源设备关联的组的成员。如果未指定值,则会保留目标设备的现有指派。
- -a、--assignment-options:指派选项。有效值为 、 和 。使用选项 会将指派复制到目标组的成员。使用选项 会将指派复制到目标文件夹中的设备。 选项会将指派复制到目标文件夹及其子文件夹中的设备。
- -c、--conflict-resolution:现有指派的冲突解决选项。有效值为 和 。使用选项 会删除目标设备的所有现有指派。使用选项 会将目标设备的现有指派替换为选定的指派。如果未指定值,则会保留目标设备的现有指派。
- -g、--group-membership:目标对象类型 Groups 和 Folders 的组成员资格选项。有效值为 和 。 选项会将目标对象及其子文件夹中的设备添加为源设备所属组的成员。 选项会删除目标设备的现有组成员资格。如果目标包含组,则这些组的所有成员都将添加为选定组的成员。如果目标包含文件夹,则该文件夹中的所有设备都将以非递归方式添加到选定组。
- -p、--export-path:复制关系结果需导出到的 CSV 格式文件的完整路径。您可以连同扩展名为 .csv 的文件名一起指定文件路径。如果未指定路径,CSV 文件将导出到默认路径(Linux:/var/opt/microfocus/zenworks/tmp;Windows:%zenserver_home%\work\tmp)。
- -f、--continue-on-failure:此选项不是必需的。如果指定此选项,即使发生失败,复制关系操作也将继续执行。如果未指定此选项,发生失败时,复制关系操作将会终止。
示例:
要将源工作站的所有关系复制到多个工作站,请运行以下命令:
zman workstation-copy-relationships workstationfolder/sourceworkstation --relationship-type=bundles,policies,groups workstationfolder/workstation workstationfolder/workstationfolder1 workstationfolder/workstationgroup
要将源工作站的策略指派以递归方式复制到目标工作站文件夹中的工作站,请运行以下命令:
zman wcr workstationfolder/sourceworkstation --relationship-type=bundlesworkstationfolder1 workstationfolder2 -assignment-options=assign-to-group-member,assign-to-folder-members
要在复制源工作站的指派时替换目标工作站的冲突分发包指派,请运行以下命令:
zman wcr workstationfolder/sourceworkstation -r=policies workstationfolder/workstation -conflict-resolution=delete-existing-assignments
要将目标工作站组的工作站添加到源工作站的组,请运行以下命令:
zman wcr workstationfolder/sourceworkstation -r=groups workstationgroup group-membership=add-folder-members-recursively
要将目标工作站组的工作站添加到源工作站的组,同时指定选项和 选项(导出到 C:\temp\ 文件夹),请运行以下命令:
zman wcr workstationfolder/sourceworkstation -r=groups workstationgroup group-membership=add-folder-members-recursively -f -p=C:\temp\
要将源工作站的策略指派以递归方式复制到目标工作站文件夹中的工作站,同时指定“失败时终止”选项和 选项(导出到 C:\temp\copyresult.csv),请运行以下命令:
zman wcr workstationfolder/sourceworkstation --relationship-type=bundlesworkstationfolder1 workstationfolder2 -assignment-options=assign-to-group-member,assign-to-folder-members -p=C:\temp\copyresult.csv
-
workstation-delete (wd) (工作站对象路径) [...] [选项]
-
删除一个或多个工作站对象。
-
会从 ZENworks 服务器上删除与设备关联的所有策略和分发包指派以及库存信息。
-
会从区域中取消注册 ZENworks 代理。
-
不会删除设备上的数据以及从设备中删除或卸装 ZENworks 代理。
-
不会从设备上删除 MDM 配置文件。要删除 MDM 配置文件,请使用取消注册快速任务。
-
不会在安排的下次刷新期间将 MDM 客户端重新注册到区域中。
-
将会在安排的下次刷新期间自动重新注册 ZENworks 代理。但如果启用了 ZENworks 安全配置,则仅当设备上存在授权密钥或者设备已添加到预先批准的列表中时,才会重新注册代理。
(工作站对象路径) [...]:相对于 /设备/工作站的工作站对象(工作站、工作站文件夹或工作站组)路径。对象名称中可以使用通配符 *,但需要将它以引号括住。如果在删除对象时使用通配符,请务必小心。
接受下列选项:
- -r、--recursive:以递归方式删除文件夹中的对象。
- -f、--folder=[工作站文件夹]:相对于 /设备/工作站的工作站文件夹路径。如果指定此选项,工作站对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个工作站对象。
- -p、--preapprove:将已删除设备添加到预先批准的列表中。
- -f、--folder=[工作站文件夹]:相对于 /设备/工作站的工作站文件夹路径。如果指定此选项,工作站对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个工作站对象。
-
workstation-folder-create (wfc) (文件夹名称) [父文件夹] [选项]
-
创建包含工作站的新文件夹。
接受下列选项:
-
workstation-group-add (wga) (工作站组路径) (工作站路径) [...] [选项]
-
将工作站添加到工作站组。
接受下列选项:
- -f、--folder=[工作站文件夹]:相对于 /设备/工作站的工作站文件夹路径。如果指定此选项,工作站对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个工作站对象。
-
workstation-group-create (wgc) (组名) [父文件夹] [选项]
-
创建工作站组并为其添加成员。
接受下列选项:
- --desc=[说明]:组的说明。
- -m、--members=[工作站路径][...]:相对于 /设备/工作站的工作站路径。
- -f、--folder=[工作站文件夹]:相对于 /设备/工作站的工作站文件夹路径。如果指定此选项,工作站对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个工作站对象。
-
workstation-group-members (wgm) [选项] (工作站组路径)
-
列出工作站组或动态工作站组的成员。
接受下列选项:
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
workstation-group-remove (wgr) (工作站组路径) (工作站路径) [...] [选项]
-
从工作站组中去除工作站。
接受下列选项:
- -f、--folder=[工作站文件夹]:相对于 /设备/工作站的工作站文件夹路径。如果指定此选项,工作站对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个工作站对象。
-
workstation-info (wi) (工作站路径)
-
列出有关工作站的详细信息。
-
workstation-list (wl) [文件夹] [选项]
-
列出工作站对象。
接受下列选项:
- -r、--recursive:以递归方式列出结果(包括子文件夹)。如果未指定此选项,则不会列出子文件夹的内容。
- -n、--namefilter=[过滤字符串]:显示符合指定名称的结果。通配符 * 和 ? 可以用引号括住进行使用。
- -t、--typefilter=[类型过滤器][...]:显示与指定对象类型的逗号分隔列表相匹配的结果。有效值为 device、group 和 folder。
- -c、--count:显示结果的计数。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
- -f、--flagfilter=[标志过滤器][...]:显示与指定标志的逗号分隔列表相匹配的结果。有效值为 retired、notretired、test 和 non-test。
-
workstation-list-bundles (wlb) (工作站对象路径) [选项]
-
列出指派给工作站对象的分发包。
接受下列选项:
- -a、--all:同时列出有效分发包和无效分发包。
- -e、--effective:只列出有效分发包。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
workstation-list-groups (wlg) (工作站路径) [选项]
-
列出指定工作站所属的组。
接受下列选项:
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
workstation-list-policies (wlp) (工作站对象路径) [选项]
-
列出指派给工作站对象的策略。
接受下列选项:
- -a、--all:同时列出有效策略和无效策略。
- -e、--effective:只列出有效策略。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
workstation-move (wmv) (工作站对象路径) [目标文件夹路径]
-
将工作站对象移到其他文件夹。
-
workstation-refresh (wrf) (工作站对象路径) [...] [选项]
-
刷新工作站中的 ZENworks 代理。
接受下列选项:
-f、--folder=[工作站文件夹]:相对于 /设备/工作站的工作站文件夹路径。如果指定此选项,工作站对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个工作站对象。
--server=<服务器/服务器文件夹/服务器组对象路径>[...]:相对于 /设备/服务器的主服务器对象(服务器、服务器文件夹或服务器组)路径,用于发送快速任务通知。
--notify=<分钟数>:通知所有设备的分钟数。
--expire=<分钟数>:快速任务创建后到失效前的分钟数。指定 0 会立即失效。
--currentserver:向当前主服务器添加快速任务。
--anyserver:在任何主服务器中添加快速任务。
--expirenever:快速任务在主服务器中从不失效。
-
workstation-remove-bundle (wrb) (工作站对象路径) (分发包或分发包组) [...] [选项]
-
去除指派给工作站对象的分发包。
接受下列选项:
- -f、--folder=[分发包文件夹]:相对于 /分发包的分发包文件夹路径。如果指定此选项,分发包对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个分发包对象。
-
workstation-remove-policy (wrp) (工作站对象路径) (策略或策略组) [...] [选项]
-
去除指派给工作站对象的策略。
接受下列选项:
- -f、--folder=[策略文件夹]:相对于 /策略的策略文件夹路径。如果指定此选项,策略对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个策略对象。
-
workstation-rename (wr) (工作站对象路径) (新名称)
-
重命名工作站对象。
-
workstation-reorder-policies (wrop) (工作站对象路径) (当前位置) (新位置)
-
更改指派给工作站的策略的顺序。使用命令 server-list-policies 可以获取已指派策略的顺序。
-
workstation-retire (wret) (工作站对象路径)
-
在下次刷新所选工作站时会从 ZENworks 系统中淘汰该工作站。淘汰设备不同于删除设备。淘汰设备时,将保留其 GUID(与删除设备相反,删除设备还会删除其 GUID)。因此,所有库存信息均会保留并可访问,但会去除所有策略和分发包指派。如果在将来重新激活设备,将会恢复其指派。
接受下列选项:
- -i、--immediate:强制执行设备刷新以立即淘汰设备。
-
workstation-set-as-test (wsat) (工作站对象路径)
-
将工作站设为测试设备。
示例
将 workstation1 设为测试设备:
zman wsat workstation1
-
workstation-set-as-nontest (wsan) (工作站对象路径)
-
将工作站设为非测试设备。
示例
将 workstation1 设为非测试设备:
zman wsan workstation1
-
workstation-unretire (wuret) (工作站对象路径)
-
在下一次刷新所选工作站时重新激活该工作站,并重新应用该设备先前拥有的所有策略和分发包指派。
接受下列选项:
- -i、--immediate:强制执行设备刷新以立即取消淘汰设备。
-
workstation-view-all-bundles-status (wvabs) (工作站路径) [选项]
-
显示指派给工作站的分发包的高级部署状态。
接受下列选项:
- --statusfilter=[状态类型][...]:按“分发包分发和安装事件”的状态过滤。有效值为“S”、“R”、“C”、“A”、“F”和“P”(成功、部分成功、已完成、部分完成、失败和待处理)。可以提供状态类型的逗号分隔列表。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
示例
查看指派给 workstation1 的分发包的部署状态:
zman wvabs workstation1
查看指派给分发包部署状态为成功或待处理的 workstation1 的分发包的部署状态:
zman wvabs workstation1 --statusfilter S,P
-
workstation-view-all-policies-status (wvaps) (工作站路径) [选项]
-
显示指派给工作站的策略的高级部署状态。
接受下列选项:
- --statusfilter=[状态类型][...]:按“策略应用事件”的状态过滤。有效值为“S”、“F”和“P”(成功、失败和待处理)。可以提供状态类型的逗号分隔列表。
- -s、--scrollsize=[滚动大小]:每次显示的结果数。
-
workstation-wakeup (ww) (工作站对象路径) [...] [选项]
-
使用网络唤醒功能唤醒工作站。
接受下列选项:
- -f、--folder=[工作站文件夹]:相对于 /设备/工作站的工作站文件夹路径。如果指定此选项,工作站对象的路径便会相对于此文件夹来确定。使用此选项可以指定同一文件夹中的多个工作站对象。
- -b、--broadcast=[广播地址][...]:用于广播网络唤醒魔术包的地址逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。有效值为有效的 IP 地址。
- -s、--server=[相对于 /设备的主服务器对象或代理服务器对象的路径][...]:用于唤醒设备的主服务器对象或代理服务器对象的逗号分隔列表。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。
- -C、--retries=[重试次数]:向设备发送网络唤醒魔术包的次数。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 0 和 5 之间。默认值是 1。
- -t、--timeout=[重试的时间间隔]:两次重试之间的时间间隔。仅当您选择使用网络唤醒来唤醒设备时,此选项才可用。值必须在 2 和 10(分钟)之间。默认值是 2。
ZENworks 服务器命令
这些命令用于管理安装了 ZENworks 的服务器。ZENworks 服务器命令的全称以 zenserver- 开头,简称以字母 zs 开头。
-
zenserver-backup (zsb) (文件路径) [通行口令]
-
在另一个“ZENworks 服务器”上备份复制此服务器所需的配置文件。
注:ZENworks2020 Update 2 中已弃用此命令。要备份服务器状态,请改为使用 zen-backup-restore 实用程序,或向此命令添加 --force 标志。有关详细信息,请参见“Backing Up a ZENworks Server”(备份 ZENworks 服务器)。
- (文件路径):要备份“ZENworks 服务器”配置文件的目标文件路径。如果服务器包含嵌入式数据库,请使用 database-backup 命令备份数据库。要在另一个安装的服务器上恢复该服务器,必须先通过 zenserver-restore 命令恢复配置文件,然后再恢复数据库。命令会提示输入通行口令以加密备份文件。请记下指定的通行口令,当您在恢复服务器时需要输入该通行口令。
- [通行口令]:用于加密备份文件的通行口令。该通行口令至少应包含 10 个字符。
-
zenserver-restore (zsr) (文件路径) [通行口令]
-
将损坏的“ZENworks 服务器”的备份配置文件恢复到新安装的“ZENworks 服务器”上。
注:ZENworks2020 Update 2 中已弃用此命令。要恢复服务器状态,请改为使用 zen-backup-restore 实用程序,或向此命令添加 --force 标志。有关详细信息,请参见“Restoring a ZENworks Server”(恢复 ZENworks 服务器)。
- (文件路径):包含要恢复的备份配置文件的文件路径。服务器与要恢复服务器的 DNS 名称和 IP 地址必须相同。命令提示输入通行口令以解密备份文件时,请输入备份文件时使用的加密通行口令。
- [通行口令]:在备份文件时用于加密文件的通行口令。
全局选项
下列选项可应用到任一 zman 命令:
-
-h、--help
-
提供各种级别的帮助。有关使用帮助的其他细节,请参考“使用指南”一节。
-
--usage
-
显示命令的语法。
-
--terse
-
显示简洁输出。
-
--debug
-
显示调试输出。
-
-V
,
--verbose
-
启用冗长输出。
-
--quiet
-
静态输出,只打印错误讯息。
-
-U、--User=<用户名>
-
提供用户名。若未提供,则会提示您提供。
-
-P、--Password=<口令>
-
指定口令。若未提供,则会提示您提供。
-
---host=<主机>
-
指定要连接的主机名或 IP 地址(默认为 localhost)。
-
--port=<端口>
-
指定服务器用于侦听的端口(默认为 443)。
-
--cleartext
-
禁用 SSL 以进行调试。如果未将端口设置为明文端口,默认会连接端口 80。
-
-R、--Redirect=<文件路径>
-
将屏幕输出重定向到文件。对命令行重定向运算符 (>) 使用此选项,以 UTF-8 格式保存数据,并保留非英文字符。
-
-G、--ignore-global-file
-
忽略 zman-config.properties 中指定的全局选项文件。
安全性
运行所有命令都需要具备管理员授权。要避免针对每个命令输入管理员身份凭证,可以使用 admin-store-credential 命令来储存身份凭证。身份凭证会加密,并储存于用户运行命令的操作系统的主文件夹中。身份凭证只适用于该登录用户。在执行完其他命令后,通过运行 admin-clear-credential 命令清除信息是较为安全的做法。
重要说明:虽然提供了输入用户名和口令的命令行选项,不过还是要避免使用这些选项。在 Linux 中,这些选项显示于 ps 列表中。此外,按向上箭头或向下箭头按键可以显示先前在 Windows 和 Linux 中输入的命令。可以在出现提示时输入身份凭证,也可以使用 admin-store-credential 命令。
文件
zman-config.properties 是用于配置 zman 的属性文件,它位于以下位置:
可用的选项有:
-
-
例如:
GLOBAL_OPTIONS_FILE=C:\\zman\\globaloptions.txt
文件的示例内容如下所示:
--host=123.34.45.56 --port=8080 -cleartext --verbose
要跳过此文件中储存的选项,请使用 -ignore-global-file 选项。可以在全局选项文件中储存所有全局选项(-U|--User 和 -P|--Password 除外)。应使用 admin-store-credential 和 admin-clear-credential 命令将管理员身份凭证添加到每个命令。有关使用管理员身份凭证的指南,请参考“安全性”一节。
-
-
退出代码
zman 会返回介于 0 到 255 之间的退出代码。0 表示命令执行成功;1-255 表示执行时出错。
语法分析错误的退出代码:
- 1 - 发生了未知的语法分析错误。
- 2 - 未指定强制自变量。
- 3 - 指定了未知标志。
- 4 - 为开关参数指定了值。
- 5 - 标志选项未指定值。
- 6 - 指定了意外的附加自变量。
- 7 - 指定的值无效。
- 8 - 无法将值转换为预期类型。
- 9 - 未知命令。
- 10 - 至少需要输入一个选项,但未输入任何选项。例如,要修改权限,至少需指定“指派”选项或“撤消”选项。
一般错误的退出代码:
- 11 - 发生了未知的错误。
- 12 - 由于缺少一个依赖的 zman jar 文件,此功能不可用。
- 13 - 鉴定失败。
- 14 - 为用户名或口令指定了空字符串,或指定的口令不符合最短长度的要求。
- 15 - ZENworks 许可证已失效。
- 16 - 连接失败。数据库服务器可能已关闭。
- 17 - ZENworks 管理员权限不足,无法执行此操作。
- 18 - 无法读取用于建立 SSL 通讯的证书。
- 19 - 该命令只能在本地主机上运行。
与对象相关的一般错误的退出代码:
- 21 - 指定的对象不是预期类型。例如,指定了分发包而非设备。
- 22 - 找不到对象。
- 23 - 指定文件夹中已存在相同名称的对象。
- 24 - 指定的对象不在指定的文件夹中,而是位于其他目录。
- 25 - 不得将父文件夹移至其子文件夹。
- 26:不得重命名该对象。
- 27 - 不得删除该对象。
- 28 - 尝试删除非空文件夹。
- 29 - 该对象已属于该组。
- 30 - 该对象不属于该组。
- 31 - 已将该对象指派给设备或用户。
- 32 - 尚未将该对象指派给设备或用户。
- 33 - 对象类型无效,无法将其指派给设备或用户。
- 34 - 不允许将对象指派给设备。例如,无法将用户特定的策略指派给设备。
其他一般错误的退出代码:
- 41 - 指定的名称无效。例如,对象名称中不能包含特殊字符(如 * 或 %)。
- 42 - 绝对路径应该以正斜杠 (/) 开头。
- 43 - 指定了无效的日程安排。
- 44 - XML 文件未包含预期输入。例如,需要输入的是导出的分发包 XML 文件,却将导出的操作集 XML 文件指定为输入。
- 45 - XML 文件不符合预期纲要。
- 46 - 指定了的 GUID 无效。
- 47 - 指定的值超出最大长度。
- 48 - 未指定依赖自变量。例如,命令使用此选项可在分发时即安装分发包,但不指定分发日程安排。
与文件相关的错误的退出代码:
- 61 - 需要目录。
- 62 - 该文件不存在,或者是一个目录。
- 63 - 该文件已存在。
- 64 - 读取文件时出错。
- 65 - 写入文件时出错。
- 66 - 创建文件时出错。
- 67 - 创建目录时出错。
- 68 - 复制文件时出错。
- 69 - 上载文件时出错。
- 70 - 目标设备上的磁盘空间不足,无法装载该文件。
专用于注册命令的退出代码:
- 71 - 与注册密钥或规则集关联的文件夹和组的设备类型不相同。
- 72 - 规则集至少应包含一个规则。
分发包和策略命令的常用退出代码:
- 76 - 内容创建失败。
- 77 - 将内容文件复制到临时目录的操作被取消,因为存在同名文件。
- 78 - 在非“内容服务器”上尝试使用文件内容创建分发包或策略。
专用于分发包命令的退出代码:
- 81 - 为分发包图标指定的文件不是有效的图像文件。
- 82 - 该操作集不包含任何要重新排序、去除或导出的操作。
- 83 - 该操作集不包含任何要在指定位置处重新排序、去除或导出的操作。
- 84 - 该分发包类型不支持该操作集。例如,Windows 分发包不支持“预引导”操作集。
- 85 - 该操作集不支持该操作。例如,“安装”操作集不支持“校验分发包”操作。
- 86 - 不得删除该操作。
- 87 - 操作类型必须唯一;您不得将同一个操作类型多次添加到操作集。
- 88 ‑ 该操作类型不支持依赖分发包。例如,不能为“安装 MSI”操作指定依赖分发包路径。
- 89 - 指定的依赖分发包路径导致分发包循环依赖。
- 90 - 指派分发包时无法创建 Wake-On-LAN 日程安排。
- 91 - 取消分发包指派时无法去除 Wake-On-LAN 日程安排。
设备和用户命令的常用退出代码:
- 101 - 设备或用户没有任何关联的分发包或策略。
专用于用户命令的退出代码:
- 106 - 用户来源证书已失效。
- 107 - 需要 SSL 以连接“用户来源”。
专用于许可证命令的退出代码:
- 116 - 无法激活许可证。
- 118 - 服务器没有“证书授权者”角色。
- 119 - 服务器没有启用“证书授权者”角色所需的文件。
- 120 - 所使用的“证书授权者”不是“ZENworks 内部证书授权者”。
专用于管理员的命令的退出代码:
专用于数据库命令的退出代码:
- 126 - 该数据库不是嵌入式数据库。
- 127 - SQL 语句无效。
- 128 - 遇到 SQL 异常。
专用于部署命令的退出代码:
- 131 - 指定的 IP 地址或主机名无效。
- 132 - 未指定连接设备所需的身份凭证。
- 133 - 指定的受管设备或设备已安排了部署日程。
专用于报告命令的退出代码:
- 136 - 无法删除报告。
- 137 - 无法提交生成报告的请求。
- 138 - 无效的报告文档。
ZeUS 命令
zman zeus 命令用于将最新的 ZeUS MSI 导入区域,并获取当前的 ZeUS 配置。
-
zeus-msi-config | zmc
-
指定最后导入的 ZeUS msi 的配置。
-
zeus-msi-import | zmi (ZeUS MSI 的路径) [-f|--force]
-
将最新的 ZeUS MSI 导入区域。
(ZeUS MSI 的路径):提供 ZeUS 目录的完整路径。
接受下列选项:
-f、--force:即使 MSI 版本相同,也重新导入 MSI。这会重写服务器中的当前 zeus 配置。
-
zac zeus-refresh / zeus-ref
-
如果系统更新指派给设备,将检索系统更新。
注意:这不是 ZMAN 命令。