搜索 <book_title>...

NetBackup™ for VMware 管理指南

Last Published: 2022-10-28

Product(s): NetBackup (10.1)

查询生成器字段参考

您可以使用查询生成器输入为备份自动选择 VMware 虚拟机的规则。

注意:

可以使用 NetBackup Web UI 配置和管理 VMware 策略。在 Web UI 中，查询生成器的高级模式使用 OData 关键字和运算符。否则，查询生成器的运行方式与在 NetBackup 管理控制台中的运行方式相同。

表：查询生成器下拉选项。联接、字段、运算符、值介绍了查询生成器中用于创建规则的下拉字段和选项。

表：查询生成器下拉选项。联接、字段、运算符、值

查询生成器下拉字段	描述
联接	选择用来联接规则的连接符。对于第一条规则，选择为空（无）或 NOT。添加规则后，可用连接符有 AND、AND NOT、OR、OR NOT。
字段	选择构建规则时所基于的参数。从列表中选择一个参数（向下滚动可查看其他参数）。您可以键入第一个字符以加快选择。例如，输入 d 后，列表将移动到以 d 开头的第一个条目。再次输入 d，列表将移动到以 d 开头的下一个条目。会自动填入选定的条目。请参见表：“字段”下拉列表中的关键字。
运算符	选择运算符。可用的运算符取决于为“字段”选择的参数。请参见表：“运算符”下拉列表中的运算符。
值	为“字段”参数指定值。 “值”字段允许手动输入。该字段也可能是一个下拉字段，具体取决于在其他字段中所做的选择。手动输入时，可以指定多个以逗号分隔的值。请参见表：“值”中可以输入的字符。
	允许浏览以查找特定值，具体取决于在其他下拉字段中所做的选择。
	将当前下拉选择添加到“查询”窗格中作为新的规则。
	删掉下拉字段。

字段（关键字）

表：“字段”下拉列表中的关键字介绍了“字段”下拉列表中可用的关键字。该表还指明了每个关键字的值（在“值”字段中）是否区分大小写。

注意:

仅当在查询生成器下使用 NetBackup Web UI 的高级模式或者使用 NetBackup API 构建查询时，才使用 OData“字段”关键字。

请记住，“字段”关键字不能独自确定虚拟机的包括或排除，而是取决于您构建的规则：联接、字段、运算符和值的组合。

表：“字段”下拉列表中的关键字

