命令行界面

的xeCLI使您能够编写脚本并自动执行系统管理任务。通过CLI将Citrix Hypervisor集成到现有IT基础设施中。

安装xe命令行

xe命令行接口默认安装在所有Citrix Hypervisor服务器上，并包含在XenCenter中。Linux也可以使用独立的远程CLI。

在Windows上

在Windows上，xe.exe命令与XenCenter一起安装。

要使用xe.exe命令，打开Windows命令提示符并将目录更改为xe.exe文件的位置(通常为C:\Program Files\Citrix\XenCenter）.如果你加上xe.exe安装位置到您的系统路径，您可以使用该命令，而不必更改到该目录。

在Linux上

在基于RPM的发行版(如Red Hat)上，您可以从命名为client_install / xapi-xe-BUILD.x86_64.rpm在主Citrix Hypervisor安装ISO上。

要从RPM安装，使用以下命令:

rpm -ivh xapi-xe-BUILD.x86_64。rpm < !——NeedCopy >

可以通过命令行参数定义执行xe命令时使用的Citrix Hypervisor服务器、用户名和密码。但是，您还可以选择将此信息设置为环境变量。例如:

export XE_EXTRA_ARGS="server=<主机名>，username=<用户名>，password=<密码>" 

注意:

当试图通过安全连接运行命令时，Linux上的远程xe CLI可能会挂起，这些命令涉及文件传输。如果是，您可以使用——no-ssl参数，以不安全的方式连接到Citrix Hypervisor服务器。

获取有关xe命令的帮助

主机上的CLI命令可以通过输入以下命令获得基本帮助:

Xe帮助命令

如果输入以下命令，将显示最常用的xe命令列表:

救命啊!——NeedCopy >

如果输入以下命令，则会显示所有xe命令的列表:

帮助——所有

xe基本语法

所有Citrix Hypervisor xe CLI命令的基本语法如下:

Xe命令-name参数=value参数=value 

每个特定命令都包含自己的一组参数，这些参数的形式为参数=值．有些命令有必需的参数，大多数命令有一组可选参数。通常，在不调用某些可选参数时，命令会为它们假定默认值。

如果xe命令远程运行，则使用额外的参数进行连接和身份验证。这些参数也采用以下形式参数= argument_value．

的服务器参数用于指定主机名或IP地址。的用户名和密码参数用于指定凭据。

一个密码文件参数，而不是直接指定密码。在这种情况下，xe命令尝试从指定的文件中读取密码，并使用该密码进行连接。(文件末尾的任何尾随cr和lf都将被删除。)此方法比直接在命令行指定密码更安全。

可选港口参数可用于指定远程Citrix Hypervisor服务器上的代理端口(默认为443)。

例子:在本地Citrix Hypervisor服务器上:

Xe vm-list 

例子:在远端Citrix Hypervisor服务器上:

Xe vm-list username=username password=password server=hostname 

速记语法也可用于远程连接参数:

• - u用户名
• pw密码
• -pwf密码文件
• - p港口
• - s服务器

例子:在远端Citrix Hypervisor服务器上:

Xe vm-list -u myuser -pw mypassword -s hostname 

参数也以逗号分隔的键/值对的形式从环境变量XE_EXTRA_ARGS中获取。例如，要输入在远端Citrix Hypervisor服务器上运行的命令，则先执行以下命令:

导出XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass" 

运行此命令后，您不再需要在运行的每个xe命令中指定远程Citrix Hypervisor服务器参数。

使用XE_EXTRA_ARGS环境变量还可以在对远程Citrix Hypervisor服务器发出xe命令时启用选项卡完成，这在默认情况下是禁用的。

特殊字符和语法

对象上指定参数/值对xe命令行，写入:参数=值

除非值包含空格，否则不要使用引号。在参数名称、等号(=)和值之间不应该有空格。任何不符合此格式的参数都将被忽略。

对于包含空格的值，写入:参数="带空格的值"

当您在Citrix Hypervisor服务器上使用CLI时，命令具有与标准Linux bash shell中的特性类似的选项卡完成特性。例如，如果您键入xe vm-l然后按下选项卡键后，显示命令的其余部分。如果有多个命令以vm-l,按下选项卡第二次列出可能性。在命令中指定对象uuid时，此特性非常有用。

注意:

在远程Citrix Hypervisor服务器上执行命令时，制表符补全通常不起作用。但是，如果在输入命令的机器上设置XE_EXTRA_ARGS变量，则启用选项卡补全。有关更多信息，请参见xe基本语法．

命令类型

CLI命令可以分为两部分。低级命令关注API对象的列表和参数操作。高级命令用于在更抽象的级别上与虚拟机或主机进行交互。

低级命令有:

• 类附些

• 类-param-get

• 类-param-set

• 类-param-list

• 类-param-add

• 类-param-remove

• 类-param-clear

在哪里类是其中之一:

• 债券

• 控制台

• 宿主

• host-crashdump

• 主机cpu

• 网络

• 补丁

• pbd

• 论坛

• 池

• sm

• 老

• 任务

• 模板

• vbd

• vdi

• vif

• vlan

• 虚拟机

并不是每一个类有全套的吗类param -行动命令。的一些值类使用更少的命令集。

参数类型

使用xe命令寻址的对象具有一组参数，用于标识它们并定义它们的状态。

大多数参数采用单个值。例如，品牌)参数中包含单个字符串值。在参数列表命令的输出中，例如xe vm-param-list，括号内的值表示参数是读写(RW)还是只读(RO)。的输出xe vm-param-list在指定的虚拟机中，可能有以下行:

user-version (RW): 1 is-control-domain (RO): false

第一个参数，user-version，是可写的，其值为1。第二个,is-control-domain，为只读，值为false。

另外两种类型的参数是多值的。一个集参数包含值列表。一个地图参数是一组键/值对。的示例输出如下所示xe vm-param-list在指定虚拟机上:

platform (MRW): acpi: true;apic:真实;pae:真实;nx: false allowed-operations (SRO): pause;clean_shutdown;clean_reboot;\ hard_shutdown;hard_reboot;暂停

的平台参数具有表示键/值对的项列表。键名后面跟着冒号(:)。每个键/值对之间用分号(;)隔开。RW前的M表示该参数为映射参数，可读可写。的允许的操作参数具有组成一组项的列表。RO前面的S表示这是一个设置好的参数，可读但不可写。

如果需要对映射参数进行过滤或设置映射参数，请使用冒号(:)分隔映射参数名称和键值对。的值喷火钥匙其他配置虚拟机的参数英国机场管理局，命令将是

xe VM -param-set uuid=虚拟机uuid other-config:foo=baa 

注意:

在以前的版本中，使用连字符(-)来指定映射参数。这种语法仍然有效，但已弃用。

低级参数命令

有几个命令用于操作对象的参数:类-param-get,类-param-set,类-param-add,类-param-remove,类-param-clear,类-param-list。这些命令中的每一个都带有auuid参数来指定特定对象。由于这些命令被认为是低级命令，因此它们必须使用UUID，而不是虚拟机名称标签。

• Xe class-param-list uuid=uuid

  列出所有参数及其关联值。不像类-list命令用于列出“昂贵”字段的值。

• Xe class-param-get uuid=uuid param-name=parameter param-key=key

  返回特定参数的值。对于映射参数，指定param-key将获得与映射中该键相关联的值。如果未指定param-key或参数为set，则该命令返回该set或映射的字符串表示形式。

• Xe class-param-set uuid=uuid param=value

  设置一个或多个参数的值。

• Xe class-param-add uuid=uuid param-name=parameter key=value param-key=key

  添加到映射或集合参数。对于map参数，使用key=value语法添加键/值对。如果该参数是一个集合，则使用param-key=key语法添加键。

• Xe class-param-remove uuid=uuid param-name=parameter param-key=key

  从映射中删除键/值对，或从集合中删除键。

• Xe class-param-clear uuid=uuid param-name=参数

  完全清除一组或一张地图。

低级列表命令

的类-list命令列出type的对象类．默认情况下，这种类型的命令列出所有对象，打印参数的子集。此行为可以通过以下方式修改:

• 它可以过滤对象，以便只输出一个子集
• 打印的参数可以修改。

要更改打印的参数，请指定实参参数个数作为所需参数的逗号分隔列表。例如:

Xe vm-list参数=name-label,other-config 

或者，要列出所有参数，请使用以下语法:

Xe vm-list参数=所有

list命令不显示一些计算成本很高的参数。这些参数如下所示，例如:

allowed-VBD-devices (SRO):  

要获取这些字段，请使用以下命令类-param-list或类-param-get

为了过滤列表，CLI将参数值与命令行上指定的值进行匹配，只打印匹配所有指定约束的对象。例如:

xe vm-list HVM-boot-policy="BIOS order" power-state= stopped 

此命令仅列出以下虚拟机这两个这个领域电源状态有价值吗?停止还有田野HVM-boot-policy有价值吗?BIOS的顺序．

还可以根据映射中的键值或集合中存在的值筛选列表。基于映射中的键进行过滤的语法是映射名称:键=值．基于集合中存在的值进行过滤的语法为集名称:包含=价值．

编写脚本时，传递了一种有用的技术——最小在命令行中，导致xe只打印逗号分隔列表中的第一个字段。例如:命令Xe vm-list——minimal在安装了三个虚拟机的主机上，给出了三个虚拟机的uuid:

\ 42c044de-df69-4b30-89d9-2c199564581d 

秘密

Citrix Hypervisor提供了一种保密机制，以避免密码以明文形式存储在命令行历史记录或API对象中。XenCenter自动使用这个特性，也可以从xe CLI中使用它来执行任何需要密码的命令。

请注意

密码秘密不能用于从xe CLI的远程实例向Citrix Hypervisor主机进行身份验证。

要创建一个秘密对象，请在Citrix Hypervisor主机上运行以下命令。

Xe secret-create value=my-password 

在Citrix Hypervisor主机上创建并存储一个密钥。该命令输出secret对象的UUID。例如,99945 d96 - 5890 de2a c04ef2521db——3899 - 8．附加_secret到密码参数的名称，以便将此UUID传递给需要密码的任何命令。

例子:在创建secret的Citrix Hypervisor主机上，可以运行以下命令:

xe SR -create device-config:location=sr_address device-config:type=cifs device-config:username=cifs_username \ device-config:cifspassword_secret=secret_uuid name-label=" cifs ISO SR" type=" ISO " content-type=" ISO " shared="true" 

命令历史记录

例如，一些xe命令xe vm-migrate或xe pool-enable-external-auth，以密码等秘密作为参数。这些可以在shell历史记录中结束，并且在命令执行期间在进程表中可见。因此，只在可信的环境中执行这些命令非常重要。

对于bash shell，您可以使用HISTCONTROL变量来控制哪些命令存储在shell历史记录中。

Xe命令参考

本节根据命令所针对的对象对命令进行分组。这些物品按字母顺序排列。

设备命令

用于创建和修改VM设备(也称为vApps)的命令。有关更多信息，请参见vapp．

设备参数

Appliance命令有以下参数:

appliance-assert-can-be-recovered

uuid=appliance-uuid数据库vdi-uuid=vdi-uuid 

测试是否有可用的存储来恢复此虚拟机设备/vApp。

appliance-create

create name-label=name-label [name-description=name-description] 

创建一个设备/vApp。例如:

Xe appliance-create name-label=my_appliance 

向一体机添加虚拟机:

xe vm-param-set uuid=VM-UUID appliance=appliance-uuid 

appliance-destroy

Xe appliance-destroy uuid=appliance-uuid 

销毁一个设备/vApp。例如:

Xe appliance-destroy uuid=appliance-uuid 

appliance-recover

Xe appliance-recover uuid=appliance-uuid数据库:vdi-uuid=vdi-uuid [paused=true|false] 

从提供的VDI中包含的数据库恢复VM设备/vApp。

appliance-shutdown

Xe appliance-shutdown uuid=appliance-uuid [force=true|false] 

关闭设备/vApp中的所有虚拟机。例如:

Xe appliance-shutdown uuid=appliance-uuid 

appliance-start

Xe appliance-start uuid=appliance-uuid [paused=true|false] 

启动设备/vApp。例如:

Xe appliance-start uuid=appliance-uuid 

审计的命令

审计命令下载池中RBAC审计文件的所有可用记录。如果可选参数自存在时，它只下载该特定时间点的记录。

audit-log-get参数

audit-log-get具有以下参数

audit-log-get

Xe audit-log-get [since=timestamp] filename=filename 

例如，需要获取该池从精确毫秒时间戳开始的审计记录。

执行如下命令:

xe audit-log-get since=2009-09-24 t17:56:20.53 z filename=/tmp/auditlog-pool-actions. exe< !——NeedCopy >

成键的命令

用于处理网络绑定的命令，用于物理接口故障转移的弹性。有关更多信息，请参见网络．

绑定对象是一个粘合在一起的引用对象主和成员进行通信。主PIF是绑定接口，必须将其用作总体PIF来引用绑定。成员pif是两个或多个物理接口的集合，这些物理接口被组合成高级绑定接口。

键参数

bond有以下参数:

bond-create

Xe bond-create network-uuid=network_uuid pif- uids=pif_uuid_1,pif_uuid_2，…<！——NeedCopy >

在从现有PIF对象列表中指定的网络上创建绑定的网络接口。当出现以下情况时，命令执行失败:

• 如果pif已经购买了另一只债券
• 如果任何成员设置了VLAN标签
• 如果引用的pif不在同一台Citrix Hypervisor服务器上
• 如果提供的pif少于2个

bond-destroy

Xe bond-destroy uuid=bond_uuid 

从主机删除由其UUID指定的绑定接口。

bond-set-mode

Xe bond-set-mode uuid=bond_uuid mode=bond_mode 

修改绑定模式。

CD命令

用于处理Citrix Hypervisor服务器上的物理CD/DVD驱动器的命令。

CD参数

cd有以下参数:

cd-list

cd-list [params=param1,param2，…][parameter=parameter_value] 

列出Citrix Hypervisor服务器或池上的CD和iso (CD镜像文件)，过滤可选参数参数个数．

如果可选参数参数个数时，params的值是一个字符串，其中包含要显示的此对象的参数列表。或者，您可以使用关键字所有显示所有参数。当参数个数，则返回的列表显示所有可用参数的默认子集。

可选参数可以是任意数量的CD参数列在本节的开头。

集群命令

使用集群池的命令。

集群池是指开启了集群特性的资源池。与GFS2 sr一起使用这些池。有关更多信息，请参见集群池

