搜索 <book_title>...

NetBackup™ 命令参考指南

Last Published: 2025-10-28

Product(s): NetBackup (11.0.0.1)

介绍
附录 A. NetBackup 命令
1. acsd
2. backupdbtrace
3. backuptrace
4. bmrc
5. bmrconfig
6. bmrepadm
7. bmrprep
8. bmrs
9. bmrsrtadm
10. bp
11. bparchive
12. bpbackup
13. bpbackupdb
14. bpcatarc
15. bpcatlist
16. bpcatres
17. bpcatrm
18. bpcd
19. bpchangeprimary
20. bpcleanrestore
21. bpclient
22. bpclimagelist
23. bpclntcmd
24. bpclusterutil
25. bpcompatd
26. bpconfig
27. bpdbjobs
28. bpdbm
29. bpdgclone
30. bpdown
31. bpduplicate
32. bperror
33. bpexpdate
34. bpfis
35. bpflist
36. bpgetconfig
37. bpgetdebuglog
38. bpimage
39. bpimagelist
40. bpimmedia
41. bpimport
42. bpinst
43. bpkeyfile
44. bpkeyutil
45. bplabel
46. bplist
47. bpmedia
48. bpmedialist
49. bpminlicense
50. bpnbat
51. bpnbaz
52. bppficorr
53. bpplcatdrinfo
54. bpplclients
55. bppldelete
56. bpplinclude
57. bpplinfo
58. bppllist
59. bpplsched
60. bpplschedrep
61. bpplschedwin
62. bppolicynew
63. bpps
64. bprd
65. bprecover
66. bprestore
67. bpretlevel
68. bpschedule
69. bpschedulerep
70. bpsetconfig
71. bpstsinfo
72. bpstuadd
73. bpstudel
74. bpstulist
75. bpsturep
76. bptestbpcd
77. bptestnetconn
78. bpup
79. bpverify
80. cat_convert
81. cat_export
82. cat_import
83. configureCerts
84. configureMQ
85. configureWebServerCerts
86. create_nbdb
87. csconfig cldinstance
88. csconfig cldprovider
89. csconfig meter
90. csconfig reinitialize
91. csconfig throttle
92. duplicatetrace
93. importtrace
94. jbpSA
95. jnbSA
96. ltid
97. mklogdir
98. msdpcldutil
99. msdpimgutil
100. nbauditreport
101. nbcallhomeproxyconfig
102. nbcatsync
103. NBCC
104. NBCCR
105. nbcertcmd
106. nbcertupdater
107. nbcldutil
108. nbcmdrun
109. nbcomponentupdate
110. nbcplogs
111. nbcredkeyutil
112. nbdb_admin
113. nbdb_backup
114. nbdb_move
115. nbdb_ping
116. nbdb_restore
117. nbdb_unload
118. nbdb2adutl
119. nbdbms_start_server
120. nbdbms_start_stop
121. nbdc
122. nbdecommission
123. nbdelete
124. nbdeployutil
125. nbdevconfig
126. nbdevquery
127. nbdiscover
128. nbdna
129. nbemm
130. nbemmcmd
131. nbepicfile
132. nbfindfile
133. nbfirescan
134. nbfp
135. nbftadm
136. nbftconfig
137. nbgetconfig
138. nbhba
139. nbholdutil
140. nbhostidentity
141. nbhostmgmt
142. nbhsmcmd
143. nbhypervtool
144. nbidpcmd
145. nbimageshare
146. nbinstallcmd
147. nbjm
148. nbkmiputil
149. nbkmscmd
150. nbkmsutil
151. nblogparser
152. nbmariadb
153. nbmysql
154. nbmlb
155. nborair
156. nboracmd
157. nbpem
158. nbpemreq
159. nbmariadb
160. nbmlb
161. nbperfchk
162. nbpgsql
163. nbplupgrade
164. nbrb
165. nbrbutil
166. nbreplicate
167. nbrepo
168. nbrestorevm
169. nbseccmd
170. nbserviceusercmd
171. nbsetconfig
172. nbshvault
173. nbsmartdiag
174. nbsnapimport
175. nbsnapreplicate
176. nbsqlcmd
177. nbsqlite
178. nbstl
179. nbstlutil
180. nbstop
181. nbsu
182. nbsvrgrp
183. netbackup_deployment_insights
184. resilient_clients
185. restoretrace
186. stopltid
187. tiermover
188. tldd
189. tldcd
190. tpautoconf
191. tpclean
192. tpconfig
193. tpext
194. tpreq
195. tpunmount
196. verifytrace
197. vltadm
198. vltcontainers
199. vlteject
200. vltinject
201. vltoffsitemedia
202. vltopmenu
203. vltrun
204. vmadd
205. vmchange
206. vmcheckxxx
207. vmd
208. vmdelete
209. vmoprcmd
210. vmphyinv
211. vmpool
212. vmquery
213. vmrule
214. vmupdate
215. vnetd
216. vssat
217. vwcp_manage
218. vxlogcfg
219. vxlogmgr
220. vxlogview
221. W2KOption