字段关键字	OData 字段关键字	数据类型	描述
Annotation	annotation	字母数字字符串	添加到 vSphere Client 的虚拟机注释中的文本。值区分大小写。
AssetGroup	assetGroup		新增
Cluster	cluster	字母数字字符串	在其中配置虚拟机的群集（一组 ESX Server）的名称。值不区分大小写。注意: 虚拟机可以分配到不在群集中的 ESX Server。另请注意，在 VMware 中，群集名称只需在数据中心路径内唯一。
Datacenter	datacenter	字母数字字符串	VMware Datacenter 的名称。值不区分大小写。
DatacenterPath	datacenterPath	字母数字字符串	用于定义数据中心路径的文件夹结构。如果您要过滤的数据中心名称在环境中不唯一，请使用此选项。值区分大小写。
Datastore	datastoreName	字母数字字符串	DataStore 的名称。值区分大小写。注意: 多个 ESX Server 可以共享对同一 DataStore 的访问权限。另外，DataStore 名称在多个 ESX Server 中可以是重复的。使用 DatacenterPath 或 ESXserver 来唯一地标识数据中心。
DatastoreCluster	datastoreCluster	字母数字字符串	包含 DataStore 的 DataStore 群集的名称。值不区分大小写。
DatastoreFolder	datastoreFolder	字母数字字符串	包含 DataStore 的文件夹的名称。值不区分大小写。
DatastoreNFSHost	datastoreNfsHost	字母数字字符串	DataStore 的 NFS 主机的名称。值不区分大小写。
DatastoreNFSPath	datastoreNfsPath	字母数字字符串	用于定义 NFS DataStore 路径的文件夹结构。如果您要过滤的 DataStore 的 NFS 主机名称在环境中不唯一，请使用此选项。值不区分大小写。
DatastoreType	datastoreType	字母数字字符串	DataStore 的类型。值为 NFS、NFS41、VMFS、vsan 和 VVOL。值不区分大小写。
Displayname	displayName	字母数字字符串	虚拟机的显示名称。值区分大小写。
ESXserver	host	字母数字字符串	ESX Server 的名称。值不区分大小写。 ESX 主机名必须与 vCenter Server 中定义的名称匹配。
HostFolder	hostFolder	字母数字字符串	数据中心级别和群集、ESX 主机或子文件夹之间的文件夹路径。如果 ESX 群集未包含在文件夹中，当单击浏览值按钮时，请注意：ESX 群集名称会出现在“从列表中选择”对话框中。值不区分大小写。请参见数据中心文件夹（主机文件夹）的查询规则。
InstanceUUID	instanceUuid	字母数字字符串	虚拟机的实例 UUID。查询示例: InstanceUUID Equal "501b13c3-52de-9a06-cd9a-ecb25aa975d1" 值不区分大小写。
Network	network	字母数字字符串	网络交换机（在 ESX Server 上）或分布式交换机的名称。值不区分大小写。
NetworkFolder	networkFolder	字母数字字符串	包含网络的文件夹的名称。值不区分大小写。
Powerstate	powerState	字母	虚拟机的电源状态。值为 poweredOff、poweredOn 和 suspended。
Resourcepool	resourcePool	字母数字字符串	资源池的名称。（资源池类似于 vApp。）值区分大小写。如果资源池中包含其他资源池（子池），则运算符选择将确定是否包括子池中的虚拟机。请参见资源池的查询规则。
Tag	tagName	字母数字字符串	标记的名称。值区分大小写。当 NetBackup 使用标记选择虚拟机时，所选内容仅基于标记名称。所选内容与类别无关。请参见标记的查询规则。
Template	template	布尔值	如果虚拟机为虚拟机模板，则为 TRUE。
vApp	vApp	字母数字字符串	vApp 的名称。值区分大小写。 vApp 是虚拟机的集合。vApp 也可以包含资源池和其他 vApp。vApp 是独立 ESX Server 或群集的组件。与 vSphere Client 一样，NetBackup 仅引用包含子 vApp 的 vApp 的顶层。对于下列规则： vApp Equal "vapp1" 如果 vapp1 具有名为 vapp2 的子 vApp，则会包括 vapp1 或 vapp2 中的所有虚拟机。您无法制定专门引用 vapp2 的规则。
vCDCatalog	vcdCatalog	字母数字字符串	vCloud Director 目录库的名称。值不区分大小写。
vCDIsExpired	vcdIsExpired	字母	如果 vCloud Director vApp 或 vApp 模板已失效，则为“已失效”。可能的值为“已失效”、“未失效”和“未知”。“未知”表示在 vCloud Director 和 vSphere 环境之间发生错误。例如在置备或删除操作中发生错误。
vCDIsvAppTemplate	vcdIsvAppTemplate	布尔值	如果 vCloud Director vApp 是模板，则为 TRUE。
vCDOrg	vcdOrg	字母数字字符串	vCloud Director 组织的名称。值不区分大小写。
vCDOrgvDC	vcdOrgvDC	字母数字字符串	vCloud Director 中的组织虚拟数据中心的名称。值不区分大小写。
vCDServer	vcdServer	字母数字字符串	vCloud Director 服务器的名称。值不区分大小写。
vCDvApp	vcdVapp	字母数字字符串	vCloud Director vApp 的名称。值不区分大小写。
vCenter	vCenter	字母数字字符串	vCenter Server 的名称。值不区分大小写。查询生成器中指定的 vCenter 名称必须与在 NetBackup 管理控制台的凭据中输入的名称匹配。（“介质和设备管理”>“凭据”>“虚拟机服务器”。）请注意，建议使用完全限定的域名。
vCenterVersion	vCenterVersion	字母数字字符串	vCenter Server 的版本。例如：5.1.0、5.5.0、6.0.0 此字段的可能值根据环境自动更新和填充。仅显示已向 NetBackup 注册的 vCenter Server 的版本。
VMDNSName	dnsName	字母数字字符串	vSphere Client 中的虚拟机 DNS 名称。值不区分大小写。
VMFolder	vmFolder	字母数字字符串	（数据中心内）VM 文件夹的名称，包括包含 VM 的文件夹的路径。值不区分大小写。例如，假设以下 VM 文件夹总共包含 65 个 VM： vm\VM_backup_prod1 (contains 5 VMs) vm\VM_backup_prod1\cluster1 (contains 10 VMs) vm\VM_backup_prod2 (contains 50 VMs) 要将 VM 包括在 `vm\VM_backup_prod1` 而非 `cluster1` 或任何其他文件夹中，请输入以下命令： VMFolder Equal “vm\VM_backup_prod1” 要将 VM 包括在 `vm\VM_backup_prod1` 及其子文件夹 `cluster1` 中，请输入以下命令： VMFolder Equal “vm\VM_backup_prod1” OR VMFolder StartsWith “vm\VM_backup_prod1\\” 注意: 第一个反斜杠是转义符，会导致下一个反斜杠被解释为文本字符。要包括所有 65 个 VM，请输入以下命令： VMFolder StartsWith “vm\VM_backup_prod” 注意: 以 `vm\VM_backup_prod` 开头的路径中的所有 VM 都将包括在内。
VMGuestOS	vmGuestOs	字母数字字符串	vSphere Client 中记录的虚拟机访客操作系统类型。值区分大小写。
VMHasIDE	vmHasIde	布尔值	如果虚拟机具有 IDE 驱动器，则为 TRUE。
VMhasIndD	vmHasIndD		新增
VMHasMDS	vmHasMds	布尔值	如果虚拟机具有多个 DataStore，则为 TRUE。可以使用此关键字来选择配置为使用多个 DataStore 的任一虚拟机。
VMHasNVME	vmHasNvme	布尔值	如果虚拟机具有 NVMe 驱动器，则为 TRUE。
VMHasRDM	vmHasRdm	布尔值	如果虚拟机使用原始设备映射 (RDM)，则为 TRUE。
VMHasRDMO	vmHasRdmo		新增
VMHasSATA	vmHasSata	布尔值	如果虚拟机具有 SATA 驱动器，则为 TRUE。
VMHasSnap	VMHasSnap	布尔值	如果虚拟机的 VMware 快照当前处于活动状态，则为 TRUE。
VMHasVDSName	vmHasVdsName	布尔值	如果虚拟机的显示名称可用作有效的主机名，则为 TRUE。
VMHostName	hostName	字母数字字符串	通过对虚拟机 IP 地址进行反向查找得到的虚拟机名称。值不区分大小写。
VMIsConn	vmIsConn	布尔值	如果虚拟机已连接并可用，则为 TRUE。例如：如果虚拟机的 ESX Server 已关闭，则该虚拟机未连接。
VMVersion	vmVersion	字母数字字符串	虚拟机的 VMware 版本。值区分大小写。例如：vmx-04、vmx-07、vmx-08。
VMXDatastore	vmxDatastore	字母数字字符串	VMX DataStore（有时称为 VMX 目录或配置 DataStore）的名称。值区分大小写。我们提供了有关 VMX DataStore 的更多信息。请参见NetBackup for VMware 术语。
VMXDatastoreFolder	vmxDatastoreFolder	字母数字字符串	包含 vmx DataStore 的文件夹的名称。值不区分大小写。
VMXDatastoreNFSHost	vmxDatastoreNfsHost	字母数字字符串	vmx DataStore 的 NFS 主机的名称。值不区分大小写。
VMXDatastoreNFSPath	vmxDatastoreNfsPath	字母数字字符串	定义 vmx NFS DataStore 路径的文件夹结构。如果您要过滤的 DataStore 的 NFS 主机名称在环境中不唯一，请使用此选项。值不区分大小写。
VMXDatastoreType	vmxDatastoreType	字母数字字符串	vmx DataStore 的类型。值是 NFS 或 VMFS。值不区分大小写。
[vSphere 自定义属性]	[vSphere 自定义属性]	字母数字字符串	在 vSphere Client 中为一个或多个虚拟机设置的自定义属性的值。注意：在 vSphere Client 中，该属性必须有一个值与至少一个虚拟机对应。属性类型必须是虚拟机。这些值区分大小写。基于自定义属性的磁盘排除要求您在 NetBackup 中输入 vCenter Server 的凭据，或输入托管 VM 的服务器的凭据。ESXi Server 凭据不足。请参见为 VMware 添加 NetBackup 凭据。

