community.windows.win_disk_facts 模块 – 显示目标主机的已连接磁盘和磁盘信息
注意
此模块是 community.windows 集合（版本 2.3.0）的一部分。
如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install community.windows。您需要更多要求才能使用此模块，请参阅要求了解详细信息。
要在 playbook 中使用它，请指定：community.windows.win_disk_facts。
概要
使用此模块，您可以检索并输出有关目标主机的已连接磁盘及其卷和分区（如果存在）的详细信息。
要求
以下是在执行此模块的主机上需要的要求。
Windows 8.1 / Windows 2012 (NT 6.2)
参数
参数 |
注释 |
|---|---|
允许按磁盘信息类型筛选返回的事实。 如果选择卷，则还将返回分区。 选项
默认： |
注释
注意
为了理解所有返回的属性和值，请访问以下站点并打开相应的 MSFT 类 https://msdn.microsoft.com/en-us/library/windows/desktop/hh830612.aspx
示例
- name: Get disk facts
community.windows.win_disk_facts:
- name: Output first disk size
debug:
var: ansible_facts.disks[0].size
- name: Convert first system disk into various formats
debug:
msg: '{{ disksize_gib }} vs {{ disksize_gib_human }}'
vars:
# Get first system disk
disk: '{{ ansible_facts.disks|selectattr("system_disk")|first }}'
# Show disk size in Gibibytes
disksize_gib_human: '{{ disk.size|filesizeformat(true) }}' # returns "223.6 GiB" (human readable)
disksize_gib: '{{ (disk.size/1024|pow(3))|round|int }} GiB' # returns "224 GiB" (value in GiB)
# Show disk size in Gigabytes
disksize_gb_human: '{{ disk.size|filesizeformat }}' # returns "240.1 GB" (human readable)
disksize_gb: '{{ (disk.size/1000|pow(3))|round|int }} GB' # returns "240 GB" (value in GB)
- name: Output second disk serial number
debug:
var: ansible_facts.disks[1].serial_number
- name: get disk physical_disk and partition facts on the target
win_disk_facts:
filter:
- physical_disk
- partitions
返回的事实
此模块返回的事实将添加到 hostvars 主机事实中，并像任何其他主机事实一样按名称引用。它们不需要注册即可使用。
键 |
描述 |
|---|---|
有关特定磁盘的详细信息。 返回： 如果找到磁盘 |
|
有关特定磁盘是否为可启动磁盘的信息。 返回： 始终 示例： |
|
特定磁盘的总线类型。 返回： 始终 示例： |
|
有关特定磁盘是否为群集（故障转移群集的一部分）的信息。 返回： 始终 示例： |
|
特定磁盘的固件版本。 返回： 始终 示例： |
|
特定磁盘的友好名称。 返回： 始终 示例： |
|
目标上特定磁盘的 GUID。 返回： 如果存在 示例： |
|
目标上特定磁盘的位置。 返回： 始终 示例： |
|
特定磁盘的制造商。 返回： 始终 示例： |
|
特定磁盘的型号规格。 返回： 始终 示例： |
|
特定磁盘的磁盘编号。 返回： 始终 示例： |
|
特定磁盘的运行状态。 返回： 始终 示例： |
|
特定磁盘上的分区数。 返回： 始终 示例： |
|
特定磁盘的分区样式。 返回： 始终 示例： |
|
关于指定磁盘上某个特定分区的详细信息。 返回： 如果存在 |
|
特定分区的访问路径。 返回： 如果存在 示例： |
|
关于特定分区是否为活动分区的信息。 返回：如果特定磁盘的 partition_style 属性的值为“MBR” 示例： |
|
特定分区的驱动器号。 返回： 如果存在 示例： |
|
特定分区的 gpt 类型。 返回：如果特定磁盘的 partition_style 属性的值为“GPT” 示例： |
|
特定分区的 GUID。 返回： 如果存在 示例： |
|
关于特定分区是否隐藏的信息。 返回： 始终 示例： |
|
特定分区的 mbr 类型。 返回：如果特定磁盘的 partition_style 属性的值为“MBR” 示例： |
|
关于特定分区是否具有默认驱动器号的信息。 返回：如果特定磁盘的 partition_style 属性的值为“GPT” 示例： |
|
特定分区的编号。 返回： 始终 示例： |
|
特定分区的偏移量。 返回： 始终 示例： |
|
关于特定分区是否为另一个分区的卷影副本的信息。 返回： 始终 示例： |
|
特定分区的大小（以字节为单位）。 返回： 始终 示例： |
|
特定分区的转换状态。 返回： 始终 示例： |
|
特定分区的类型。 返回： 始终 示例： |
|
关于指定分区上某个特定卷的详细信息。 返回： 如果存在 |
|
特定卷的分配单元大小（以字节为单位）。 返回： 始终 示例： |
|
特定卷的驱动器类型。 返回： 始终 示例： |
|
特定卷的健康状态。 返回： 始终 示例： |
|
特定卷的文件系统标签。 返回： 始终 示例： |
|
特定卷的对象 ID。 返回： 始终 示例： |
|
特定卷的路径。 返回： 始终 示例： |
|
特定卷的大小（以字节为单位）。 返回： 始终 示例： |
|
特定卷的剩余大小（以字节为单位）。 返回： 始终 示例： |
|
文件系统类型 返回： 始终 特定卷的文件系统类型。 |
|
示例： 返回： 始终 目标上特定磁盘的路径。 |
|
关于特定磁盘的物理磁盘属性的详细信息。 返回： 如果存在 |
|
特定物理磁盘的已分配大小（以字节为单位）。 返回： 始终 示例： |
|
特定物理磁盘的总线类型。 返回： 始终 示例： |
|
关于特定物理磁盘是否可以添加到存储池的信息。 返回： 始终 示例： |
|
关于特定物理磁盘无法添加到存储池的原因的信息。 返回：如果 can_pool 属性的值为 false 示例： |
|
特定物理磁盘的设备 ID。 返回： 始终 示例： |
|
特定物理磁盘的友好名称。 返回： 始终 示例： |
|
特定物理磁盘的健康状态。 返回： 始终 示例： |
|
关于是否为特定物理磁盘启用了指示的信息。 返回： 始终 示例： |
|
特定物理磁盘的制造商。 返回： 始终 示例： |
|
特定物理磁盘的介质类型。 返回： 始终 示例： |
|
特定物理磁盘的型号。 返回： 始终 示例： |
|
特定物理磁盘的对象 ID。 返回： 始终 示例： |
|
特定物理磁盘的操作状态。 返回： 始终 示例： |
|
关于特定物理磁盘是否为部分的信息。 返回： 始终 示例： |
|
特定物理磁盘的物理位置。 返回： 始终 示例： |
|
特定物理磁盘的序列号。 返回： 始终 示例： |
|
特定物理磁盘的大小（以字节为单位）。 返回： 始终 示例： |
|
特定物理磁盘的主轴转速（以 rpm 为单位）。 返回： 始终 示例： |
|
特定物理磁盘支持的用途类型。 返回： 始终 |
|
支持的用途类型的计数。 返回： 始终 示例： |
|
支持的用途类型的列表。 返回： 始终 示例： |
|
特定物理磁盘的唯一 ID。 返回： 始终 示例： |
|
特定物理磁盘的用途类型。 返回： 始终 示例： |
|
特定磁盘的只读状态。 返回： 始终 示例： |
|
特定磁盘的扇区大小（以字节为单位）。 返回： 始终 示例： |
|
目标上特定磁盘的序列号。 返回： 始终 示例： |
|
特定磁盘的大小（以字节为单位）。 返回： 始终 示例： |
|
关于特定磁盘是否为系统磁盘的信息。 返回： 始终 示例： |
|
目标上特定磁盘的唯一 ID。 返回： 始终 示例： |
|
关于特定磁盘的虚拟磁盘属性的详细信息。 返回： 如果存在 |
|
特定虚拟磁盘的访问权限。 返回： 始终 示例： |
|
特定虚拟磁盘的已分配大小（以字节为单位）。 返回： 始终 示例： |
|
特定虚拟磁盘的分配单元大小（以字节为单位）。 返回： 始终 示例： |
|
特定虚拟磁盘的可用副本数。 返回： 如果存在 示例： |
|
特定虚拟磁盘的列数。 返回： 始终 示例： |
|
关于是否为特定虚拟磁盘启用了重复数据删除的信息。 返回： 始终 示例： |
|
特定虚拟磁盘的分离原因。 返回： 始终 示例： |
|
关于特定虚拟磁盘是否为机箱感知的信息。 返回： 始终 示例： |
|
特定虚拟磁盘的故障域感知。 返回： 始终 示例： |
|
特定虚拟磁盘在池中的占用空间大小（字节）。 返回： 始终 示例： |
|
特定虚拟磁盘的友好名称。 返回： 始终 示例： |
|
特定虚拟磁盘的组数。 返回： 始终 示例： |
|
特定虚拟磁盘的健康状态。 返回： 始终 示例： |
|
特定虚拟磁盘的交错大小（字节）。 返回： 始终 示例： |
|
特定虚拟磁盘的逻辑扇区大小（字节）。 返回： 始终 示例： |
|
有关特定虚拟磁盘是否为手动附加的信息。 返回： 始终 示例： |
|
特定虚拟磁盘的介质类型。 返回： 始终 示例： |
|
特定虚拟磁盘的名称。 返回： 始终 示例： |
|
特定虚拟磁盘的对象 ID。 返回： 始终 示例： |
|
特定虚拟磁盘的运行状态。 返回： 始终 示例： |
|
特定虚拟磁盘的奇偶校验布局。 返回： 如果存在 示例： |
|
特定虚拟磁盘的物理磁盘冗余类型。 返回： 始终 示例： |
|
特定虚拟磁盘的物理扇区大小（字节）。 返回： 始终 示例： |
|
特定虚拟磁盘的置备类型。 返回： 始终 示例： |
|
特定虚拟磁盘的读取缓存大小（字节）。 返回： 始终 示例： |
|
有关特定虚拟磁盘是否请求无单点故障的信息。 返回： 始终 示例： |
|
特定虚拟磁盘的物理磁盘冗余类型。 返回： 始终 示例： |
|
特定虚拟磁盘的大小（字节）。 返回： 始终 示例： |
|
有关特定虚拟磁盘是否为快照的信息。 返回： 始终 示例： |
|
有关特定虚拟磁盘是否为分层的信息。 返回： 始终 示例： |
|
特定虚拟磁盘的唯一 ID。 返回： 始终 示例： |
|
特定虚拟磁盘的唯一 ID 格式。 返回： 始终 示例： |
|
特定虚拟磁盘的写入缓存大小（字节）。 返回： 始终 示例： |
|
Win32_DiskDrive 类的表示。 返回： 如果存在 |
|
设备的可用性和状态。 返回： 始终 |
|
物理磁盘驱动器的每个扇区中的字节数。 返回： 始终 示例： |
|
媒体访问设备的功能数组。 例如，该设备可能支持随机访问 (3)、可移动媒体 (7) 和自动清洁 (9)。 返回： 始终 示例： |
|
Capabilities 数组中指示的任何访问设备功能的更详细解释列表。 请注意，此数组的每个条目都与 Capabilities 数组中位于相同索引的条目相关。 返回： 始终 示例： |
|
对象的简短描述。 返回： 始终 示例： |
|
设备用于支持压缩的算法或工具。 返回： 始终 示例： |
|
Windows 配置管理器错误代码。 返回： 始终 示例： |
|
如果为 True，则设备正在使用用户定义的配置。 返回： 始终 示例： |
|
在实例创建中使用的继承链中出现的第一个具体类的名称。 当与类的其他键属性一起使用时，该属性允许唯一标识此类的所有实例 及其子类。 返回： 始终 示例： |
|
此设备的默认块大小（字节）。 返回： 始终 示例： |
|
对象的描述。 返回： 始终 示例： |
|
磁盘驱动器与系统上其他设备的唯一标识符。 返回： 始终 示例： |
|
如果为 True，则 LastErrorCode 中报告的错误现在已清除。 返回： 始终 示例： |
|
有关 LastErrorCode 中记录的错误的更多信息， 以及有关可能采取的任何纠正措施的信息。 返回： 始终 |
|
此设备支持的错误检测和纠正类型。 返回： 始终 |
|
制造商分配的磁盘驱动器固件版本。 返回： 始终 示例： |
|
给定驱动器的物理驱动器编号。 此属性由从 IOCTL_STORAGE_GET_DEVICE_NUMBER 控制代码返回的 STORAGE_DEVICE_NUMBER 结构填充 值 0xffffffff 表示给定驱动器不映射到物理驱动器。 返回： 始终 示例： |
|
安装对象的日期和时间。 此属性不需要值来指示对象已安装。 返回： 始终 |
|
物理磁盘驱动器的接口类型。 返回： 始终 示例： |
|
逻辑设备报告的上次错误代码。 返回： 始终 |
|
磁盘驱动器制造商的名称。 返回： 始终 示例： |
|
此设备访问的介质的最大块大小（字节）。 返回： 始终 |
|
此设备支持的介质的最大介质大小（千字节）。 返回： 始终 |
|
如果为 True，则磁盘驱动器的介质已加载，这意味着该设备具有可读的文件系统并且可访问。 对于固定磁盘驱动器，此属性将始终为 TRUE。 返回： 始终 示例： |
|
此设备使用或访问的介质类型。 返回： 始终 示例： |
|
此设备访问的介质的最小块大小（字节）。 返回： 始终 |
|
磁盘驱动器的制造商型号。 返回： 始终 示例： |
|
对象已知的标签。 当子类化时，可以重写该属性以成为键属性。 返回： 始终 示例： |
|
如果为 True，则媒体访问设备需要清洁。 是否可以进行手动或自动清洁在 Capabilities 属性中指示。 返回： 始终 |
|
可以支持或插入的最大媒体数量 （当媒体访问设备支持多个单独的媒体时）。 返回： 始终 |
|
操作系统识别的此物理磁盘驱动器上的分区数。 返回： 始终 示例： |
|
逻辑设备的 Windows 即插即用设备标识符。 返回： 始终 示例： |
|
逻辑设备的特定电源相关功能的数组。 返回： 始终 |
|
如果为 True，则可以对设备进行电源管理（可以置于挂起模式等）。 该属性不指示当前是否启用了电源管理功能， 仅指示逻辑设备能够进行电源管理。 返回： 始终 |
|
磁盘驱动器的 SCSI 总线编号。 返回： 始终 示例： |
|
磁盘驱动器的 SCSI 逻辑单元号 (LUN)。 返回： 始终 示例： |
|
磁盘驱动器的 SCSI 端口号。 返回： 始终 示例： |
|
磁盘驱动器的 SCSI 标识符编号。 返回： 始终 示例： |
|
此物理磁盘驱动器的每个磁道中的扇区数。 返回： 始终 示例： |
|
制造商分配的用于标识物理媒体的编号。 返回： 始终 示例： |
|
磁盘标识。 此属性可用于标识共享资源。 返回： 始终 |
|
磁盘驱动器的大小。 它通过将圆柱总数、每个圆柱中的磁道数， 每个磁道中的扇区数和每个扇区中的字节数相乘来计算。 返回： 始终 示例： |
|
对象的当前状态。 可以定义各种操作状态和非操作状态。 操作状态包括：“OK”、“已降级”和“即将失败” （一个元素，例如启用 SMART 的硬盘驱动器，可能运行正常，但预测在不久的将来会发生故障）。 非操作状态包括：“错误”、“正在启动”、“正在停止”和“服务中”。 “服务中”可能适用于磁盘的镜像恢复、用户权限列表的重新加载或其他管理工作。 并非所有此类工作都在线进行，但托管元素既不“OK”也不处于其他状态之一。 返回： 始终 示例： |
|
逻辑设备的状态。 如果此属性不适用于逻辑设备，则应使用值 5（不适用）。 返回： 始终 |
|
范围计算机的 CreationClassName 属性值。 返回： 始终 示例： |
|
范围系统的名称。 返回： 始终 示例： |
|
物理磁盘驱动器上的总柱面数。 注意：此属性的值是通过 BIOS 中断 13h 的扩展函数获得的。 如果驱动器使用转换方案来支持高容量磁盘大小，则该值可能不准确。 请咨询制造商以获取准确的驱动器规格。 返回： 始终 示例： |
|
磁盘驱动器上的总磁头数。 注意：此属性的值是通过 BIOS 中断 13h 的扩展函数获得的。 如果驱动器使用转换方案来支持高容量磁盘大小，则该值可能不准确。 请咨询制造商以获取准确的驱动器规格。 返回： 始终 示例： |
|
物理磁盘驱动器上的总扇区数。 注意：此属性的值是通过 BIOS 中断 13h 的扩展函数获得的。 如果驱动器使用转换方案来支持高容量磁盘大小，则该值可能不准确。 请咨询制造商以获取准确的驱动器规格。 返回： 始终 示例： |
|
物理磁盘驱动器上的总磁道数。 注意：此属性的值是通过 BIOS 中断 13h 的扩展函数获得的。 如果驱动器使用转换方案来支持高容量磁盘大小，则该值可能不准确。 请咨询制造商以获取准确的驱动器规格。 返回： 始终 示例： |
|
物理磁盘驱动器上每个柱面中的磁道数。 注意：此属性的值是通过 BIOS 中断 13h 的扩展函数获得的。 如果驱动器使用转换方案来支持高容量磁盘大小，则该值可能不准确。 请咨询制造商以获取准确的驱动器规格。 返回： 始终 示例： |