名称

nbhostmgmt — 用于管理主机 ID-主机名映射

大纲

nbhostmgmt -add -hostid hostid | -host host -mappingname mappingname [-isshared] [-reason reason] [-server master_server]

nbhostmgmt -addhost -host host [-reason reason] [-server master_server]

nbhostmgmt -allowautoreissuecert -hostid hostid | -host host -autoreissue 0|1 [-reason reason] [-server master_server]

nbhostmgmt -delete -hostid hostid | -host host -mappingname mappingname [-reason reason] [-server master_server]

nbhostmgmt -addcomment -hostid hostid | -host host -comment comment [-server master_server]

nbhostmgmt -deletecomment -hostid hostid | -host host [-server master_server]

nbhostmgmt -updatehost -hostid hostid | -host host -newhostname newhostname [-reason reason] [-server master_server]

nbhostmgmt -decommissionhost -hostid hostid | -host host -reason "reason" [-force] [-json | -json_compact]

nbhostmgmt -help

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/

On Windows systems, the directory path to this command is install_path\NetBackup\bin\admincmd\

描述

nbhostmgmt 命令用于管理主机 ID 到主机名或 IP 地址的映射。可以使用该命令执行以下操作：

通过备用名称标识主机。
将这些备用名称映射到相应的主机 ID。
添加、删除和列出映射。
停用客户端主机。

只有 root 用户可以运行此命令。

必须先运行 bpnbat –login –loginType WEB 命令，然后再运行 nbhostmgmt 命令。bpnbat 命令将对 Web 服务登录进行身份验证。

选项

-add | -a

使用此选项可添加和批准指定主机的主机 ID-主机名或 IP 地址映射。

注意:

使用 -add（不带 -isshared 选项）来添加第一个共享。使用 -isshared 选项添加所有其他共享。

-addcomment | -ac

使用此选项为主服务器主机添加注释。您可以使用 nbhostmgmt -list 选项查看注释。添加的注释仅与主服务器主机关联，而不与已映射的备用主机名关联。不能编辑注释。您仅可以重写或删除现有注释。

-ah | -addhost

使用此选项在主机数据库中添加主机。

使用该选项可以添加主机条目，以便 NetBackup 管理员能够设置 autoreissue 参数。利用 autoreissue 参数，无需重新发布令牌即可在主机上部署证书。在自动映像同步复制 (AIR) 设置的 Bare Metal Restore 过程中，必须在目标域的主机数据库中添加主机条目。

除了 Bare Metal Restore AIR 设置等特定情况之外，Cohesity 不建议手动添加主机。

-aa | -allowautoreissuecert

使用此选项可为指定的主机或主机 ID 设置 autoreissue 参数。利用 autoreissue 参数，无需重新发布令牌即可在主机上部署证书。autoreissue 参数仅与主服务器主机名关联，而不与已映射的备用名称关联。

-approved |-ap

使用此选项可列出已批准的已映射主机名或 IP 地址。