集群和集群-主机对象可以使用标准对象列表命令(xe cluster-list和xe cluster-host-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令．使用集群池的命令。

集群参数

集群包含以下参数:

cluster-host-create

Xe cluster-host-create cluster-uuid=cluster_uuid host-uuid=host_uuid pif-uuid=pif_uuid 

在已有集群中添加主机。

cluster-host-destroy

Xe cluster-host-destroy uuid=host_uuid 

销毁集群主机，有效地离开集群。

cluster-host-disable

Xe cluster-host-disable uuid=cluster_uuid 

为已启用的集群主机禁用集群成员资格。

cluster-host-enable

Xe cluster-host-enable uuid=cluster_uuid 

为已禁用的集群主机启用集群成员资格。

cluster-host-force-destroy

Xe cluster-host-force-destroy uuid=cluster_host 

强制销毁集群主机对象，有效地离开集群。

cluster-pool-create

Xe cluster-pool-create network-uuid=network_uuid [cluster-stack=cluster_stack] [token-timeout=token_timeout] [token-timeout-coefficient=token_timeout_coefficient] 

创建池级集群。

cluster-pool-destroy

Xe cluster-pool-destroy cluster-uuid=cluster_uuid 

摧毁池级集群。池仍然存在，但不再是集群，不能再使用GFS2 sr。

cluster-pool-force-destroy

Xe cluster-pool-force-destroy cluster-uuid=cluster_uuid 

强制销毁池范围内的群集。

cluster-pool-resync

Xe cluster-pool-resync cluster-uuid=cluster_uuid 

跨池重新同步集群。

控制台命令

使用控制台的命令。

控制台对象可以使用标准对象列表命令(xe console-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令．

控制台参数

控制台有以下参数:

控制台

Xe控制台

连接到特定的控制台。

诊断命令

从Citrix Hypervisor收集诊断信息命令。

diagnostic-compact

Xe诊断-紧凑

执行一次主要的GC收集和堆压缩。

弃用:diagnostic-db-log

Xe diagnostic- dblog 

开始记录数据库操作。警告:一旦开始，就无法停止。

diagnostic-db-stats

Xe diagnostic-db-stats 

打印数据库统计信息。

diagnostic-gc-stats

Xe diagnostic-gc-stats 

打印GC统计信息。

diagnostic-license-status

Xe diagnostic-license-status 

帮助诊断池范围的许可问题。

diagnostic-net-stats

Xe diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2…]) < !——NeedCopy >

打印网络统计信息。

diagnostic-timing-stats

Xe diagnostic- time -stats 

打印定时统计信息。

diagnostic-vdi-status

Xe diagnostic-vdi-status uuid=vdi_uuid 

使用实例查询VDI的锁定和共享状态。

diagnostic-vm-status

Xe diagnostic-vm-status uuid=vm_uuid 

查看虚拟机可以启动的主机，查看所有vbs的共享/锁定状态。

容灾命令

灾后恢复虚拟机命令

drtask-create

Xe drtask-create type=type sr-whitelist=sr-white-list device-config=device-config 

创建容灾任务。例如，连接到iSCSI SR，为灾难恢复做准备:

xe drtask-create type=lvmoiscsi device-config:target=target-ip-address \ device-config:targetIQN=targetIQN device-config:SCSIid=SCSIid \ sr-whitelist=sr-uuid-list 

注意:

命令sr-whitelist列出允许的SR uid。的drtask-create命令只引入并连接到具有允许的uuid之一的SR

drtask-destroy

命令drtask-destroy uuid= drtask- uuid 

破坏灾难恢复任务并忘记引入的SR。

vm-assert-can-be-recovered

vdi-uuid=vdi-uuid数据库:vdi-uuid=vdi-uuid 

测试是否有可用的存储来恢复此虚拟机。

appliance-assert-can-be-recovered

uuid=appliance-uuid数据库vdi-uuid=vdi-uuid 

检查存储(包含设备的/vAPP磁盘)是否可见。

appliance-recover

Xe appliance-recover uuid=appliance-uuid数据库:vdi-uuid=vdi-uuid [force=true|false] 

从提供的VDI中包含的数据库中恢复设备/vAPP。

vm-recover

Xe vm-recover uuid=vm-uuid数据库:vdi-uuid=vdi-uuid [force=true|false] 

从提供的VDI中包含的数据库中恢复虚拟机。

sr-enable-database-replication

Xe sr-enable-database-replication uuid=sr_uuid 

启用XAPI数据库复制到指定的(共享的)SR。

sr-disable-database-replication

Xe sr-disable-database-replication uuid=sr_uuid 

禁用XAPI数据库到指定SR的复制。

示例使用

容灾CLI命令示例如下:

在主站点启用数据库复制:

Xe sr-database-replication uuid=sr=uuid 

灾难发生后，在备用站点上，连接到srdevice-config命令具有与sr-probe．

\ device-config:targetIQN=target-iqn \ device-config:SCSIid=scsi-id \ sr-whitelist=sr-uuid 

在SR上查找数据库vdi:

xe vdi-list sr-uuid=sr-uuid type=Metadata 

查询数据库VDI中存在的虚拟机:

Xe vm-list数据库:vdi-uuid=vdi-uuid 

恢复虚拟机:

Xe vm-recover uuid=vm-uuid数据库vdi-uuid=vdi-uuid 

销毁容灾任务。容灾任务引入的、虚拟机不需要的sr将被销毁。

命令drtask-destroy uuid=drtask-uuid 

事件的命令

用于处理事件的命令。

事件类

事件类列在下表中:

event-wait

Xe event-wait class=class_name [param-name=param_value] [param-name=/=param_value] 

阻止其他命令执行，直到存在满足命令行上给定条件的对象。这个论点x = y表示“等待字段x取值y”和x = / = y表示“等待字段x取y以外的任何值”。

例子:等待指定的虚拟机运行。

Xe event-wait class=vm name-label=myvm power-state=running 

阻塞其他命令，直到一个虚拟机被调用myvm在。电源状态“运行”。

例子:等待指定虚拟机重启:

xe event-wait class=vm uuid=$ vm start-time=/=$(xe vm-list uuid=$ vm params=start-time——minimal) 

阻塞其他命令，直到有UUID的虚拟机VM美元重新启动。该命令使用的值启动时间决定虚拟机何时重启。

类名可以是事件类列在本节的开头。参数可以是CLI命令中列出的任意参数类-param-list。

GPU的命令

物理图形处理器、图形处理器组和虚拟图形处理器相关命令。

可以使用标准对象列表命令列出GPU对象:xe pgpu-list，xe gpu-group-list,xe vgpu-list．可以使用标准参数命令对参数进行操作。有关更多信息，请参见低级参数命令．

GPU物理参数

物理gpu (Physical gpu)包括以下参数:

pgpu-disable-dom0-access

ppuu -disable-dom0-access uuid=uuid 

禁止PGPU访问dom0。

pgpu-enable-dom0-access

Xe pgpu-enable-dom0-access uuid=uuid 

开启PGPU对dom0的访问。

GPU组参数

GPU组包含以下参数:

GPU组操作

使用GPU组的命令

gpu-group-create

Xe gpu-group-create name-label=name_for_group [name-description=description] 

创建一个新的(空的)GPU Group，用于移动GPU。

gpu-group-destroy

Xe gpu-group-destroy uuid=uuid_of_group 

破坏GPU组;只允许空组使用。

gpu-group-get-remaining-capacity

Xe gpu-group-get-remaining-capacity uuid=uuid_of_group vgpu-type-uuid=uuid_of_vgpu_type 

返回在此GPU组中可以实例化指定类型的虚拟GPU的数目。

gpu-group-param-set

Xe gpu-group-param-set uuid=uuid_of_group分配-算法=宽度优先|深度优先

修改图形处理器组分配虚拟图形处理器的算法。

gpu-group-param-get-uuid

xe gpu-group-param-get-uuid uuid=uuid_of_group param-name=supported-vGPU-types|enabled-vGPU-types 

返回该GPU组支持或启用的类型。

虚拟GPU参数

虚拟gpu有以下参数:

虚拟GPU类型参数

注意:

GPU直通和虚拟GPU不支持热迁移、存储热迁移、虚拟机挂起，除非有GPU厂商支持的软件和显卡。没有此支持的虚拟机无法迁移以避免停机。有关NVIDIA vGPU与热迁移、存储热迁移和虚拟机挂起的兼容性的信息，请参见图形．

虚拟GPU类型的参数如下:

虚拟GPU操作

vgpu-create

Xe vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=uuid_of_vgpu-type] 

创建虚拟GPU。该命令将虚拟机绑定到指定的图形处理器组，并可指定虚拟图形处理器的类型。如果未指定虚拟GPU类型，则假定为“直通”类型。

vgpu-destroy

Xe vgpu-destroy uuid= uid_of_vgpu 

销毁指定的虚拟GPU。

使用虚拟GPU的虚拟机关闭VNC

Xe vm-param-add uuid=uuid_of_vmparam-name=platform vgpu_vnc_enabled=true|false 

使用假在虚拟机通过时禁用虚拟机的VNC控制台disablevnc = 1通过显示仿真器。默认情况下，VNC功能处于开启状态。

主机的命令

与Citrix Hypervisor服务器交互的命令。

Citrix Hypervisor服务器是指运行Citrix Hypervisor软件的物理服务器。它们在一个特殊的特权虚拟机(称为控制域或域0)的控制下运行虚拟机。

可以使用标准对象列表命令列出Citrix Hypervisor服务器对象:xe主机列表，xe host-cpu-list,xe host-crashdump-list）.可以使用标准参数命令对参数进行操作。有关更多信息，请参见低级参数命令．

主机选择器

这里列出的几个命令具有一种通用机制，用于选择要在其上执行操作的一个或多个Citrix Hypervisor服务器。最简单的方法是提供论证主机= uuid_or_name_label．您还可以通过过滤字段值上的完整主机列表来指定Citrix Hypervisor。例如，指定启用= true选择所有Citrix Hypervisor服务器启用场等于真正的．当有多台Citrix Hypervisor服务器匹配且可以在多台Citrix Hypervisor服务器上执行该操作时，必须指定——多个执行操作。本节开头描述了可以匹配的参数的完整列表。可以通过该命令获取该命令列表Xe host-list参数=all．如果不提供选择Citrix虚拟化环境服务器的参数，则在所有Citrix虚拟化环境服务器上执行该操作。

主机参数

Citrix虚拟化环境服务器包含以下参数:

Citrix Hypervisor服务器包含一些其他对象，这些对象也具有参数列表。

Citrix Hypervisor服务器的cpu参数如下:

Citrix Hypervisor服务器上的崩溃转储有以下参数:

host-all-editions

Xe host-all-editions 

获取所有可用版本的列表

host-apply-edition

Xe host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"] 

该任务指导管理员为主机服务器分配Citrix Hypervisor的license。分配license时，Citrix Hypervisor与license Server联系，申请指定类型的license。如果有可用的许可证，则从许可证服务器签出该许可证。

对于Citrix虚拟桌面版的Citrix Hypervisor，使用“xendesktop”．

有关初始许可配置，请参见license-server-address和license-server-port．

host-backup

Xe host-backup file-name=backup_filename host=host_name 

将指定Citrix Hypervisor服务器控制域的备份下载到调用该命令的计算机上。将其保存为文件名为文件名称．

重要的是:

而xe host-backup如果在本地主机上执行(即不指定特定的主机名)，则此命令有效，请勿这样使用。这样做将用备份文件填满控制域分区。仅在有空间存放备份文件的远程非主机机器上使用该命令。

host-bugreport-upload

Xe host-bugreport-upload [host-selector=host_selector_value…][url=destination_url http-proxy=http_proxy_name] 

生成一个新的bug报告(使用xen-bugtool(包括所有可选文件)并上传到支持FTP站点或其他位置。

应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。

可选参数有http代理:使用指定的HTTP代理，和url:上载到此目的URL。如果不使用可选参数，则不标识代理服务器，目的站点为默认的Support FTP站点。

host-call-plugin

Xe host-call-plugin host-uuid=host_uuid plugin=plugin fn=function [args=args] 

使用可选参数调用给定主机上插件中的函数。

host-compute-free-memory

Xe主机-计算-空闲内存

计算主机上的空闲内存量。

host-compute-memory-overhead

Xe主机-计算机-内存-开销

计算主机的虚拟化内存开销。

host-cpu-info

Xe host-cpu-info [uuid=uuid] 

列出主机的物理cpu信息。

host-crashdump-destroy

Xe host-crash - dump-destroy uuid=crashdump_uuid 

删除Citrix Hypervisor服务器上UUID指定的主机崩溃转储。

host-crashdump-upload

Xe host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name] 

上传崩溃转储到支持FTP站点或其他位置。如果不使用可选参数，则不标识代理服务器，目的站点为默认的Support FTP站点。可选参数有http代理:使用指定的HTTP代理，和url:上载到此目的URL。

host-declare-dead

host-declare-dead uuid=host_uuid 

在不显式地联系宿主的情况下声明宿主已死。

警告:

这个调用是危险的，如果主机实际上没有死，可能会导致数据丢失。

host-disable

Xe host-disable [host-selector=host_selector_value…]) < !——NeedCopy >

禁用指定的Citrix Hypervisor服务器，从而阻止在该服务器上启动任何新的虚拟机。此操作准备关闭或重新启动Citrix Hypervisor服务器。

应该执行此操作的主机使用标准选择机制(参见主机选择器）.可选参数可以是任意数量的主机参数列在本节的开头。

host-disable-display

显示uuid=host_uuid 

禁用主机显示。

host-disable-local-storage-caching

主机-禁用本地存储-缓存

在指定主机上禁用本地存储缓存。

host-dmesg

Xe host-dmesg [host-selector=host_selector_value…]) < !——NeedCopy >

买一个Xendmesg命令(内核环缓冲区的输出)从指定的Citrix Hypervisor服务器。

应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。

host-emergency-ha-disable

Xe host-emergency-ha-disable[——force] 

关闭本地主机的HA功能。仅用于恢复HA设置损坏的池。

host-emergency-management-reconfigure

Xe host-emergency-management-reconfigure interface=uuid_of_management_interface_pif 

重新配置该Citrix Hypervisor服务器的管理接口。该命令仅在Citrix Hypervisor服务器处于紧急模式时使用。紧急模式是指资源池中的主机已从网络中消失，经过多次重试后无法联系。

host-emergency-reset-server-certificate

主机-emergency-reset-server-certificate 

在执行该命令的Citrix Hypervisor服务器上安装自签名证书。

host-enable

Xe host-enable [host-selector=host_selector_value…]) < !——NeedCopy >

启用指定的Citrix Hypervisor服务器，允许在这些服务器上启动新的虚拟机。

应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。

host-enable-display

