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”、“Degraded”和“Pred Fail”（ 元素（例如支持 SMART 的硬盘驱动器）可能运行正常，但在不久的将来可能会出现故障）。 非运行状态包括：“Error”、“Starting”、“Stopping”和“Service”。 “Service”可能适用于磁盘的镜像恢复、用户权限列表的重新加载或其他管理工作。 并非所有此类工作都在线，但被管理的元素既不是“OK”，也不是其他状态之一。 返回：始终 示例： |
|
逻辑设备的状态。如果此属性不适用于逻辑设备，则应使用值 5（不适用）。 返回：始终 |
|
范围计算机的 CreationClassName 属性的值。 返回：始终 示例： |
|
范围系统的名称。 返回：始终 示例： |
|
物理磁盘驱动器上的总柱面数。 注意：此属性的值是通过 BIOS 中断 13h 的扩展功能获得的。 如果驱动器使用转换方案来支持大容量磁盘大小，则该值可能不准确。 请咨询制造商以获取准确的驱动器规格。 返回：始终 示例： |
|
磁盘驱动器上的磁头总数。 注意：此属性的值是通过 BIOS 中断 13h 的扩展功能获得的。 如果驱动器使用转换方案来支持大容量磁盘大小，则该值可能不准确。 请咨询制造商以获取准确的驱动器规格。 返回：始终 示例： |
|
物理磁盘驱动器上的扇区总数。 注意：此属性的值是通过 BIOS 中断 13h 的扩展功能获得的。 如果驱动器使用转换方案来支持大容量磁盘大小，则该值可能不准确。 请咨询制造商以获取准确的驱动器规格。 返回：始终 示例： |
|
物理磁盘驱动器上的磁道总数。 注意：此属性的值是通过 BIOS 中断 13h 的扩展功能获得的。 如果驱动器使用转换方案来支持大容量磁盘大小，则该值可能不准确。 请咨询制造商以获取准确的驱动器规格。 返回：始终 示例： |
|
物理磁盘驱动器每个磁柱上的磁道数量。 注意：此属性的值是通过 BIOS 中断 13h 的扩展功能获得的。 如果驱动器使用转换方案来支持大容量磁盘大小，则该值可能不准确。 请咨询制造商以获取准确的驱动器规格。 返回：始终 示例： |