management user interface

domrename

domrename domain new-name
重命名域。该命令将当前域的名字（domain）就该为新的名称（new-name）。

注意：域必须是未活动的，并且不能由快照。

edit

edit domain
修改域的XML配置文件，在下次启动Guest时生效。

该命令等价于如下操作：

virsh dumpxml --inactive --security-info domain > domain.xml
vi domain.xml # (or make changes with your other text editor)
virsh define domain.xml

唯一的不同是，该命令还会校验XML内容。

可以使用$VISUAL或$EDITOR环境变量指定使用的编辑器，默认为vi。

undefine

undefine domain [–managed-save] [–snapshots-metadata] [–nvram] [–keep-nvram] [ {–storage volumes | –remove-all-storage [–delete-snapshots]} –wipe-storage]
取消域定义。如果域正在运行，则会将其转换为临时域，而不会停止它。如果域处于非活动状态，域配置将被删除。

标志–managed-save保证还清除了任何托管保存镜像（请参阅managedsave命令）。 如果没有该标志，尝试取消使用托管保存镜像域定义将失败。

标志–snapshots-metadata可确保在取消定义非活动域时也清除任何快照（请参阅snapshot-list命令）。如果没有该标志，尝试取消定义使用快照元数据的非活动域将失败。如果域处于活动状态，则忽略此标志。

标志–nvram和–keep-nvram相应地指定删除或保留nvram文件（/domain/os/nvram/）。 如果域具有nvram文件并且省略了标志，则undefine将失败。

标志–storage指定要与取消定义域一起删除的卷，该参数volumes是以逗号分隔的卷目标名列表，或存储卷的源路径。可以取消卷定义，因此仅在非活动域上删除。仅在取消定义域之后，才尝试删除卷；如果不能删除所有请求的卷，则错误消息会指示仍然存在的内容。如果在域定义中找不到卷路径，则将其视为已成功删除卷。只能通过这种方式删除存储池中由libvirt管理的卷。（有关与域关联的目标名称列表，请参阅domblklist指令）。示例：–storage vda,/path/to/storage.img

标志–remove-all-storage指定域应删除所有的存储卷。

标志–delete-snapshots指定也应删除与存储卷关联的所有快照。需要提供–remove-all-storage标志。并非所有存储驱动程序都支持此选项，目前仅支持rbd。

标志–wipe-storage指定在删除之前应擦除存储卷。

注意：对于非活动域，必须将“域名称”或“UUID”用作域。