Xe host-enable-display uuid=host_uuid 

为主机启用显示。

host-enable-local-storage-caching

Xe host-enable-local-storage-caching sr-uuid=sr_uuid 

在指定主机上启用本地存储缓存。

host-evacuate

[host-selector=host_selector_value…]) < !——NeedCopy >

热迁移将所有运行中的虚拟机迁移到池中其他合适的主机上。命令禁用主机host-disable命令。

如果疏散的主机是池主主机，则必须选择另一个主机作为池主主机。要更改禁用HA的池主，请使用pool-designate-new-master命令。有关更多信息，请参见pool-designate-new-master．

启用HA后，您唯一的选择是关闭服务器，这将导致HA随机选择一个新的主服务器。有关更多信息，请参见host-shutdown．

应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。

host-forget

Xe主机忘记uuid=host_uuid 

XAPI代理忘记了指定的Citrix Hypervisor服务器，而没有显式地联系它。

使用——力参数，以避免系统提示确认是否执行该操作。

警告:

如果池已启用HA，则不使用此命令。首先禁用HA，然后在忘记主机后再次启用它。

如果要“忘记”的Citrix Hypervisor服务器已死亡，则此命令很有用。但是，如果Citrix Hypervisor服务器是活动的并且是池的一部分，则使用xe pool-eject代替。

host-get-cpu-features

Xe host-get-cpu-features {features=pool_master_cpu_features} [uuid=host_uuid] 

打印主机物理cpu特征的十六进制表示。

host-get-server-certificate

Xe host-get-server-certificate 

获取已安装的服务器TLS证书。

host-get-sm-diagnostics

Xe host-get-sm-diagnostics uuid=uuid 

显示每个主机的SM诊断信息。

host-get-system-status

Xe host-get-system-status filename=name_for_status_file [entries=comma_separated_list] [output=tar. exe]bz2 |获取zip] [host-selector = host_selector_value……) < !——NeedCopy >

将系统状态信息下载到指定文件中。可选参数条目是一个以逗号分隔的系统状态条目列表，取自host-get-system-status-capabilities命令。有关更多信息，请参见host-get-system-status-capabilities．如果不指定，则将所有系统状态信息保存到该文件中。的参数输出可能是tar.bz2(默认)或邮政编码．如果不指定该参数，则文件保存在tar.bz2的形式。

应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。

host-get-system-status-capabilities

host-selector=host_selector_value…) < !——NeedCopy >

获取指定主机的系统状态功能。功能作为XML片段返回，类似于以下示例:

< ?XML版本="1.0" ?>< system-status-capabilities ><功能- type =“文本/普通”default-checked =“是的”关键=“xenserver-logs”＼最大尺寸=“150425200”max-time =“1”min-size =“150425200”min-time =“1”＼pii =“也许”/><功能- type =“文本/普通”default-checked =“是的”＼关键=“xenserver-install”最大尺寸=“51200”max-time =“1”min-size =“10240”＼min-time =“1”pii =“也许”/>．..< / system-status-capabilities ><！——NeedCopy >

每个功能实体可以具有以下属性。

• 关键功能的唯一标识符。
• 内容类型可以是文本/纯文本或应用程序/数据。指示UI是否可以呈现供人使用的条目。
• default-checked可以是或不是。指示UI是否应该默认选择此条目。
• min-size，最大尺寸以字节为单位表示该表项大小的大致范围。-1表示大小不重要。
• min-time，max-time指示收集此条目所需时间的大致范围(以秒为单位)。-1表示时间不重要。

• pii个人身份信息。指示表项是否包含可以识别系统所有者或其网络拓扑详细信息的信息。该属性可以是以下值之一:

  • 没有:这些条目中没有PII
  • 是的PII很可能或肯定在这些条目中
  • 也许:您可能需要审核这些PII条目
  • if_customized如果文件未被修改，则它们不包含PII。但是，由于我们鼓励对这些文件进行编辑，因此PII可能是由这种自定义引入的。该值特别用于控制域中的网络脚本。

  无论任何PII声明如何，密码都永远不会包含在任何错误报告中。

应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。

host-get-thread-diagnostics

Xe host-get-thread-diagnostics uuid=uuid 

显示每个主机的线程诊断信息。

host-get-vms-which-prevent-evacuation

Xe host-get-vms-which-prevent-evacuation uuid=uuid 

返回阻止指定主机进行疏散的虚拟机列表，并显示每个虚拟机的原因。

host-is-in-emergency-mode

主机处于紧急模式

返回真正的如果与CLI对话的主机处于紧急模式，假否则。即使没有主服务器，该CLI命令也可以直接在池成员服务器上工作。

host-license-add

Xe host-license-add [license-file=path/license_filename] [host-uuid=host_uuid] 

对于Citrix Hypervisor(免费版)，使用解析本地license文件，并将其添加到指定的Citrix Hypervisor服务器上。

host-license-remove

Xe host-license-remove [host-uuid=host_uuid] 

删除应用于主机的任何许可。

host-license-view

Xe host-license-view [host-uuid=host_uuid] 

显示Citrix Hypervisor服务器license的内容。

host-logs-download

Xe host-logs-download [file-name=logfile_name] [host-selector=host_selector_value…]) < !——NeedCopy >

下载指定Citrix Hypervisor服务器的日志副本。默认情况下，副本保存在一个带有时间戳的文件中hostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz．您可以使用可选参数指定不同的文件名文件名称．

应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。

重要的是:

而xe host-logs-download如果在本地主机上执行(即不指定特定的主机名)，则命令有效不这样用。这样做会使控制域分区与日志副本混淆。命令应该是只有在有空间保存日志副本的远程非主机机器上使用。

host-management-disable

host-management-disable 

禁用主机代理侦听外部管理网口，并断开所有连接的API客户端(如XenCenter)。该命令直接在CLI所连接的Citrix Hypervisor服务器上执行。当应用于Citrix Hypervisor成员服务器时，该命令不会转发到池主服务器。

警告:

使用off-host命令时要小心。执行此命令后，无法通过网络远程连接到控制域以重新启用主机代理。

host-management-reconfigure

Xe host-management-reconfigure [interface=device] [pif-uuid=uuid] 

重新配置Citrix Hypervisor服务器，使其使用指定的网口作为管理接口，即用于连接XenCenter的网口。该命令重写了MANAGEMENT_INTERFACE键/etc/xensource-inventory．

如果指定了接口的设备名(接口必须有IP地址)，Citrix Hypervisor服务器会立即重新绑定。该命令在正常模式和紧急模式下都有效。

如果指定了PIF对象的UUID, Citrix Hypervisor服务器将确定要重新绑定到自己的IP地址。执行此命令时，命令不能处于紧急模式。

警告:

在使用off-host命令时要小心，并确保在新接口上有网络连接。使用xe pif-reconfigure先建立一个。否则，后续的CLI命令将无法到达Citrix Hypervisor服务器。

host-power-on

Xe host-power-on [host=host_uuid] 

打开Citrix Hypervisor服务器的电源主机上电功能启用。使用该命令前，请先启用host-set-power-on在主机上。

host-reboot

Xe host-reboot [host-selector=host_selector_value…]) < !——NeedCopy >

重启指定的Citrix Hypervisor服务器。必须先禁用指定的主机xe host-disable命令，否则为HOST_IN_USE弹出错误提示。

应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。

如果指定的Citrix Hypervisor服务器是池中的成员，则会处理关闭时的连通性丢失，当Citrix Hypervisor服务器返回时，池会恢复。其他成员和主人继续发挥作用。

如果关闭主服务器，池将停止工作，直到发生以下操作之一:

• 你让其中一个成员成为master

• 原始主机被重新启动并重新上线。

  当主服务器重新联机时，成员重新连接并与主服务器同步。

host-restore

Xe host-restore [file-name=backup_filename] [host-selector=host_selector_value…]) < !——NeedCopy >

还原名为文件名称Citrix Hypervisor服务器控制软件。这里使用“restore”一词并不意味着通常意义上的完全恢复，它仅仅意味着压缩的备份文件已被解压缩并解包到辅助分区上。在你做了一个xe host-restore，您必须启动安装光盘并使用其从备份恢复选项。

应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。

host-send-debug-keys

Xe host-send-debug-keys host-uuid=host_uuid keys=keys 

将指定的虚拟机监控程序调试密钥发送到指定的主机。

host-server-certificate-install

Xe host-server-certificate-install certificate=path_to_certificate_file私钥=path_to_private_key [certificate-chain=path_to_chain_file] [host=host_name | uuid=host_uuid] 

该任务指导管理员在Citrix Hypervisor服务器上安装TLS证书。

host-set-hostname-live

Xe host-set-hostname-live host-uuid=uuid_of_host host-name=new_hostname 

修改指定的Citrix Hypervisor服务器的主机名host-uuid．此命令会永久设置控制域数据库中的主机名和Citrix Hypervisor服务器的实际Linux主机名。的价值主机名是不的值相同name_label字段。

host-set-power-on-mode

xe host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "DRAC" | "custom"} \ [power-on-config:power_on_ip=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid] 

用于启用主机上电支持远程电源解决方案的Citrix Hypervisor主机。在使用host-set-power-on命令时，必须指定主机的电源管理方案类型(即上电模式)。然后使用power-on-config参数及其关联的键值对指定配置选项。

要使用秘密功能来存储密码，请指定密钥“power_on_password_secret”．有关更多信息，请参见秘密．

host-shutdown

Xe host-shutdown [host-selector=host_selector_value…]) < !——NeedCopy >

关闭指定的Citrix Hypervisor服务器。必须先禁用指定的Citrix Hypervisor服务器xe host-disable命令，否则为HOST_IN_USE弹出错误提示。

应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。

如果指定的Citrix Hypervisor服务器是池中的成员，则会处理关闭时的连通性丢失，当Citrix Hypervisor服务器返回时，池会恢复。其他成员和主人继续发挥作用。

如果关闭主服务器，池将停止工作，直到发生以下操作之一:

• 你让其中一个成员成为master

• 原始主机被重新启动并重新上线。

  当主服务器重新联机时，成员重新连接并与主服务器同步。

如果为池启用了HA，则其中一个成员将自动成为主节点。如果HA被禁用，则必须使用pool-designate-new-master命令。有关更多信息，请参见pool-designate-new-master．

host-sm-dp-destroy

Xe host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false] 

试图销毁和清理主机上的存储数据路径。如果allow-leak = true则它删除数据路径的所有记录，即使它没有完全关闭。

host-sync-data

Xe host-sync-data 

将存储在池主机上的数据与指定的主机同步。这不包括数据库数据)。

host-syslog-reconfigure

Xe host-syslog-reconfigure [host-selector=host_selector_value…]) < !——NeedCopy >

重新配置syslog在指定的Citrix Hypervisor服务器上启动。该命令应用主机中定义的配置信息日志记录参数。

应该执行此操作的主机使用标准选择机制(参见主机选择器如上图所示)。可选参数可以是任意数量的主机参数列在本节的开头。

host-data-source-list

Xe host-data-source-list [host-selectors=host selector value…]) < !——NeedCopy >

列出可为主机记录的数据源。

使用标准选择机制选择要执行此操作的主机主机选择器）.可选参数可以是任意数量的主机参数列在本节的开头。如果未指定选择主机的参数，则对所有主机执行该操作。

数据源有两个参数-标准和启用．该命令输出参数的值:

• 如果数据源具有启用设置为真正的，这些指标当前被记录到性能数据库中。
• 如果数据源具有标准设置为真正的，这些指标被记录到性能数据库中默认情况下．的价值启用也被设置为真正的用于此数据源。
• 如果数据源具有标准设置为假，指标是不默认情况下记录到性能数据库中。的价值启用也被设置为假用于此数据源。

要开始将数据源指标记录到性能数据库，请运行host-data-source-record命令。这个命令设置启用来真正的．停止，运行host-data-source-forget．这个命令设置启用来假．

host-data-source-record

host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value…]) < !——NeedCopy >

记录主机的指定数据源。

将数据源中的信息写入指定主机的持久性性能指标数据库。出于性能原因，该数据库不同于普通的代理数据库。

使用标准选择机制选择要执行此操作的主机主机选择器）.可选参数可以是任意数量的主机参数列在本节的开头。如果未指定选择主机的参数，则对所有主机执行该操作。

host-data-source-forget

Xe host-data-source-forget data-source=name_description_of_data_source [host-selectors=host_selector_value…]) < !——NeedCopy >

停止为主机记录指定数据源，并忘记所有记录的数据。

使用标准选择机制选择要执行此操作的主机主机选择器）.可选参数可以是任意数量的主机参数列在本节的开头。如果未指定选择主机的参数，则对所有主机执行该操作。

host-data-source-query

host-data-source-query data-source=name_description_of_data_source [host-selectors=host_selector_value…]) < !——NeedCopy >

显示主机的指定数据源。

使用标准选择机制选择要执行此操作的主机主机选择器）.可选参数可以是任意数量的主机参数列在本节的开头。如果未指定选择主机的参数，则对所有主机执行该操作。

DEPRECATED:日志命令

用于处理日志的命令。

弃用:log-get

Xe log-get 

返回当前存储在字符串记录器中的日志。

弃用:log-get-keys

Xe log-get-keys 

列出记录器已知的键。

弃用:log-reopen

重新打开日志

重新打开所有记录器(用于旋转文件)。

弃用:log-set-output

Xe log-set-output output=output [key=key] [level=level] 