运算符

表：“运算符”下拉列表中的运算符介绍了“运算符”下拉列表中的可用运算符。请注意，在某些情况下，NetBackup 管理控制台中使用的运算符与 NetBackup Web UI 中使用的运算符不同。

注意:

仅当在查询生成器下使用 NetBackup Web UI 的高级模式或者使用 NetBackup API 构建查询时，才使用 OData 运算符。

表：“运算符”下拉列表中的运算符

运算符	OData 运算符	描述
AnyOf（NetBackup 管理控制台） In (NetBackup web UI)	in	匹配“值”字段中的任一指定值。例如：如果“值”字段中的 ESX Server 为 ESX01、ESX02 和 ESX03，则 AnyOf 与具有这些名称之一的任何 ESX Server 匹配。如果您服务器的名称与所有指定值均不同，则没有匹配。名为 ESX01A 的服务器不匹配。
Contains	contains	匹配“值”字段中字符串内出现该值的值。例如：如果“值”条目是 dev，则 Contains 将匹配类似于 01dev、01dev99、devOP 和 Development_machine 的字符串。
EndsWith	endswith	匹配“值”字段中出现在字符串结尾的值。例如：如果“值”条目是 dev，EndsWith 将匹配字符串 01dev 而非 01dev99、devOP 或 Development_machine。
Equal	eq	仅匹配“值”字段中指定的值。例如：如果要搜索的显示名称是 VMtest27，Equal 将匹配类似于 VMTest27、vmtest27 或 vmTEST27 等虚拟机名称。名称 VMtest28 不匹配。
Greater	gt	根据 UTF-8 排序序列匹配大于指定“值”的所有值。
GreaterEqual	ge	根据 UTF-8 排序序列匹配大于或等于指定“值”的所有值。
IsSet（NetBackup 管理控制台） NotEqual nullIn (NetBackup Web UI)	ne null	确定是否为“字段”关键字返回某个值。将 IsSet 与作为条件的另一规则一起使用，以确保查询选择适当的虚拟机。请注意，对于使用 IsSet 的规则，请勿在“值”下增加条目。请参见查询中的 IsSet 运算符。请参见“主 VM 标识符”参数对测试查询结果中的“选择”列的影响。请参见测试查询：失败的虚拟机。
Less	lt	根据 UTF-8 排序序列匹配小于指定“值”的所有值。
LessEqual	le	根据 UTF-8 排序序列匹配小于或等于指定“值”的所有值。
NotEqual	ne	匹配不等于“值”字段中指定的值的所有值。
StartsWith	startswith	匹配“值”字段中出现在字符串开头的值。例如：如果“值”条目是 box，StartsWith 将匹配字符串 box_car 而非 flatbox。

值

表：“值”中可以输入的字符介绍了可以在“值”字段中输入的字符。“字段”关键字决定了是否区分大小写。

注意:

您在“值”字段中输入的字符串必须括在单引号或双引号内。

表：“值”中可以输入的字符

字符类型	允许的字符串字符
字母数字	A 到 Z、a 到 z、0 到 9、-（减号）和特殊字符。注意: 仅十进制数。
通配符	（星号）匹配一切。例如：prod* 与前后跟任意字符的字符串 prod 匹配。 ? （问号）匹配任意单个字符。例如：prod?? 与后跟两个任意字符的字符串 prod 匹配。
转义符	\（反斜杠）转义其后面的通配符或元字符。例如：要搜索包含星号的字符串（例如 test），请输入 test\
引号	注意。您在“值”中输入的字符必须括在单引号或双引号内。要搜索包含引号的字符串，请转义每个引号 (\") 或者将整个字符串括在一对与包含的引号不同的引号中间。例如：要搜索包括双引号的字符串（例如 "name"），请输入 '"name"'（将其括在单引号内）或 \"name\"