-comment | -c: 使用此选项来指定您要添加到主服务器主机的注释的内容。您必须指定主机或主机 ID 以添加注释。如果注释包含空格，则必须用双引号 ("...") 将注释括起来。comment 字段长度限于 2048 个字符。

-conflict | -cf: 使用此选项可列出其条目与其他映射冲突的已映射主机名或 IP 地址。

-decommissionhost | -dh: 使用此选项可从 NetBackup 域中停用客户端主机。

-delete | -d: 使用此选项可删除主机 ID-主机名或 IP 地址映射。

-deletecomment | -dc

使用此选项来删除指定主机或主机 ID 的注释。此选项删除与主服务器主机关联的注释。

如果您尝试使用 nbhostmgmt-deletecomment 选项删除主机的不存在注释，nbauditreport 会针对成功的更新显示一个相应的条目。

-force: 使用此选项可强制执行停用操作。

-help | -h: 显示命令行用法消息。

-host | -n

指定主服务器主机名或备用的映射主机名或 IP 地址。对于 add 和 delete 操作，请确保备用的映射主机名或 IP 地址与单个主机 ID 关联。

对于停用操作，指定要停用的客户端主机名。

-hostid | -i: 指定 NetBackup 主机 ID。

-isshared | -is: 表示要将映射名称添加为共享映射。
注意:
使用 -add（不带 -isshared 选项）来添加第一个共享。使用 -isshared 选项添加所有其他共享。

-json | -j: 此选项跨多行以 json 格式生成数据。

-json_compact | -jc: 此选项在单行中以 json 格式生成数据

-list | -li: 使用此选项基于不同的过滤器列出已映射的主机名或 IP 地址。可以基于已批准、待批准和存在冲突的名称或地址列出主机名或 IP 地址。

-mappingname | -hm: 指定要添加或删除的主机名或 IP 地址。

-newhostname | -nh: 指定待更新主机的新的主服务器主机名。

-pending | -p: 使用此选项可列出待批准的已映射主机名或 IP 地址。

-reason | -r: 使用此选项可指定执行命令操作的原因。输入的字符串将被捕获并显示在审核报告中。请用双引号 ("...") 将此字符串括起来。reason 字段长度限于 512 个字符。该字符串不能以短划线字符 (-) 开头，也不能包含单引号 (') 字符。

-server | -s: 表示需要建立通信的 NetBackup 主服务器的名称。-server 选项的默认值是 bp.conf 文件中列出的第一个服务器名称。

-short | -l: 使用此选项仅列出主机 ID 和已映射的主机名。

-updatehost | -uh: 使用此选项可更新主机的主服务器主机名。

示例

示例 1：添加主机 ID-主机名映射。

#nbhostmgmt –add -hostid 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 
–mappingname testhost1
testhost1 is successfully mapped to 
0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0.

示例 2：使用主机名添加主机 ID-主机名映射。

#nbhostmgmt -add -host testhost1 -mappingname testhost2
testhost2 is successfully mapped to 
0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0.

示例 3：批准待定映射。此示例显示了已映射主机名 host3 的 testhost3 映射的批准过程。

#nbhostmgmt –add -host host3 –mappingname testhost3
testhost3 is successfully updated.

示例 4：使用主机 ID 从主机名映射中删除主机 ID。

#nbhostmgmt –delete -hostid 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0
–mappingname testhost1
Mapping between testhost1 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0
 is removed.

示例 5：使用主机从主机名映射中删除主机 ID。

#nbhostmgmt –delete -host fs001 –mappingname testhost4
Mapping between testhost4 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0
 is removed.

示例 6：使用指定主服务器中的主机从主机名映射中删除主机 ID。

#nbhostmgt -delete -server nbmaster01 -host fs001 -mappingname
 testhost3
Mapping between testhost3 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0
 is removed.

示例 7：使用主机名停用主机。

#nbhostmgmt -dh -host testhost1 -reason "Protected by different primary"

示例 8：使用主机 ID 停用主机。

#nbhostmgmt -decommissionhost -hostid 0a0aa0a0-0000-0aa0-aa00-
000a0a00a0a0 -reason "Protected by different primary"

另请参见

请参见bpnbat(1m)。