将所有记录器设置为指定的输出(零，stderr，字符串，文件:文件名称，syslog:某物）.

消息命令

用于处理消息的命令。创建消息是为了通知用户重大事件，并在XenCenter中显示为警报。

可以使用标准对象列表命令(xe消息列表)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

消息参数

message-create

Xe message-create name=message_name body=message_text [[host-uuid=uuid_of_host] | [sr-uuid=uuid_of_sr] | [vm-uuid=uuid_of_vm] | [pool-uuid=uuid_of_pool]] 

创建消息。

message-destroy

Xe message-destroy [uuid=message_uuid] 

销毁已存在的消息。您可以构建一个脚本来销毁所有消息。例如:

#取消所有警报\ IFS="，";For min $(xe message-list params=uuid——minimal);Do \ xe message-destroy uuid=$m \ done 

网络命令

用于处理网络的命令。

可以使用标准对象列表命令(xe网络表)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

网络参数

网络有以下参数:

network-create

Xe network-create name-label=name_for_network [name-description=descriptive_text] 

创建网络。

network-destroy

Xe network-destroy uuid=network_uuid 

破坏现有网络。

SR-IOV命令

使用SR-IOV的命令。

的network-sriov可以使用标准对象列表命令(xe network-sriov-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

SR-IOV参数

SR-IOV具有以下参数:

network-sriov-create

Xe network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid 

为给定的物理PIF创建SR-IOV网络对象，并在物理PIF上启用SR-IOV。

network-sriov-destroy

Xe network- sriov_destroy uuid=network_sriov_uuid 

移除网络SR-IOV对象并在其物理PIF上禁用SR-IOV。

分配一个SR-IOV VF

Xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid 

将SR-IOV网络中的VF分配给虚拟机。

SDN控制器命令

与SDN控制器相关的命令。

sdn-controller-forget

Xe sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port] 

介绍SDN控制器。

sdn-controller-introduce

sdn-controller-forget uuid=uuid 

拔出SDN控制器。

隧道命令

用于处理隧道的命令。

tunnel-create

创建pif-uuid=pif_uuid network-uuid=network_uuid 

在主机上新建隧道。

tunnel-destroy

Xe tunnel-destroy uuid=uuid 

摧毁隧道。

补丁命令

用于处理补丁的命令。

patch-apply

Xe patch-apply uuid=patch_uuid host-uuid=host_uuid 

将之前上传的补丁应用到指定主机。

patch-clean

Xe patch-clean uuid=uuid 

删除之前上传的补丁文件。

patch-destroy

命令patch-destroy uuid=uuid 

从服务器上删除未应用的补丁记录和文件。

patch-pool-apply

命令patch-pool-apply uuid=uuid 

将之前上传的补丁应用于池中的所有主机。

patch-pool-clean

命令patch-pool-clean uuid=uuid 

删除池中所有主机上已上传的补丁文件。

patch-precheck

Xe patch-precheck uuid=uuid host-uuid=host_uuid 

运行先前上传到指定主机的补丁中包含的预检。

patch-upload

Xe patch-upload file-name=file_name 

上传补丁文件到服务器。

PBD命令

用于处理pbd(物理块设备)的命令。pbd是Citrix Hypervisor服务器访问存储库的软件对象。

可以使用标准对象列表命令(xe pbd-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

PBD参数

pbd有以下参数:

pbd-create

Xe pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value] 

在Citrix Hypervisor服务器上创建PBD。只读device-config参数只能在创建时设置。

要添加从' path '到' /tmp '的映射，命令行应该包含该参数device-config:路径= / tmp

有关每种SR类型上支持的设备配置键/值对的完整列表，请参见存储．

pbd-destroy

uuid= uid_of_pbd 

销毁指定的PBD。

pbd-plug

Xe pbd-plug uuid=uuid_of_pbd 

尝试将PBD插入到Citrix Hypervisor服务器。如果该命令成功，那么所引用的SR(以及其中包含的vdi)应该对Citrix Hypervisor服务器可见。

pbd-unplug

uuid= uid_of_pbd 

尝试从Citrix Hypervisor服务器上拔掉PBD。

论坛的命令

用于处理pif(表示物理网络接口的对象)的命令。

PIF对象可以使用标准对象列表命令(xe pif-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

论坛参数

pif有以下参数:

注意:

的更改其他配置字段的设置只有在重启后才会生效。或者，使用xe pif-unplug和xe pif-plug命令重写PIF配置。

pif-forget

pif忘记uuid= uid_of_pif 

销毁特定主机上指定的PIF对象。

pif-introduce

Xe pif-introduce host-uuid=host_uuid mac=mac_address_for_pif device=interface_name 

在指定的Citrix Hypervisor服务器上创建表示物理接口的PIF对象。

pif-plug

pif-plug uuid= uid_of_pif 

尝试启动指定的物理接口。

pif-reconfigure-ip

xe pif- reconfiguration - IP uuid=uuid_of_pif [mode=dhcp|mode=static] gateway=network_gateway_address IP=static_ip_for_this_pif netmask=netmask_for_this_pif [DNS=dns_address] 

修改PIF的IP地址。对于静态IP配置，请设置模式参数静态，与网关，知识产权,子网掩码参数设置为适当的值。如果需要使用DHCP，请设置模式参数DHCP保持静态参数未定义。

注意:

对于使用生成树协议的交换机，在关闭(或不支持)STP快速链路的情况下，在与端口相连的物理网络接口上使用静态IP地址，会导致一段时间内没有流量。

pif-reconfigure-ipv6

xe pif-reconfigure-ipv6 uuid=uuid_of_pif mode=mode [gateway=network_gateway_address] [IPv6=static_ip_for_this_pif] [DNS=dns_address] 

重新配置PIF的IPv6地址。

pif-scan

pif-scan host-uuid=host_uuid 

扫描Citrix Hypervisor服务器上的新物理接口。

pif-set-primary-address-type

pif-set-primary-address-type uuid=uuid primary_address_type=address_type 

修改PIF使用的主地址类型。

pif-unplug

uuid= uid_of_pif 

试图关闭指定的物理接口。处理步骤

池的命令

用于处理池的命令。一个池是一个或多个Citrix Hypervisor服务器的集合。一个存储池可以使用一个或多个共享存储库，以便将存储池中主机上运行的虚拟机近乎实时地迁移到存储池中的另一个主机上。此迁移在VM仍在运行时进行，不需要关闭VM并重新启动它。默认情况下，每个Citrix Hypervisor服务器实际上是一个由单个成员组成的池。当您的Citrix Hypervisor服务器加入到一个池中时，它被指定为一个成员，并且它所加入的池成为该池的主池。

单例池对象可以使用标准对象列表命令(xe池列表）.它的参数可以用标准参数命令来操作。有关更多信息，请参见低级参数命令

池参数

池包含以下参数:

pool-apply-edition

Xe pool-apply-edition edition=edition [uuid=uuid] [license-server-address=address] [license-server-port=port] 

跨池应用一个版本。

pool-certificate-install

Xe pool-certificate-install filename=file_name 

在池范围内安装TLS证书。

pool-certificate-list

Xe pool-certificate-list 

列出池中所有已安装的TLS证书。

pool-certificate-sync

Xe pool-certificate-sync 

将TLS证书和证书撤销列表从池主同步到其他池成员。

pool-certificate-uninstall

Xe pool-certificate-uninstall name=name 

卸载TLS证书。

pool-crl-install

Xe pool-crl-install filename=file_name 

安装全池范围的TLS证书撤销列表。

pool-crl-list

池-crl-list 

列出所有已安装的TLS证书撤销列表。

pool-crl-uninstall

Xe pool-crl-uninstall name=name 

卸载TLS证书吊销列表。

pool-deconfigure-wlb

Xe pool- config -wlb 

永久删除工作负载平衡的配置。

pool-designate-new-master

Xe pool- designated -new-master host-uuid=uuid_of_new_master 

指示指定的Citrix Hypervisor服务器成员成为现有池的主服务器。该命令用于将资源池中的主主机角色有序切换到另一台主机。该命令仅在当前主机在线时有效。它不能替代下面列出的紧急模式命令。

pool-disable-external-auth

Xe pool-disable-external-auth [uuid=uuid] [config=config] 

在池中的所有主机中禁用外部身份验证。

pool-disable-local-storage-caching

Xe pool-disable-local-storage-caching uuid=uuid 

跨池禁用本地存储缓存。

pool-disable-redo-log

Xe pool-disable-redo-log 

除非启用了HA，否则在使用时禁用重做日志。

pool-dump-database

Xe pool-dump-database file-name=filename_to_dump_database_into_(on_client) 

下载整个池数据库的副本，并将其转储到客户机上的一个文件中。

pool-enable-external-auth

Xe pool-enable-external-auth auth-type=auth_type service-name=service_name [uuid=uuid] [config:=config] 

对池中的所有主机启用外部认证。的一些值auth-type将需要特定的配置值。

pool-enable-local-storage-caching

Xe pool-enable-local-storage-caching uuid=uuid 

跨池启用本地存储缓存。

pool-enable-redo-log

Xe pool- enable -redo-log sr-uuid=sr_uuid 

在使用的SR上启用重做日志，除非启用了HA。

pool-eject

Xe pool-eject host-uuid=uuid_of_host_to_eject 

指示指定的Citrix Hypervisor服务器离开现有池。

pool-emergency-reset-master

Xe pool-emergency-reset-master master-address=address_of_pool_master 

指示池成员服务器将其主服务器地址重置为新值，并尝试连接到它。不要在主服务器上运行此命令。

pool-emergency-transition-to-master

pool-emergency-transition-to-master 

指示Citrix Hypervisor服务器成员成为池主服务器。只有在主机切换到紧急模式后，Citrix Hypervisor服务器才会接受此命令。紧急模式是指主机已从网络中消失，经过多次重试后无法联系的池中的成员。

如果主机加入存储池后修改过主机密码，该命令会导致主机密码重置。有关更多信息，请参阅(用户命令）.

pool-ha-enable

Xe pool-ha-enable heartbeat-sr-uuid =uuid_of_heartbeat_sr 

在资源池上启用高可用性，使用指定的SR UUID作为中央存储心跳库。

pool-ha-disable

Xe pool-ha-disable 

禁用资源池的高可用性特性。

pool-ha-compute-hypothetical-max-host-failures-to-tolerate

计算在当前池配置下可容忍的最大主机故障数。

pool-ha-compute-max-host-failures-to-tolerate

Xe pool-ha-compute- hypohypotical -max-host-failures-to- tolerance [vm-uuid=vm_uuid] [restart-priority=restart_priority] 

计算提供的建议保护的虚拟机所能容忍的最大主机故障数。

pool-initialize-wlb

Xe pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password 

使用目标workload balancing服务器初始化当前池的工作负载平衡。

pool-join

Xe pool-join master-address=address master-username=username master-password=password 

指示Citrix Hypervisor服务器加入现有池。

pool-management-reconfigure

Xe pool-management-reconfigure [network-uuid=network-uuid] 

重新配置池中所有主机的管理接口，使其使用指定的网口，即用于连接XenCenter的网口。该命令重写了MANAGEMENT_INTERFACE键/etc/xensource-inventory给泳池里所有的主人。

如果指定了接口的设备名(接口必须有IP地址)，则Citrix Hypervisor的主主机立即重新绑定。该命令在正常模式和紧急模式下都有效。

从指定的网络UUID中，识别PIF对象的UUID并将其映射到Citrix Hypervisor服务器，该服务器确定要将哪个IP地址重新绑定到自己。执行此命令时，命令不能处于紧急模式。

警告:

在使用off-host命令时要小心，并确保在新接口上有网络连接。使用xe pif-reconfigure先建立一个。否则，后续的CLI命令将无法到达Citrix Hypervisor服务器。

pool-recover-slaves

Xe pool- recovery -slaves 

指示池主服务器尝试重置当前以紧急模式运行的所有成员的主服务器地址。该命令通常在执行命令后使用pool-emergency-transition-to-master已经被用来设置一个成员作为新的主人。

pool-restore-database

Xe pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false] 

上传数据库备份(使用pool-dump-database)到游泳池。在接收到上传后，主机使用新数据库重新启动自己。

还有一个排练选项，该选项允许您检查是否可以在不实际执行操作的情况下恢复池数据库。默认情况下,管制设置为false。

pool-retrieve-wlb-configuration

pool-retrieve-wlb-configuration 

从Workload Balancing服务器检索池优化标准。

pool-retrieve-wlb-diagnostics

Xe pool-retrieve-wlb-diagnostics [filename=file_name] 

从工作负载平衡服务器检索诊断。

pool-retrieve-wlb-recommendations

pool-retrieve-wlb-recommendations 

从Workload Balancing服务器检索池的虚拟机迁移建议。

pool-retrieve-wlb-report

Xe pool-retrieve-wlb-report report=report [filename=file_name] 

从工作负载平衡服务器检索报告。

pool-rotate-secret

Xe pool-rotate-secret 

旋转池秘密。

池秘密是池中的服务器之间共享的秘密，它使服务器能够证明它是池的成员。具有Pool Admin角色的用户可以在通过SSH连接到服务器时查看此秘密。如果其中一个用户离开了您的组织或失去了他们的pool Admin角色，则轮换池密钥。

pool-send-test-post

设置pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body 

使用HTTPS将给定的主体发送到给定的主机和端口，并打印响应。用于调试TLS层。

pool-send-wlb-configuration

Xe pool-send-wlb-configuration [config:=config] 

设置负载均衡服务器的池优化标准。

pool-sync-database

Xe pool-sync-database 

强制在资源池中的所有主机上同步池数据库。正常情况下不需要执行此命令，因为数据库会定期自动复制。但是，该命令对于确保在执行大量CLI操作后快速复制更改非常有用。

集水池igmp-snooping

Xe pool-param-set [uuid=pool-uuid] [igmp-snooping-enabled=true|false] 

开启或关闭Citrix Hypervisor池的IGMP snooping功能。

PVS加速器命令

使用PVS加速器的命令。

pvs-cache-storage-create

Xe pv -cache-storage-create sr-uuid=sr_uuid pv -site-uuid=pvs_site_uuid size=size 

在给定的SR上为给定的主机配置PVS缓存。

pvs-cache-storage-destroy

Xe pvs-cache-storage-destroy uuid=uuid 

删除PVS缓存。

pvs-proxy-create

Xe pv -proxy-create pv -site-uuid=pvs_site_uuid vif-uuid=vif_uuid 

配置虚拟机/VIF使用PVS代理

pvs-proxy-destroy

命令pvs-proxy-destroy uuid=uuid 

为这个VIF/VM删除(或关闭)一个PVS代理。

pvs-server-forget

Xe pv -server-forget uuid=uuid 

忘记PVS服务器吧。

pvs-server-introduce

Xe pv -server-introduce addresses= address first-port=first_port last-port=last_port pv -site-uuid=pvs_site_uuid 

介绍新的PVS服务器。

pvs-site-forget

Xe pv -site-forget uuid=uuid 

忘记PVS网站吧。

pvs-site-introduce

Xe pv -site- introduction name-label=name_label [name-description=name_description] [pv -uuid=pvs_uuid] 

介绍新的pv站点。

存储管理器命令

控制Storage Manager插件的命令。

存储管理器对象可以使用标准对象列表命令(xe sm-list）.可以使用标准参数命令对参数进行操作。有关更多信息，请参见低级参数命令

SM参数

短信有以下参数:

快照命令

用于处理快照的命令。

snapshot-clone

Xe snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description] 

在可用的情况下，使用存储级快速磁盘克隆操作，通过克隆现有快照创建新模板。

快照复制

Xe snapshot-copy new-name-label=name_label [uuid=uuid] [new-name-description=name_description] [sr-uuid=sr_uuid] 

通过复制现有虚拟机创建新模板，但不使用存储级快速磁盘克隆操作(即使有这种操作)。复制的虚拟机的磁盘映像保证是“完整映像”，即不是CoW链的一部分。

snapshot-destroy

Xe snapshot-destroy [uuid=uuid] [snapshot-uuid=snapshot_uuid] 

销毁快照。这将保留与快照关联的存储。要删除存储，请使用snapshot-uninstall。

snapshot-disk-list

Xe snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params] 

列出所选虚拟机中的磁盘。

snapshot-export-to-template

Xe snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid [preserve-power-state=true|false] 

将快照导出到文件名称．

snapshot-reset-powerstate

Xe snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid][——force] 

仅在管理工具栈数据库中强制虚拟机上电状态为“stopped”。此命令用于恢复被标记为“挂起”的快照。这是一个潜在的危险操作:您必须确保不再需要内存映像。您将无法再恢复快照。

snapshot-revert

Xe snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid] 

将现有虚拟机恢复到以前的检查点或快照状态。

snapshot-uninstall

Xe snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid][——force] 

卸载快照。此操作将销毁那些标记为RW且仅连接到此快照的vdi。如果需要直接销毁虚拟机记录，使用snapshot-destroy命令。

老的命令

用于控制SRs(存储库)的命令。

可以使用标准对象列表命令(xe sr-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

SR参数

SRs有以下参数:

sr-create

Xe sr-create name-label=name physical-size=size type=type content-type=content_type device-config:config_name=value [host-uuid=host_uuid] [shared=true|false] 

在磁盘上创建一个SR，将其引入数据库，并创建一个PBD，将SR连接到Citrix Hypervisor服务器。如果共享设为真正的则为池中的每个Citrix Hypervisor服务器创建一个PBD。如果共享未指定或设置为假，则仅为指定的Citrix Hypervisor服务器创建PBDhost-uuid．

确切的device-config不同设备的参数不同类型．有关不同存储后端之间这些参数的详细信息，请参见存储．

sr-data-source-forget

Xe sr-data-source-forget data-source=data_source 

停止为SR记录指定的数据源，并忘记所有记录的数据。

sr-data-source-list

Xe sr-数据源-list 

列出可为SR记录的数据源。

sr-data-source-query

sql -data-source-query data-source=data_source 

查询从SR数据源读取的最后一个值。

sr-data-source-record

Xe sr-data-source-record data-source=data_source 

记录SR的指定数据源。

sr-destroy

命令sr-destroy uuid=sr_uuid 

销毁Citrix Hypervisor服务器上指定的SR。

sr-enable-database-replication

Xe sr-enable-database-replication uuid=sr_uuid 

启用XAPI数据库复制到指定的(共享的)SR。

sr-disable-database-replication

Xe sr-disable-database-replication uuid=sr_uuid 

禁用XAPI数据库到指定SR的复制。

sr-forget

Xe sr-forget uuid=sr_uuid 

XAPI代理忘记了Citrix Hypervisor服务器上指定的SR。当XAPI代理忘记SR时，SR将被分离，您无法访问SR上的vdi，但SR在源媒体上保持完整(数据不会丢失)。

sr-introduce

Xe sr-introduce name-label=name physical-size=physical_size type=type content-type=content_type uuid=sr_uuid 

只是将SR记录放入数据库。使用device-config以在表单中指定其他参数device-config: parameter_key = parameter_value，例如:

Xe sr-introduce device-config:device=/dev/sdb1——NeedCopy >

注意:

正常情况下不使用该命令。当创建SR后必须将其重新配置为共享时，或者帮助从各种故障场景中恢复时，此高级操作可能很有用。

sr-probe

Xe sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value] 

方法对后端执行扫描device-config钥匙。如果device-config对于SR后端，此命令返回设备上存在的SR的列表(如果有的话)。如果device-config参数只是部分的，执行特定于后端的扫描，返回指导您改进其余部分的结果device-config参数。扫描结果以特定于后端的XML格式返回，并在CLI中打印。

确切的device-config不同设备的参数不同类型．有关不同存储后端之间这些参数的详细信息，请参见存储．

sr-probe-ext

Xe sr-probe-ext type=type [host-uuid=host_uuid] [device-config:=config] [sm-config:-sm_config] 

执行存储探测。设备配置参数可以通过如下命令指定，例如device-config:devs=/dev/sdb1。与SR -probe不同，对于每种SR类型，该命令以相同的人类可读格式返回结果。

sr-scan

Xe sr-scan uuid=sr_uuid 

强制进行SR扫描，将XAPI数据库与存在于底层存储基板中的vdi同步。

sr-update

Xe sr-update uuid=uuid 

刷新数据库中SR对象的字段。

lvhd-enable-thin-provisioning

Xe lvhd-enable-thin-provisioning sr-uuid=sr_uuid initial-allocation=initial_allocation allocation-quantum=allocation_quantum 

在LVHD SR上启用精简配置功能。

主题的命令

用于处理主题的命令。

session-subject-identifier-list

Xe session-subject-identifier-list 

返回所有外部认证的现有会话的所有用户主题id的列表。

session-subject-identifier-logout

Xe session-subject-identifier-logout subject-identifier=subject_identifier 

注销与用户主题id关联的所有外部身份验证会话。

session-subject-identifier-logout-all

session-subject-identifier-logout-all 

注销所有外部认证会话。

subject-add

Xe subject-add subject-name=subject_name 

向可以访问池的主题列表中添加一个主题。

subject-remove

Xe subject-remove subject-uuid=subject_uuid 

从可以访问池的主题列表中删除一个主题。

subject-role-add

Xe subject-role-add uuid=uuid [role-name=role_name] [role-uuid=role_uuid] 

向主题添加角色。

subject-role-remove

Xe subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid] 

从主题中删除角色。

secret-create

Xe secret-create value=value 

创造一个秘密。

secret-destroy

命令secret-destroy uuid=uuid 

摧毁一个秘密。

任务命令

处理长时间运行的异步任务的命令。这些命令是启动、停止和挂起虚拟机等任务。任务通常由一组其他原子子任务组成，这些子任务共同完成所请求的操作。

可以使用标准对象列表命令(xe任务列表)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

任务参数

任务有以下参数:

task-cancel

Xe task-cancel [uuid=task_uuid] 

指示指定的Task取消并返回。

模板的命令

使用虚拟机模板的命令。

模板本质上是虚拟机是一个模板参数设置为真正的．模板是一个“金映像”，其中包含用于实例化特定VM的所有各种配置设置。Citrix Hypervisor附带了一组基本模板，这些模板是通用的“原始”虚拟机，可以引导操作系统供应商的安装CD(例如:RHEL、CentOS、SLES、Windows)。您可以创建VM，根据您的特定需求以标准形式配置它们，并将它们的副本保存为模板，以便将来在VM部署中使用。

可以使用标准对象列表命令(xe模板列表中)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

注意:

不能通过设置模板直接转为虚拟机是一个模板参数假．设置是一个模板参数假不支持，会导致虚拟机无法启动。

虚拟机模板参数说明

模板包含以下参数:

• uuid(只读)模板的唯一标识符/对象引用
• 品牌)(读/写)模板的名称
• name-description(读/写)模板的描述字符串
• user-version(读/写)字符串，供虚拟机和模板的创建者放置版本信息
• 是一个模板(读/写)当此虚拟机为模板时为true。模板虚拟机不能启动，只能用于克隆其他虚拟机。在该值被设置为true之后，它不能被重置为false。该参数不支持模板虚拟机转为虚拟机。
• is-control-domain(只读)如果这是控制域(域0或驱动域)，则为true
• 电源状态(只读)当前电源状态。对于模板，该值始终处于暂停状态
• memory-dynamic-max(只读)以字节为单位的动态最大内存。当前未使用，但如果更改，必须遵守以下约束:memory_static_max＞＝memory_dynamic_max＞＝memory_dynamic_min＞＝memory_static_min．
• memory-dynamic-min(读/写)以字节为单位的动态最小内存。当前未使用，但如果更改了相同的约束memory-dynamic-max必须服从。
• memory-static-max(读/写)以字节为单位静态设置(绝对)最大内存。该字段是用于确定分配给虚拟机的内存量的主要值。
• memory-static-min(读/写)以字节为单位静态设置(绝对)最小内存。该字段表示绝对最小内存，和memory-static-min必须小于memory-static-max．此值在正常操作中是不使用的，但必须遵守前面的约束。
• suspend-VDI-uuid(只读)存储挂起映像的VDI(对模板没有意义)

• VCPUs-params(读写映射参数)所选vCPU策略的配置参数。

  你可以调优一个vCPU的钉住:

  vcpu -params:mask=1,2,3 

  使用该模板创建的虚拟机只能运行在物理cpu 1、2、3上。

  您还可以使用上限和权重参数调优vCPU优先级(xen调度)。例如:

  xe template-param-set uuid= vcpu -params:weight=512 xe template-param-set uuid= vcpu -params:cap=100 

  基于此模板的虚拟机，如果权值为512，在同一台竞争主机上获得的CPU是权值为256的域的2倍。合法权重的取值范围是1 ~ 65535，默认值是256。

  即使Citrix Hypervisor服务器有空闲的CPU周期，该上限也可以选择固定基于此模板的虚拟机可以消耗的最大CPU量。上限表示一个物理CPU的百分比:100表示1个物理CPU, 50表示半个CPU, 400表示4个CPU，以此类推。默认值为0，表示没有上限。

• VCPUs-max(读/写)最大vcpu数
• VCPUs-at-startup(读/写)vcpu的启动数
• actions-after-crash基于该模板的虚拟机崩溃时采取的(读/写)操作
• console-uuids(只读设置参数)虚拟控制台设备

• 平台(读/写映射参数)平台特定配置

  禁用HVM客户机(例如，Windows客户机)的并行端口模拟:

  Xe vm-param-set uuid=平台:parallel=none 

  为HVM客户机禁用串行端口仿真。

  Xe vm-param-set uuid= platform:hvm_serial=none 

  为HVM客户机禁用USB控制器和USB平板设备的仿真:

  Xe vm-param-set uuid=平台:usb=false Xe vm-param-set uuid=平台:usb_tablet=false 

• 允许的操作(只读设置参数)该状态下允许的操作列表
• 当前操作(只读设置参数)当前在此模板上正在进行的操作列表
• allowed-VBD-devices(只读设置参数)可用的VBD标识符列表，用0-15范围的整数表示。此列表仅供参考，可能会使用其他设备(但可能不起作用)。
• allowed-VIF-devices(只读设置参数)可用的VIF标识符列表，由0-15范围的整数表示。此列表仅供参考，可能会使用其他设备(但可能不起作用)。
• HVM-boot-policy(读/写)HVM客户机的启动策略。BIOS Order或空字符串。
• HVM-boot-params(读/写映射参数)order键控制HVM客户机引导顺序，用字符串表示，其中每个字符是一种引导方式:d表示CD/DVD, c表示根磁盘，n表示网络PXE引导。默认为dc。
• PV-kernel(读/写)路径到内核
• PV-ramdisk的(读/写)路径initrd
• PV-args(读/写)内核命令行参数字符串
• PV-legacy-args(读/写)参数字符串，使基于此模板的旧虚拟机启动
• PV-bootloader(读/写)引导加载程序的名称或路径
• PV-bootloader-args(读/写)引导加载程序的杂项参数字符串
• last-boot-CPU-flags(只读)描述基于此模板的虚拟机上次启动时使用的CPU标志;没有为模板填充
• 居民在(只读)基于该模板的虚拟机所在的Citrix Hypervisor服务器。显示为不在数据库中对于模板
• 亲和力(读/写)基于此模板的虚拟机优先运行的Citrix Hypervisor服务器。由xe vm-start命令，以决定在何处运行虚拟机
• 其他配置(读/写映射参数)键/值对列表，为模板指定额外的配置参数
• 启动时间(只读)时间戳，读取基于此模板的VM的度量标准的日期和时间，格式为yyyymmddThh: mm: ss z，其中z是单个字母的军用时区指示符，例如，z代表UTC(GMT)。设置为1970年1月1日(Unix/POSIX纪元的开始)用于模板
• 安装时(只读)时间戳，读取基于此模板的VM的度量标准的日期和时间，格式为yyyymmddThh: mm: ss z，其中z是单个字母的军用时区指示符，例如，z代表UTC (GMT)。设置为1970年1月1日(Unix/POSIX纪元的开始)用于模板
• memory-actual(只读)基于该模板的虚拟机实际使用的内存;模板为0
• VCPUs-number(只读)根据该模板分配给虚拟机的虚拟cpu数量;模板为0
• VCPUs-Utilization(只读映射参数)虚拟cpu列表及其权重只读映射参数操作系统版本使用该模板创建虚拟机的操作系统版本。显示为不在数据库中对于模板
• PV-drivers-version(只读映射参数)基于该模板的虚拟机的半虚拟化驱动版本。显示为不在数据库中对于模板
• PV-drivers-detected(只读)标志，表示基于该模板的虚拟机的半虚拟化驱动程序的最新版本。显示为不在数据库中对于模板
• 内存(只读映射参数)代理根据该模板上报的虚拟机内存指标。显示为不在数据库中对于模板
• 磁盘(只读映射参数)代理根据该模板上报的虚拟机磁盘指标。显示为不在数据库中对于模板
• 网络(只读映射参数)代理根据该模板上报的虚拟机网络指标。显示为不在数据库中对于模板
• 其他(只读映射参数)代理根据此模板在虚拟机上报告的其他指标。显示为不在数据库中对于模板
• guest-metrics-last-updated(只读)guest代理执行最后一次写入这些字段的时间戳。在表格中yyyymmddThh: mm: ss z，其中z是单个字母的军用时区指示符，例如，z代表UTC (GMT)。
• actions-after-shutdown虚拟机关机后需要执行的(读/写)操作
• actions-after-reboot虚拟机重启后需要执行的读/写操作
• possible-hosts(只读)可能承载该虚拟机的主机列表
• HVM-shadow-multiplier(读/写)倍增器应用于可提供给来宾的阴影量
• dom-id(只读)域ID(如果可用，则为-1)
• 建议(只读)该虚拟机属性推荐值和范围的XML规范
• xenstore-data(读/写映射参数)要插入的数据xenstore树(/地方/域/ * domid * / vmdata)。
• 都只能(只读)当此模板为虚拟机快照时为True
• snapshot_of(只读)该模板被快照的虚拟机UUID
• 快照(只读)该模板的所有快照的uuid
• snapshot_time(只读)虚拟机最近一次快照的时间戳
• memory-target(只读)此模板设置的目标内存量
• blocked-operations(读写映射参数)列出了该模板不能执行的操作
• last-boot-record(只读)这个模板的最后一个引导参数的记录，XML格式
• ha-always-run(读/写)如果这个模板的实例总是在另一个主机上重启，如果它所在的主机发生故障，True。该参数现在已弃用。使用ha-restartpriority参数。
• ha-restart-priority(只读)重启或尽最大努力读/写blobs二进制数据存储
• 生活(只读)仅与运行中的虚拟机相关。

模板导出

Xe template-export template-uuid=uuid_of_existing_template filename=filename_for_new_template 

将指定模板的副本导出到具有指定新文件名的文件。

template-uninstall

Xe template-uninstall template-uuid=template_uuid[——force] 

卸载自定义模板。该操作将销毁那些被该模板标记为“拥有”的vdi。

更新命令

以下章节包含Citrix Hypervisor服务器更新命令。

可以使用标准对象列表命令(xe update-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

更新参数

Citrix Hypervisor服务器更新包含以下参数:

update-upload

Xe update-upload file-name=update_filename 

将指定的更新文件上传到Citrix Hypervisor服务器。此命令准备要应用的更新。如果成功，将打印上传更新的UUID。如果更新之前已经上传，UPDATE_ALREADY_EXISTS返回错误，补丁不能再次上传。

update-precheck

Xe update-precheck uuid=update_uuid host-uuid=host_uuid 

在指定的Citrix Hypervisor服务器上运行指定更新中包含的预检。

update-destroy

update-destroy uuid=update_file_uuid——NeedCopy >

删除尚未从池中应用的更新文件。用于删除不能应用于主机的更新文件。

update-apply

Xe update-apply host-uuid=host_uuid uuid=update_file_uuid 

应用指定的更新文件。

update-pool-apply

更新池-应用uuid=update_uuid 

将指定的更新应用于池中的所有Citrix Hypervisor服务器。

update-introduce

Xe update-introduce vdi_uuid =vdi_uuid 

引入更新VDI。

update-pool-clean

Xe update-pool-clean uuid=uuid 

从池中的所有主机中删除更新文件。

用户命令

user-password-change

Xe user-password-change old=old_password new=new_password 

修改当前登录用户的密码。没有检查旧密码字段，因为您需要管理员权限才能使用此命令。

VBD命令

使用vbd(虚拟块设备)的命令。

VBD是连接虚拟机和VDI的软件对象，VDI代表虚拟磁盘的内容。VBD具有将VDI绑定到VM的属性(它是否可引导，它的读/写指标，等等)。VDI包含有关虚拟磁盘物理属性的信息(SR类型、磁盘是否可共享、介质是读写还是只读，等等)。

VBD对象可以使用标准对象列表命令(xe vbd-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

VBD参数

vbd有以下参数:

vbd-create

vdi-uuid= uuid_of_the_vm device=device_value vdi-uuid=uuid_of_vdi_to_connect_to [bootable=true] [type=Disk|CD] [mode=RW|RO] 

在虚拟机上创建VBD。

的允许值设备字段为整数，取值范围为0 ~ 15，且每个虚拟机的序号不能重复。中可以看到当前的允许值allowed-VBD-devices参数。这被看作是userdevice在vbd参数。

如果类型是磁盘，vdi-uuid是必需的。模式可以是罗依或RW用于磁盘。

如果类型是CD，vdi-uuid是可选的。如果不指定VDI，则为CD创建一个空VDI罗依买一张CD。

vbd-destroy

vbd-destroy uuid= uid_of_vbd 

销毁指定的VBD。

如果VBD有它的其他配置:老板参数设置为真正的，关联的VDI也会被销毁。

vbd-eject

Xe vbd-eject uuid= uid_of_vbd 

从VBD表示的驱动器中删除媒体。此命令仅在介质为可移动类型(物理CD或ISO)时有效。否则，显示错误信息VBD_NOT_REMOVABLE_MEDIA返回。

vbd-insert

Xe vbd-insert uuid=uuid_of_vbd vdi-uuid=uuid_of_vdi_containing_media 

将新媒体插入由VBD表示的驱动器中。此命令仅在介质为可移动类型(物理CD或ISO)时有效。否则，显示错误信息VBD_NOT_REMOVABLE_MEDIA返回。

vbd-plug

vbd-plug uuid= uid_of_vbd 

在虚拟机处于运行状态时尝试挂载VBD。

vbd-unplug

vbd-unplug uuid= uid_of_vbd 

当VBD处于运行状态时，尝试将其从虚拟机中分离出来。

VDI的命令

使用vdi(虚拟磁盘映像)的命令。

VDI是一个软件对象，表示虚拟机所看到的虚拟磁盘的内容。这与VBD不同，VBD是将VM绑定到VDI的对象。VDI包含有关虚拟磁盘物理属性的信息(SR类型、磁盘是否可共享、介质是读写还是只读，等等)。VBD具有将VDI绑定到VM的属性(它是否可引导，它的读/写度量，等等)。

VDI对象可以使用标准对象列表命令(xe vdi-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

VDI参数

vdi有以下参数:

vdi-clone

Xe vdi-clone uuid=uuid_of_the_vdi [driver-params:key=value] 

创建可直接使用的指定VDI的新的可写副本。它是…的变体vdi-copy这是可以暴露高速图像克隆设施存在的地方。

使用可选的driver-paramsmap参数将额外的特定于供应商的配置信息传递到VDI所基于的后端存储驱动程序。有关详细信息，请参阅存储供应商驱动程序文档。

vdi-copy

Xe vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr 

将VDI复制到指定的SR。

vdi-create

Xe vdi-create sr-uuid=uuid_of_sr_to_create_vdi_on name-label=name_for_the_vdi type=system|user|suspend|crashdump virtual-size=size_of_virtual_disk sm-config-\*=storage_specific_configuration_data 

创建VDI。

的虚拟内存参数可以以字节为单位或使用IEC标准后缀KiB、MiB、GiB和TiB来指定。

注意:

支持磁盘精简配置的SR类型(如Local VHD和NFS)不强制磁盘虚拟分配。在SR上过度分配虚拟磁盘空间时要非常小心。如果过度分配的SR已满，则必须在SR目标基板上或通过删除SR中未使用的vdi来提供磁盘空间。

一些SR类型可能会把虚拟内存值，使其可被配置的块大小整除。

vdi-data-destroy

vdi-data-destroy uuid= uid_of_vdi 

销毁与指定VDI相关的数据，但保留已更改的块跟踪元数据。

注意:

如果您使用更改块跟踪对VDI进行增量备份，请确保使用vdi-data-destroy命令，删除快照，但保留元数据。不要使用vdi-destroy已启用块跟踪的vdi的快照。

vdi-destroy

Xe vdi-destroy uuid= uid_of_vdi 

销毁指定的VDI。

注意:

如果您使用更改块跟踪对VDI进行增量备份，请确保使用vdi-data-destroy命令，删除快照，但保留元数据。不要使用vdi-destroy已启用块跟踪的vdi的快照。

对于Local VHD和NFS SR类型，磁盘空间不会立即释放vdi-destroy，但在存储库扫描操作期间定期。如果必须强制已删除的磁盘空间可用，请调用sr-scan手动。

vdi-disable-cbt

Xe vdi-disable-cbt uuid= uid_of_vdi 

禁用VDI的更改块跟踪。

vdi-enable-cbt

Xe vdi-enable-cbt uuid= uid_of_vdi 

启用VDI的更改块跟踪。

注意:

您只能在Citrix Hypervisor高级版的许可实例上启用更改块跟踪。

vdi-export

Xe vdi-export uuid=uuid_of_vdi filename=filename_to_export_to [format=format] [base=uuid_of_base_vdi][——progress] 

导出VDI到指定的文件名。导出VDI的格式有以下几种:

• 生
• vhd

VHD格式可以稀疏的．如果VDI中有未分配的块，则可以从VHD文件中省略这些块，从而使VHD文件更小。支持从所有支持的VHD存储类型(EXT3/EXT4、NFS)导出为VHD格式。

如果您指定基地参数时，该命令只导出在导出的VDI和基本VDI之间发生了变化的块。

vdi-forget

vdi-forget uuid= uid_of_vdi 

无条件地从数据库中删除一条VDI记录，而不触及存储后端。在正常操作中，您应该使用vdi-destroy代替。

vdi-import

Xe vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format][——progress] 

导入VDI。您可以从以下格式之一导入VDI:

• 生
• vhd

vdi-introduce

Xe vdi-introduce uuid=uuid_of_vdi sr-uuid=uuid_of_sr name-label=name_of_new_vdi type=system|user|suspend|crashdump location=device_location_(varies_by_storage_type) [name-description=description_of_vdi] [shared =yes|no] [read-only=yes|no] [other-config=map_to_store_misc_user_specific_data] [xenstore-data=map_to_of_additional_xenstore_keys] [ms -config=storage_specific_configuration_data] 

创建代表现有存储设备的VDI对象，而无需实际修改或创建任何存储。该命令主要用于内部自动引入热插拔存储设备。

vdi-list-changed-blocks

vdi-list-changed-blocks vdi-from-uuid=first-vdi-uuid vdi-to-uuid=second-vdi-uuid 

比较两个vdi并以base64编码字符串的形式返回两个vdi之间发生变化的块列表。该命令仅对已使能块跟踪的vdi有效。

有关更多信息，请参见更改块跟踪．

vdi-pool-migrate

xe vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid 

将VDI迁移到指定的SR，同时将VDI附加到正在运行的客户机。(存储热迁移)

有关更多信息，请参见迁移虚拟机．

vdi-resize

Xe vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk 

修改UUID指定的VDI的大小。

vdi-snapshot

Xe vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params] 

生成一个VDI的可读写版本，该版本可以用作备份或模板创建的参考，也可以同时用作两者的参考。使用快照执行备份，而不是在虚拟机内部安装和运行备份软件。当外部备份软件将快照内容流式传输到备份介质时，虚拟机将继续运行。类似地，快照可以用作模板的“金映像”。可以使用任何vdi制作模板。

使用可选的driver-paramsmap参数将额外的特定于供应商的配置信息传递到VDI所基于的后端存储驱动程序。有关详细信息，请参阅存储供应商驱动程序文档。

快照的克隆应该总是产生一个可写的VDI。

vdi-unlock

Xe vdi-unlock uuid= uid_of_vdi_to_unlock [force=true] 

尝试解锁指定的vdi。如果力= true传递给命令时，它强制执行解锁操作。

vdi-update

Xe vdi-update uuid=uuid 

刷新数据库中VDI对象的字段。

VIF的命令

使用vif(虚拟网络接口)的命令。

VIF对象可以使用标准对象列表命令(xe vif-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

VIF参数

vif有以下参数:

• uuid(只读)VIF的唯一标识符/对象引用
• vm-uuid(只读)这个VIF所在的虚拟机的唯一标识符/对象引用
• vm-name-label(只读)该VIF所在的虚拟机的名称
• 允许的操作(只读设置参数)在此状态下允许的操作列表
• 当前操作(只读设置参数)当前在这个VIF上正在进行的操作的列表
• 设备(只读)该VIF的整数标签，指示创建VIF后端的顺序
• MAC(只读)VIF的MAC地址，暴露给虚拟机

• MTU(read only) VIF的最大传输单位，以字节为单位。

  该参数为只读，但可以使用mtu键使用其他配置映射参数。例如，将虚拟网卡上的MTU重置为使用jumbo帧:

  Xe vif-param-set \ uuid= \ other-config:mtu=9000 

• currently-attached(只读)如果设备已连接，则为true
• qos_algorithm_type(读/写)使用的QoS算法
• qos_algorithm_params(读写映射参数)所选QoS算法的参数
• qos_supported_algorithms(只读设置参数)此VIF支持的QoS算法
• MAC-autogenerated(只读)如果VIF的MAC地址是自动生成的，为True
• 其他配置(读/写映射参数)额外配置键:值双
• 其他配置:ethtoolrx(读/写)设置为on为启用接收校验和，off为禁用
• 其他配置:ethtooltx(读/写)设置为on为启用传输校验和，off为禁用
• 其他配置:ethtoolsg(读/写)设置为on使分散聚集，关闭禁用
• 其他配置:ethtooltso(读/写)设置为on为启用TCP分段卸载，off为禁用
• 其他配置:ethtoolufo(读/写)设置为on开启UDP分片卸载，off关闭
• 其他配置:ethtoolgso(读/写)设置为on为启用通用分段卸载，off为禁用
• 其他配置:滥交(读/写)一个VIF在桥上是混杂的，这样它就能看到桥上的所有交通。用于在虚拟机中运行入侵检测系统(IDS)或类似系统。
• network-uuid(只读)该VIF所连接的虚拟网络的唯一标识符/对象引用
• network-name-label(只读)该VIF所连接的虚拟网络的描述性名称
• io_read_kbs(只读)该VIF的平均读取速率，单位为kB/s
• io_write_kbs(只读)该VIF的平均写速率，单位为kB/s
• locking_mode(读/写)影响VIFs对MAC和IP地址列表的流量过滤能力。需要额外的参数。

• locking_mode:默认(读/写)根据VIF网络默认的锁模式不同。

  如果将默认锁定模式设置为禁用Citrix Hypervisor设置了一个过滤规则，使VIF无法接收或发送流量。如果default-lockingmode设置为解锁， Citrix Hypervisor删除与VIF相关的所有过滤规则。有关更多信息，请参见网络命令．

• locking_mode:锁定(读/写)在VIF上只允许从指定的MAC地址和IP地址发送或发送流量。如果不指定IP地址，表示不允许任何流量通过。
• locking_mode:解锁(读/写)没有过滤器应用到任何流量去或从VIF。
• locking_mode:禁用(读/写)Citrix Hypervisor应用过滤规则，使VIF丢弃所有流量。

vif-create

Xe vif-create vm-uuid=uuid_of_the_vm device=如下所示network-uuid=uuid_of_network_to_connect_to [mac=mac_address] 

在虚拟机上创建VIF

的适当值。设备字段列在参数中allowed-VIF-devices在指定虚拟机上安装。在存在任何vif之前，允许的值是0-15之间的整数。

的mac参数为格式中的标准MAC地址aa: bb: cc: dd: ee: ff．如果不指定，则会创建一个适当的随机MAC地址。也可以通过指定显式设置随机MAC地址mac =随机．

vif-destroy

vif-destroy uuid= uid_of_vif 

销毁一个VIF。

vif-move

Xe vif-move uuid=uuid network-uuid=network_uuid 

将VIF移动到另一个网络。

vif-plug

Xe vif-plug uuid=uuid_of_vif 

尝试在虚拟机处于运行状态时附加VIF。

vif-unplug

uuid= uid_of_vif 

尝试在虚拟机运行时将VIF与虚拟机分离。

vif-configure-ipv4

配置该虚接口的IPv4配置。设置IPv4设置如下:

xe vif- configuration -ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address 

例如:

VIF。configure_ipv4(vifObject，"static"， " 192.168.1.10/24"， " 192.168.1.1") 

清除IPv4设置如下:

Xe vif- configuration -ipv4 uuid=uuid_of_vif mode=none 

vif-configure-ipv6

配置虚拟接口的IPv6配置。设置IPv6设置如下:

xe vif-config -ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address 

例如:

VIF。configure_ipv6(vifObject，"static"， "fd06:7768:b9e5:8b00::5001/64"， "fd06:7768:b9e5:8b00::1") 

清除IPv6设置如下:

Xe vif- configuration -ipv6 uuid=uuid_of_vif mode=none 

VLAN的命令

vlan(虚拟网络)相关命令。要列出和编辑虚拟接口，请参考PIF命令，这些命令有一个VLAN参数，表示它们具有关联的虚拟网络。有关更多信息，请参见论坛的命令．例如，要列出vlan，请使用xe pif-list．

vlan-create

vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network 

在Citrix Hypervisor服务器上创建VLAN。

pool-vlan-create

Xe pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network 

在池中的所有主机上创建VLAN，通过确定哪个接口(例如，eth0)指定的网络(在每个主机上)，并相应地在每个主机上创建和插入一个新的PIF对象。

vlan-destroy

Xe vlan-destroy uuid= uid_of_pif_mapped_to_vlan 

销毁VLAN。需要表示VLAN的PIF的UUID。

虚拟机的命令

虚拟机及其属性控制命令。

虚拟机选择器

这里列出的几个命令都有一个通用机制，用于选择要在其上执行操作的一个或多个vm。最简单的方法是提供论证vm = name_or_uuid．获取实际VM的uid的一种简单方法是执行Xe vm-list power-state=running．(获取可以通过使用该命令匹配的字段的完整列表Xe vm-list params=all)。例如，指定电源状态=停止选择以下虚拟机电源状态参数等于停止．当有多个虚拟机匹配时，指定选项——多个执行操作。本节开头描述了可以匹配的参数的完整列表。

可以使用标准对象列表命令(xe vm-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

虚拟机参数

虚拟机包含以下参数:

注意:

所有可写虚拟机的参数值都可以在虚拟机运行时修改，但新参数不能修改不动态应用，在重启虚拟机之前不能应用。

• 设备(读/写)虚拟机所属的appliance/vApp
• uuid(只读)虚拟机的唯一标识符/对象引用
• 品牌)(读/写)虚拟机的名称
• name-description(读/写)虚拟机的描述字符串
• 订单启动订单(读/写)用于vApp启动/关闭和HA故障切换后的启动
• 版本(只读)该虚拟机恢复的次数。如果要用旧版本覆盖新VM，请调用vm-recover
• user-version(读/写)字符串，供虚拟机和模板的创建者放置版本信息
• 是一个模板(读/写)False，除非该虚拟机是模板。模板虚拟机永远不会启动，仅用于克隆其他虚拟机。设置为“true”后，不能重置为“false”。该参数不支持模板虚拟机转为虚拟机。
• is-control-domain(只读)如果这是控制域(域0或驱动域)，则为True。
• 电源状态(只读)当前电源状态
• 起动延迟(读/写)在启动VM的调用返回之前等待的延迟
• shutdown-delay(读/写)在关闭虚拟机的调用返回之前等待的延迟
• memory-dynamic-max(读/写)动态最大字节数
• memory-dynamic-min(读/写)以字节为单位的动态最小值
• memory-static-max(读/写)静态设置(绝对)最大字节。如果要修改该值，必须先关闭虚拟机。
• memory-static-min(读/写)静态设置(绝对)最小字节。如果要修改该值，必须先关闭虚拟机。
• suspend-VDI-uuid(只读)存储挂起映像的VDI

• VCPUs-params(读写映射参数)所选vCPU策略的配置参数。

  可以调优vCPU的固定

  vcpu -params:mask=1,2,3 

  选择的虚拟机只能运行在物理cpu 1、2、3上。您还可以使用上限和权重参数调优vCPU优先级(xen调度)。例如:

  xe vm-param-set uuid= vcpu -params:weight=512 xe vm-param-set uuid= vcpu -params:cap=100 

  在竞争的Citrix Hypervisor服务器上，一个权重为512的虚拟机获得的CPU是一个权重为256的域的两倍。合法权重的取值范围是1 ~ 65535，默认值是256。即使Citrix Hypervisor服务器有空闲的CPU周期，上限也可以选择固定虚拟机能够消耗的最大CPU量。上限表示一个物理CPU的百分比:100表示1个物理CPU, 50表示半个CPU, 400表示4个CPU，以此类推。默认值为0，表示没有上限。

• VCPUs-max(读/写)最大虚拟cpu数。
• VCPUs-at-startup(读/写)虚拟cpu的启动数
• actions-after-crash虚拟机崩溃时需要执行的(读/写)操作。对于PV客户机，有效参数为:
  • 保存(只供分析)
  • coredump_and_restart(录制coredump并重启虚拟机)
  • coredump_and_destroy(记录一个coredump并让VM停止)
  • 重新启动(无coredump，重启虚拟机)
  • 摧毁(没有coredump, VM暂停)
• console-uuids(只读设置参数)虚拟控制台设备

• 平台(读/写映射参数)平台特定的配置

  要禁用VDA以将Windows 10切换到Tablet模式:

  Xe vm-param-set uuid= platform:acpi_laptop_slate=0 

  启用VDA将Windows 10切换到Tablet模式:

  Xe vm-param-set uuid= platform:acpi_laptop_slate=1 

  查看当前状态。

  Xe vm-param-get uuid= param-name=platform param-key=acpi_laptop_slate 

• 允许的操作(只读设置参数)该状态下允许的操作列表
• 当前操作(只读设置参数)虚拟机当前正在进行的操作列表
• allowed-VBD-devices(只读设置参数)可用的VBD标识符列表，用0-15范围的整数表示。此列表仅供参考，可能会使用其他设备(但可能无法工作)。
• allowed-VIF-devices(只读设置参数)可用的VIF标识符列表，由0-15范围的整数表示。此列表仅供参考，可能会使用其他设备(但可能无法工作)。
• HVM-boot-policy(读/写)HVM客户机的启动策略。BIOS Order或空字符串。
• HVM-boot-params(读/写映射参数)order键控制HVM客户机引导顺序，用字符串表示，其中每个字符是一种引导方式:d表示CD/DVD, c表示根磁盘，n表示网络PXE引导。默认为dc。
• HVM-shadow-multiplier(读/写)浮点值，用于控制授予虚拟机的影子内存开销。默认值为1.0(最小值)，只有高级用户才应该更改此值。
• PV-kernel(读/写)路径到内核
• PV-ramdisk的(读/写)路径initrd
• PV-args(读/写)内核命令行参数字符串
• PV-legacy-args(读/写)一串参数，使旧的虚拟机启动
• PV-bootloader(读/写)引导加载程序的名称或路径
• PV-bootloader-args(读/写)引导加载程序的杂项参数字符串
• last-boot-CPU-flags(只读)描述虚拟机上次启动时的CPU标志位
• 居民在(只读)虚拟机所在的Citrix Hypervisor服务器
• 亲和力(读/写)虚拟机优先选择在其上运行的Citrix Hypervisor服务器。由xe vm-start命令，以决定在何处运行虚拟机
• 其他配置(读/写映射参数)键/值对列表，为虚拟机指定额外的配置参数。例如，主机启动后虚拟机自动启动其他配置参数包括键值对auto_poweron:真
• 启动时间(只读)读取VM指标的日期和时间戳。这个时间戳的形式是yyyymmddThh: mm: ss z，其中z是单个字母的军事时区指示符，例如，z代表UTC (GMT)。
• 安装时(只读)读取VM指标的日期和时间戳。这个时间戳的形式是yyyymmddThh: mm: ss z，其中z是单个字母的军事时区指示符，例如，z代表UTC (GMT)。
• memory-actual(只读)虚拟机实际使用的内存
• VCPUs-number(只读)Linux虚拟机分配的虚拟cpu数量。这个数字可以不同于VCPUS-max可以在不重启虚拟机的情况下使用vm-vcpu-hotplug命令。有关更多信息，请参见vm-vcpu-hotplug．Windows虚拟机总是在vcpu数量设置为的情况下运行VCPUsmax并且必须重新启动才能更改此值。当你设置时，性能急剧下降VCPUs-number设置为大于Citrix Hypervisor服务器物理cpu个数的值。
• VCPUs-Utilization(只读映射参数)虚拟cpu及其权重的列表
• 操作系统版本(只读映射参数)虚拟机操作系统版本
• PV-drivers-version(只读映射参数)虚拟机的半虚拟化驱动版本
• PV-drivers-detected虚拟机最新版本的半虚拟化驱动程序(只读)标志
• 内存(只读映射参数)代理在虚拟机上报告的内存指标
• 磁盘(只读映射参数)代理在虚拟机上上报的磁盘指标
• 网络(只读映射参数)虚拟机上代理上报的网络指标
• 其他(只读映射参数)代理在虚拟机上报告的其他指标
• guest-metrics-lastupdated(只读)guest代理执行最后一次写入这些字段的时间戳。时间戳的形式如下yyyymmddThh: mm: ss z，其中z是单个字母的军事时区指示符，例如，z代表UTC (GMT)。
• actions-after-shutdown虚拟机关机后需要执行的(读/写)操作
• actions-after-reboot虚拟机重启后需要执行的读/写操作
• possible-hosts该虚拟机的潜在主机只读
• dom-id(只读)域ID(如果可用，则为-1)
• 建议(只读)该虚拟机属性推荐值和范围的XML规范
• xenstore-data(读/写映射参数)要插入的数据xenstore树(/地方/域/ * domid * /虚拟机数据)
• 都只能(只读)该虚拟机为快照时为True
• snapshot_of(只读)该快照所在虚拟机的UUID
• 快照(只读)该虚拟机所有快照的uuid
• snapshot_time(只读)创建该虚拟机快照的快照操作的时间戳
• memory-target(只读)为该虚拟机设置的目标内存量
• blocked-operations(读写映射参数)列出了该虚拟机不能执行的操作
• last-boot-record(只读)这个模板的最后一个引导参数的记录，XML格式
• ha-always-run(读/写)如果该虚拟机在其所在主机故障时总是在另一台主机上重启，则为True。该参数现在已弃用。使用ha-restart-priority参数。
• ha-restart-priority(读/写)重启或best-effort
• 斑点(只读)二进制数据存储
• 生活(只读)虚拟机处于运行状态时为True。如果HA怀疑虚拟机未运行，则为False。

vm-assert-can-be-recovered

Xe vm-assert-can-be-recover uuid [database] vdi-uuid 

测试是否有可用的存储来恢复此虚拟机。

vm-call-plugin

Xe vm-call-plugin vm-uuid=vm_uuid plugin=plugin fn=function [args:key=value] 

使用可选参数(args:key=value)在给定VM上调用插件中的函数。要传递包含特殊字符的"value"字符串(例如new line)，可以使用另一种语法args:key:file=local_file，其中将检索local_file的内容并将其作为一个整体分配给"key"。

vm-cd-add

Xe vm-cd-add cd-name=name_of_new_cd device=integer_value_of_an_available_vbd [vm-selector=vm_selector_value…]) < !——NeedCopy >

向所选虚拟机添加新的虚拟CD。的设备参数的值中选择allowed-VBD-devices参数。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-cd-eject

Xe vm-cd-eject [vm-selector=vm_selector_value…]) < !——NeedCopy >

从虚拟光驱中弹出光盘。该命令仅在虚拟机挂载了一张CD的情况下有效。当有两个或更多的cd时，使用该命令xe vbd-eject并指定VBD的UUID。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-cd-insert

Xe vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value…]) < !——NeedCopy >

将CD插入虚拟光驱。该命令仅在虚拟机中只有一个空CD设备时有效。当有两个或多个空CD设备时，使用xe vbd-insert命令，并指定要插入的VBD和VDI的uuid。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-cd-list

Xe vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value…]) < !——NeedCopy >

列出指定虚拟机挂载的cd列表。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

您还可以选择列出哪些VBD和VDI参数。

vm-cd-remove

Xe vm-cd-remove cd-name=name_of_cd [vm-selector=vm_selector_value…]) < !——NeedCopy >

从指定的虚拟机中移除虚拟光盘。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-checkpoint

Xe vm-checkpoint new-name-label=name_label [new-name-description=description] 

检查点现有的虚拟机，在可用的情况下使用存储级快速磁盘快照操作。

vm-clone

Xe vm-clone new-name-label=name_for_clone [new-name-description=description_for_clone] [vm-selector=vm_selector_value…]) < !——NeedCopy >

克隆现有的虚拟机，在可用的情况下使用存储级快速磁盘克隆操作。指定克隆结果虚拟机的名称和可选描述new-name-label和new-name-description参数。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-compute-maximum-memory

xe vm-compute-maximum-memory total=amount_of_available_physical_ram_in_bytes [approximate=add overhead memory for additional vcpu ?]真|假][vm_selector = vm_selector_value……) < !——NeedCopy >

以物理内存总量为上限，计算可分配给现有虚拟机的最大静态内存量。可选参数近似在计算时预留足够的额外内存，以便后续为虚拟机增加额外的vcpu。

例如:

Xe vm-compute-maximum-memory vm=testvm total= ' Xe host-list params=memory-free——minimal ' 

该命令使用空闲内存的返回参数。xe主机列表命令，设置虚拟机的最大内存testvm．

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-compute-memory-overhead

Xe vm-compute-memory-overhead 

计算虚拟机的虚拟化内存开销。

vm-copy

Xe vm-copy new-name-label=name_for_copy [new-name-description=description_for_copy] [sr-uuid=uuid_of_sr] [vm-selector=vm_selector_value…]) < !——NeedCopy >

复制现有的虚拟机，但不使用存储级快速磁盘克隆操作(即使有此选项)。拷贝后的虚拟机磁盘映像必须为完整的图片也就是说，它不是写时复制(CoW)链的一部分。

指定结果复制的虚拟机的名称和可选描述new-name-label和new-name-description参数。

为最终复制的虚拟机指定目标SRsr-uuid．如果不指定此参数，则表示目的地与原虚拟机所在的SR相同。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-copy-bios-strings

Xe vm-copy-bios-strings host-uuid=host_uuid 

将指定主机的BIOS字符串拷贝到虚拟机中。

注意:

虚拟机首次启动后，不支持修改BIOS字符串。第一次启动虚拟机时，请确保BIOS的字符串设置正确。

vm-crashdump-list

Xe vm-crashdump-list [vm-selector=vm选择器value…]) < !——NeedCopy >

列出与指定虚拟机关联的崩溃转储。

当你使用可选参数时参数个数， params的值是一个字符串，其中包含要显示的该对象的参数列表。或者，您可以使用关键字所有显示所有参数。如果参数个数，则返回的列表显示所有可用参数的默认子集。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-data-source-list

Xe vm-data-source-list [vm-selector=vm选择器值…]) < !——NeedCopy >

列出虚拟机可记录的数据源。

通过标准选择机制，选择需要执行该操作的虚拟机。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。如果不提供选择主机的参数，则对所有虚拟机执行该操作。

数据源有两个参数-标准和启用-您可以在该命令的输出中看到。如果数据源具有启用设置为真正的，这些指标当前被记录到性能数据库中。如果数据源具有标准设置为真正的默认情况下，度量被记录到性能数据库中启用也被设置为真正的对于此数据源)。如果数据源具有标准设置为假，指标是不默认情况下记录到性能数据库(和启用也被设置为假对于此数据源)。

要开始将数据源指标记录到性能数据库，请运行vm-data-source-record命令。这个命令设置启用来真正的．停止，运行vm-data-source-forget．这个命令设置启用来假．

vm-data-source-record

Xe vm-data-source-record data-source=name_description_of_data-source [vm-selector=vm选择器value…]) < !——NeedCopy >

记录虚拟机指定的数据源。

通过该操作，可以将数据源中的信息写入指定虚拟机的持久性能指标数据库。出于性能原因，该数据库不同于普通的代理数据库。

通过标准选择机制，选择需要执行该操作的虚拟机。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。如果不提供选择主机的参数，则对所有虚拟机执行该操作。

vm-data-source-forget

Xe vm-data-source-forget data-source=name_description_of_data-source [vm-selector=vm selector value…]) < !——NeedCopy >

停止对虚拟机指定数据源的记录，并忘记记录的所有数据。

通过标准选择机制，选择需要执行该操作的虚拟机。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。如果不提供选择主机的参数，则对所有虚拟机执行该操作。

vm-data-source-query

vm-data-source-query data-source=name_description_of_data-source [vm-selector=vm_selector_value…]) < !——NeedCopy >

显示虚拟机的指定数据源。

通过标准选择机制，选择需要执行该操作的虚拟机。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。如果不提供选择主机的参数，则对所有虚拟机执行该操作。

vm-destroy

Xe vm-destroy uuid=uuid_of_vm 

销毁指定虚拟机。这将保留与虚拟机关联的存储。也可以删除存储，使用xe vm-uninstall．

vm-disk-add

Xe vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value…]) < !——NeedCopy >

为指定虚拟机添加磁盘。选择设备参数的值allowed-VBD-devices参数。

的磁盘容量参数可以以字节为单位或使用IEC标准后缀KiB、MiB、GiB和TiB来指定。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-disk-list

Xe vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value…]) < !——NeedCopy >

列出指定虚拟机绑定的磁盘列表。的vbd-params和vdi-params参数控制要输出的各个对象的字段。以逗号分隔的列表或特殊键的形式给出参数所有查看完整的列表。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-disk-remove

Xe vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value…]) < !——NeedCopy >

将磁盘从指定虚拟机中移除并销毁。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-export

Xe vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value…]) < !——NeedCopy >

将指定的虚拟机(包括磁盘镜像)导出为本地文件。指定导出虚拟机的文件名文件名参数。按照惯例，文件名应该有.xva扩展。

如果元数据参数是真正的，则不导出磁盘。输出文件中只写入虚拟机元数据。当底层存储通过其他方式传输时，允许重新创建虚拟机信息。有关更多信息，请参见vm-import．

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-import

Xe vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid] 

通过之前导出的文件导入虚拟机。如果保存设为真正的，则保留原虚拟机的MAC地址。的sr-uuid确定导入虚拟机的目的SR。如果不指定，则使用缺省SR。

如果元数据是真正的，您可以导入之前导出的一组元数据，而不需要它们关联的磁盘块。如果找不到任何vdi(由SR和VDI.location)，除非——力选项，在这种情况下，导入将继续进行。如果磁盘可以镜像或带外移动，则元数据导入/导出是在不连接的池之间快速移动虚拟机的一种方式。例如，作为灾难恢复计划的一部分。

注意:

多个虚拟机的导入以串行方式执行比并行方式更快。

vm-install

Xe vm-install new-name-label=name [template-uuid=uuid_of_desired_template] [template=template_uuid_or_name] [sr-uuid=sr_uuid | sr-name-label=name_of_sr][copy-bios-string -from=host_uuid] 

使用模板安装或克隆虚拟机。指定模板名称template-uuid或模板论点。指定一个SRsr-uuid或sr-name-label论点。指定安装bios锁定介质copy-bios-strings-from论点。

注意:

当从具有现有磁盘的模板安装时，默认情况下，将在与这些现有磁盘相同的SR中创建新磁盘。在SR支持的地方，这些磁盘是快速复制。如果在命令行上指定了不同的SR，则会在那里创建新磁盘。在这种情况下，快速复制是不可能的，磁盘是完整的副本。

当从没有现有磁盘的模板安装时，任何新磁盘都将在指定的SR中创建，或者在未指定SR时在池默认SR中创建。

vm-is-bios-customized

Xe vm-is-bios-customized 

显示虚拟机BIOS字符串是否定制过。

vm-memory-balloon

Xe vm-memory-balloon target=target 

当虚拟机处于运行状态时，设置内存目标。该值必须在虚拟机的memory_dynamic_min和memory_dynamic_max设置的范围内。

vm-memory-dynamic-range-set

Xe vm-memory-dynamic-range-set min=min max=max 

设置虚拟机动态内存范围动态内存范围定义了虚拟机内存的软上下限。可以在虚拟机运行或停止时更改这些字段。动态范围必须与静态范围相匹配。

vm-memory-limits-set

Xe vm-memory-limits-set static-min=static_min static-max=static_max dynamic-min=dynamic_min dynamic-max=dynamic_max 

设置虚拟机内存限制

vm-memory-set

Xe vm-memory-set memory=memory 

配置虚拟机内存分配

vm-memory-shadow-multiplier-set

Xe vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value…][multiplier=float_memory_multiplier] 

设置虚拟机的影子内存乘数。

这是一个高级选项，可以修改的数量影子内存分配给硬件辅助的虚拟机。

在一些特殊的应用程序工作负载中，例如Citrix Virtual Apps，需要额外的影子内存来实现完整的性能。

这种内存被认为是一种开销。它与正常的内存计算分离，用于计算虚拟机的内存。当调用此命令时，空闲主机内存量会根据乘数和HVM_shadow_multiplier字段更新为Xen分配给虚拟机的值。如果没有足够的Citrix Hypervisor服务器可用内存，则返回错误。

通过标准选择机制选择需要执行该操作的虚拟机。有关更多信息，请参见虚拟机选择器．

vm-memory-static-range-set

vm-memory-static-range-set min=min max=max 

设置虚拟机静态内存范围静态内存范围定义了虚拟机内存的硬性上下限。只有当虚拟机停止时才可以更改这些字段。静态范围必须包含动态范围。

vm-memory-target-set

Xe vm-memory-target-set target=target 

该任务指导管理员对已停止或运行中的虚拟机设置内存目标。该值必须在虚拟机的“memory_static_min”和“memory_static_max”的取值范围内。

vm-memory-target-wait

Xe vm-memory-target-wait 

等待运行中的虚拟机到达当前内存目标。

vm-migrate

Xe vm-migrate [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value…][remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid][vif:=vif_uuid] [vdi=vdi_uuid] 

在物理主机之间迁移指定的虚拟机。的宿主参数为Citrix Hypervisor服务器的名称或UUID。例如，将虚拟机迁移到存储池中的其他主机，且虚拟机磁盘所在的存储为两个主机共享的存储。

Xe vm-migrate uuid=vm_uuid host-uuid=host_uuid 

在同一池中不共享存储的主机间移动虚拟机(存储热迁移):

Xe vm-migrate uuid=vm_uuid remote-master=12.34.56.78 \ remote-username=username remote-password=password \ host-uuid=desination_host_uuid vdi=vdi_uuid 

您可以选择每个VDI存储的SR:

Xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \ vdi1:vdi_1_uuid=destination_sr_uuid \ vdi2:vdi_2_uuid=destination_sr2_uuid \ vdi3:vdi_3_uuid=destination_sr3_uuid 

此外，您还可以选择迁移后绑定虚拟机的网络:

Xe vm-migrate uuid=vm_uuid \ vdi1:vdi_1_uuid=destination_sr_uuid \ vdi2:vdi_2_uuid=destination_sr2_uuid \ vdi3:vdi_3_uuid=destination_sr3_uuid \ vif:vif_uuid=network_uuid 

跨池迁移:

Xe vm-migrate uuid=vm_uuid remote-master=12.34.56.78 remote-username=username remote-password=password \ host-uuid=desination_host_uuid vdi=vdi_uuid 

有关存储热迁移、热迁移和VDI热迁移的详细信息，请参见迁移虚拟机．

默认情况下，虚拟机挂起、迁移、恢复到另一台主机。的生活参数选择热迁移。实时迁移在执行迁移时保持虚拟机运行，从而将虚拟机停机时间降至1秒以内。在某些情况下，例如虚拟机的内存负载非常大的情况下，热迁移会恢复到默认模式，在完成内存迁移之前会暂停虚拟机一小段时间。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-pause

Xe vm-pause 

暂停运行中的虚拟机。注意，此操作不会释放关联的内存(参见vm-suspend）.

vm-query-services

Xe vm-query-services 

查询指定虚拟机提供的系统服务。

vm-reboot

Xe vm-reboot [vm-selector=vm_selector_value…][force=true] 

重启指定虚拟机。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

使用力参数导致不正常的重新启动。其中关闭类似于拔掉物理服务器上的插头。

vm-recover

Xe vm-recover vm-uuid [database] [vdi-uuid] [force] 

从提供的VDI中包含的数据库中恢复虚拟机。

vm-reset-powerstate

Xe vm-reset-powerstate [vm-selector=vm_selector_value…]{force=true} 

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

这是一个先进的该命令仅在池中的成员主机故障时使用。该命令用于强制pool master重置待启动的虚拟机的上电状态停止．从本质上讲，该命令强制锁定虚拟机及其磁盘，以便在另一个池主机上启动它。这叫需要要指定的强制标志，如果不在命令行上则失败。

vm-resume

Xe vm-resume [vm-selector=vm_selector_value…][force=true|false] [on=host_uuid] 

恢复指定虚拟机。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

如果虚拟机位于主机池中的共享SR，则使用在参数指定在哪个池成员上启动它。默认情况下，系统确定一个适当的主机，它可以是池中的任何成员。

vm-retrieve-wlb-recommendations

vm-retrieve-wlb-recommendations 

检索所选VM的工作负载平衡建议。

vm-shutdown

Xe vm-shutdown [vm-selector=vm_selector_value…][force=true|false] 

关闭指定虚拟机。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

使用力参数导致不正常的关闭，类似于拔掉物理服务器上的插头。

vm-snapshot

Xe vm-snapshot new-name-label=name_label [new-name-description+name_description] 

快照已存在的虚拟机，使用存储级快速磁盘快照操作。

vm-start

Xe vm-start [vm-selector=vm_selector_value…][force=true|false] [on=host_uuid][——multiple] 

启动指定虚拟机。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

如果虚拟机位于主机池中的共享SR，则使用在参数指定要在哪个池成员上启动虚拟机。默认情况下，系统确定一个适当的主机，它可以是池中的任何成员。

vm-suspend

Xe vm-suspend [vm-selector=vm_selector_value…]) < !——NeedCopy >

暂停指定虚拟机。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-uninstall

Xe vm-uninstall [vm-selector=vm_selector_value…][force=true|false] 

卸载虚拟机时，除了元数据记录外，还会销毁该虚拟机的磁盘(即标记为RW且仅与该虚拟机连接的vdi)。若要仅销毁VM元数据，请使用xe vm-destroy．

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

vm-unpause

Xe vm-unpause 

取消暂停虚拟机。

vm-vcpu-hotplug

Xe vm-vcpu-hotplug new-vcpus=new_vcpu_count [vm-selector=vm_selector_value…]) < !——NeedCopy >

该任务指导软件调测工程师动态调整Linux虚拟机的vcpu数量。vcpu的个数受参数限制VCPUs-max．Windows虚拟机总是在vcpu数量设置为的情况下运行VCPUs-max并且必须重新启动才能更改此值。

执行该操作的Linux虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．可选参数可以是任意数量的虚拟机参数列在本节的开头。

注意:

对于未安装Citrix VM Tools的Linux虚拟机，请在虚拟机as根确保新热插拔的vcpu被使用;# for I /sys/devices/system/cpu/cpu[1-9]*/online;执行if ["$(cat $i)"= 0];然后echo 1 > $i;fi;完成

vm-vif-list

Xe vm-vif-list [vm-selector=vm_selector_value…]) < !——NeedCopy >

列出指定虚拟机中的vif。

执行该操作的虚拟机将通过标准选择机制进行选择。有关更多信息，请参见虚拟机选择器．选择器在过滤时对VM记录进行操作，以及不在VIF值上。可选参数可以是任意数量的虚拟机参数列在本节的开头。

将快照

虚拟机定时快照及其属性控制命令。

的虚拟机可以使用标准对象列表命令(xe vmss-list)，以及使用标准参数命令操作的参数。有关更多信息，请参见低级参数命令

vmss-create

xe vmss-create enabled=True/False name-label=name type=type frequency=frequency reserved -snapshots=value name-description=description schedule:schedule 

在资源池中创建快照时刻表。

例如:

Xe vmss-create retain -snapshots=9 enabled=true frequency=daily \ name-description=sample name-label=samplepolicy type=snapshot \ schedule:hour=10 schedule:min=30 

快照时刻表包含以下参数:

vmss-destroy

vmss-destroy uuid=uuid 

销毁池中的快照时刻表。

USB透传

USB直通启用/禁用

Xe pusb-param-set uuid=pusb_uuid passthroughenabled =true/false 

启用/禁用USB直通。

pusb-scan

Xe pus_scan主机uuid=host_uuid 

扫描PUSB并更新。

vusb-create

Xe vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid 

在资源池中创建虚拟USB。启动虚拟机，通过USB连接到虚拟机。

vusb-unplug

vusb_uuid 

拔掉虚拟机的USB插头。

vusb-destroy

vusb_uuid 

从虚拟机中移除虚拟USB列表。