Модуль 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)
Параметры
Параметр | Комментарии |
|---|---|
filter список / элементы=строка добавлено в community.windows 1.9.0 | Позволяет фильтровать возвращаемые факты по типу информации о диске. Если выбраны тома, то также будут возвращены разделы. Варианты:
Значение по умолчанию: |
Примечания
Примечание
- Для понимания всех возвращаемых свойств и значений посетите следующий сайт и откройте соответствующий класс 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 и могут быть указаны по имени, как и любой другой факт хоста. Их не нужно регистрировать для использования.
Ключ | Описание |
|---|---|
ansible_disks list / elements=string | Подробная информация об одном конкретном диске. Возвращается: если диски были найдены |
|
bootable boolean |
Информация о том, является ли конкретный диск загрузочным. Возвращается: всегда Пример: |
|
bus_type string |
Тип шины конкретного диска. Возвращается: всегда Пример: |
|
clustered boolean |
Информация о том, является ли конкретный диск кластерным (частью отказоустойчивого кластера). Возвращается: всегда Пример: |
|
firmware_version string |
Версия прошивки конкретного диска. Возвращается: всегда Пример: |
|
friendly_name string |
Отображаемое имя конкретного диска. Возвращается: всегда Пример: |
|
guid string |
GUID конкретного диска на целевом хосте. Возвращается: если существует Пример: |
|
location string |
Расположение конкретного диска на целевом хосте. Возвращается: всегда Пример: |
|
manufacturer string |
Производитель конкретного диска. Возвращается: всегда Пример: |
|
model string |
Модель конкретного диска. Возвращается: всегда Пример: |
|
number integer |
Номер диска. Возвращается: всегда Пример: |
|
operational_status string |
Рабочий статус конкретного диска. Возвращается: всегда Пример: |
|
partition_count integer |
Количество разделов на конкретном диске. Возвращается: всегда Пример: |
|
partition_style string |
Стиль разделов конкретного диска. Возвращается: всегда Пример: |
|
partitions list / elements=string |
Подробная информация об одном конкретном разделе на указанном диске. Возвращается: если существует |
|
access_paths string |
Пути доступа к конкретному разделу. Возвращается: если существует Пример: |
|
active boolean |
Информация о том, является ли конкретный раздел активным или нет. Возвращается: если свойство partition_style конкретного диска имеет значение “MBR” Пример: |
|
drive_letter string |
Буква диска конкретного раздела. Возвращается: если существует Пример: |
|
gpt_type string |
Тип GPT конкретного раздела. Возвращается: если свойство partition_style конкретного диска имеет значение “GPT” Пример: |
|
guid string |
GUID конкретного раздела. Возвращается: если существует Пример: |
|
boolean |
Информация о том, скрыт ли конкретный раздел или нет. Возвращается: всегда Пример: |
|
mbr_type integer |
Тип MBR определенного раздела. Возвращается: если свойство partition_style определенного диска имеет значение «MBR» Пример: |
|
no_default_driveletter boolean |
Информация о том, имеет ли данный раздел букву диска по умолчанию или нет. Возвращается: если свойство partition_style определенного диска имеет значение «GPT» Пример: |
|
number integer |
Номер определенного раздела. Возвращается: всегда Пример: |
|
offset integer |
Смещение определенного раздела. Возвращается: всегда Пример: |
|
shadow_copy boolean |
Информация о том, является ли данный раздел теневой копией другого раздела. Возвращается: всегда Пример: |
|
size integer |
Размер в байтах определенного раздела. Возвращается: всегда Пример: |
|
transition_state integer |
Состояние перехода определенного раздела. Возвращается: всегда Пример: |
|
type string |
Тип определенного раздела. Возвращается: всегда Пример: |
|
volumes list / elements=string |
Подробная информация об одном конкретном томе на указанном разделе. Возвращается: если существует |
|
allocation_unit_size integer |
Размер в байтах блока распределения определенного тома. Возвращается: всегда Пример: |
|
drive_type string |
Тип носителя определенного тома. Возвращается: всегда Пример: |
|
health_status string |
Состояние работоспособности определенного тома. Возвращается: всегда Пример: |
|
label string |
Метка файловой системы определенного тома. Возвращается: всегда Пример: |
|
object_id string |
Идентификатор объекта определенного тома. Возвращается: всегда Пример: |
|
path string |
Путь к определенному тому. Возвращается: всегда Пример: |
|
size integer |
Размер в байтах определенного тома. Возвращается: всегда Пример: |
|
size_remaining integer |
Оставшийся размер в байтах определенного тома. Возвращается: всегда Пример: |
|
type string |
Тип файловой системы определенного тома. Возвращается: всегда Пример: |
|
path string |
Путь к определенному диску на целевом узле. Возвращается: всегда Пример: |
|
physical_disk complex |
Подробная информация о свойствах физического диска определенного диска. Возвращается: если существует |
|
allocated_size integer |
Выделенный размер в байтах определенного физического диска. Возвращается: всегда Пример: |
|
bus_type string |
Тип шины конкретного физического диска. Возвращается: всегда Пример: |
|
can_pool boolean |
Информация о том, можно ли добавить конкретный физический диск в пул хранилища. Возвращается: всегда Пример: |
|
cannot_pool_reason string |
Информация о том, почему конкретный физический диск нельзя добавить в пул хранилища. Возвращается: если свойство can_pool имеет значение false Пример: |
|
device_id string |
Идентификатор устройства конкретного физического диска. Возвращается: всегда Пример: |
|
friendly_name string |
Отображаемое имя конкретного физического диска. Возвращается: всегда Пример: |
|
health_status string |
Состояние работоспособности конкретного физического диска. Возвращается: всегда Пример: |
|
indication_enabled boolean |
Информация о том, включена ли индикация для конкретного физического диска. Возвращается: всегда Пример: |
|
manufacturer string |
Производитель конкретного физического диска. Возвращается: всегда Пример: |
|
media_type string |
Тип носителя конкретного физического диска. Возвращается: всегда Пример: |
|
model string |
Модель конкретного физического диска. Возвращается: всегда Пример: |
|
object_id string |
Идентификатор объекта конкретного физического диска. Возвращается: всегда Пример: |
|
operational_status string |
Операционный статус конкретного физического диска. Возвращается: всегда Пример: |
|
partial boolean |
Информация о том, является ли конкретный физический диск частичным. Возвращается: всегда Пример: |
|
physical_location string |
Физическое расположение конкретного физического диска. Возвращается: всегда Пример: |
|
serial_number string |
Серийный номер конкретного физического диска. Возвращается: всегда Пример: |
|
size integer |
Размер в байтах конкретного физического диска. Возвращается: всегда Пример: |
|
spindle_speed integer |
Скорость вращения в об/мин конкретного физического диска. Возвращается: всегда Пример: |
|
supported_usages complex |
Поддерживаемые типы использования конкретного физического диска. Возвращается: всегда |
|
Count integer |
Количество поддерживаемых типов использования. Возвращается: всегда Пример: |
|
value string |
Список поддерживаемых типов использования. Возвращается: всегда Пример: |
|
unique_id string |
Уникальный идентификатор конкретного физического диска. Возвращается: всегда Пример: |
|
usage_type string |
Тип использования конкретного физического диска. Возвращается: всегда Пример: |
|
read_only boolean |
Статус только для чтения конкретного диска. Возвращается: всегда Пример: |
|
sector_size integer |
Размер сектора в байтах конкретного диска. Возвращается: всегда Пример: |
|
serial_number string |
Серийный номер конкретного диска на целевом узле. Возвращается: всегда Пример: |
|
size integer |
Размер в байтах конкретного диска. Возвращается: всегда Пример: |
|
system_disk boolean |
Информация о том, является ли конкретный диск системным. Возвращается: всегда Пример: |
|
unique_id string |
Уникальный ID конкретного диска на целевом узле. Возвращается: всегда Пример: |
|
virtual_disk complex |
Подробная информация о свойствах виртуального диска конкретного диска. Возвращается: если существует |
|
access string |
Доступ к конкретному виртуальному диску. Возвращается: всегда Пример: |
|
allocated_size integer |
Выделенный размер в байтах конкретного виртуального диска. Возвращается: всегда Пример: |
|
allocation_unit_size integer |
Размер единицы выделения в байтах конкретного виртуального диска. Возвращается: всегда Пример: |
|
available_copies integer |
Количество доступных копий конкретного виртуального диска. Возвращается: если существует Пример: |
|
columns integer |
Количество столбцов конкретного виртуального диска. Возвращается: всегда Пример: |
|
deduplication_enabled boolean |
Информация о том, включена ли дедупликация для конкретного виртуального диска. Возвращается: всегда Пример: |
|
detached_reason string |
Причина отключения конкретного виртуального диска. Возвращается: всегда Пример: |
|
enclosure_aware boolean |
Информация о том, поддерживает ли конкретный виртуальный диск распознавание шасси. Возвращается: всегда Пример: |
|
fault_domain_awareness string |
Определение области отказа для конкретного виртуального диска. Возвращается: всегда Пример: |
|
footprint_on_pool integer |
Занимаемый объем в пуле в байтах конкретного виртуального диска. Возвращается: всегда Пример: |
|
friendly_name string |
Дружественное имя конкретного виртуального диска. Возвращается: всегда Пример: |
|
groups integer |
Количество групп конкретного виртуального диска. Возвращается: всегда Пример: |
|
health_status string |
Состояние работоспособности конкретного виртуального диска. Возвращается: всегда Пример: |
|
inter_leave integer |
Взаимное переплетение в байтах конкретного виртуального диска. Возвращается: всегда Пример: |
|
logical_sector_size integer |
Размер логического сектора в байтах конкретного виртуального диска. Возвращается: всегда Пример: |
|
manual_attach boolean |
Информация о том, является ли конкретный виртуальный диск подключенным вручную. Возвращается: всегда Пример: |
|
media_type string |
Тип носителя конкретного виртуального диска. Возвращается: всегда Пример: |
|
name string |
Имя конкретного виртуального диска. Возвращается: всегда Пример: |
|
object_id string |
Идентификатор объекта конкретного виртуального диска. Возвращается: всегда Пример: |
|
operational_status string |
Операционный статус конкретного виртуального диска. Возвращается: всегда Пример: |
|
parity_layout integer |
Схема четности конкретного виртуального диска. Возвращается: если существует Пример: |
|
physical_disk_redundancy integer |
Тип избыточности физического диска конкретного виртуального диска. Возвращается: всегда Пример: |
|
physical_sector_size integer |
Размер физического сектора в байтах конкретного виртуального диска. Возвращается: всегда Пример: |
|
provisioning_type string |
Тип подготовки конкретного виртуального диска. Возвращается: всегда Пример: |
|
read_cache_size integer |
Размер кэша чтения в байтах конкретного виртуального диска. Возвращается: всегда Пример: |
|
request_no_spof boolean |
Информация о том, запрашивает ли конкретный виртуальный диск отсутствие единой точки отказа. Возвращается: всегда Пример: |
|
resiliency_setting_name integer |
Тип избыточности физического диска конкретного виртуального диска. Возвращается: всегда Пример: |
|
size integer |
Размер в байтах конкретного виртуального диска. Возвращается: всегда Пример: |
|
snapshot boolean |
Информация о том, является ли конкретный виртуальный диск снимком. Возвращается: всегда Пример: |
|
tiered boolean |
Информация о том, является ли конкретный виртуальный диск многоуровневым. Возвращается: всегда Пример: |
|
unique_id string |
Уникальный идентификатор конкретного виртуального диска. Возвращается: всегда Пример: |
|
unique_id_format string |
Формат уникального идентификатора конкретного виртуального диска. Возвращается: всегда Пример: |
|
write_cache_size integer |
Размер кэша записи в байтах конкретного виртуального диска. Возвращается: всегда Пример: |
|
win32_disk_drive complex |
Представление класса Win32_DiskDrive. Возвращается: если существует |
|
availability integer |
Доступность и статус устройства. Возвращается: всегда |
|
bytes_per_sector integer |
Количество байт в каждом секторе физического дисковода. Возвращается: всегда Пример: |
|
capabilities list / elements=string |
Массив возможностей устройства доступа к носителю. Например, устройство может поддерживать произвольный доступ (3), съемные носители (7) и автоматическую очистку (9). Возвращается: всегда Пример: |
|
capability_descriptions list / elements=string |
Список более подробных объяснений для любой из функций устройства доступа, указанных в массиве Capabilities. Обратите внимание, что каждая запись этого массива связана с записью в массиве Capabilities, расположенной на том же индексе. Возвращается: всегда Пример: |
|
caption string |
Краткое описание объекта. Возвращается: всегда Пример: |
|
compression_method string |
Алгоритм или инструмент, используемый устройством для поддержки сжатия. Возвращается: всегда Пример: |
|
config_manager_error_code integer |
Код ошибки диспетчера конфигурации Windows. Возвращается: всегда Пример: |
|
config_manager_user_config boolean |
Если True, устройство использует конфигурацию, определенную пользователем. Возвращается: всегда Пример: |
|
creation_class_name string |
Имя первого конкретного класса, который появляется в цепочке наследования, используемой при создании экземпляра. При использовании с другими ключевыми свойствами класса свойство позволяет однозначно идентифицировать все экземпляры этого класса и его подклассов. Возвращается: всегда Пример: |
|
default_block_size integer |
Размер блока по умолчанию, в байтах, для этого устройства. Возвращается: всегда Пример: |
|
description string |
Описание объекта. Возвращается: всегда Пример: |
|
device_id string |
Уникальный идентификатор дисковода с другими устройствами в системе. Возвращается: всегда Пример: |
|
error_cleared boolean |
Если True, ошибка, сообщенная в LastErrorCode, теперь устранена. Возвращается: всегда Пример: |
|
error_description string |
Дополнительная информация об ошибке, записанной в LastErrorCode, и информация о любых корректирующих действиях, которые могут быть предприняты. Возвращается: всегда |
|
error_methodology string |
Тип обнаружения и исправления ошибок, поддерживаемый этим устройством. Возвращается: всегда |
|
firmware_revision string |
Номер ревизии прошивки дисковода, назначенный производителем. Возвращается: всегда Пример: |
|
index integer |
Номер физического дисковода. Это свойство заполняется структурой STORAGE_DEVICE_NUMBER, возвращаемой кодом управления IOCTL_STORAGE_GET_DEVICE_NUMBER Значение 0xffffffff указывает на то, что данный диск не сопоставляется с физическим диском. Возвращается: всегда Пример: |
|
install_date string |
Дата и время установки объекта. Для указания на установку объекта значение этого свойства не требуется. Возвращается: всегда |
|
interface_type string |
Тип интерфейса физического дисковода. Возвращается: всегда Пример: |
|
last_error_code integer |
Код последней ошибки, зарегистрированный логическим устройством. Возвращено: всегда |
|
manufacturer string |
Название производителя дисковода. Возвращено: всегда Пример: |
|
max_block_size integer |
Максимальный размер блока, в байтах, для носителя, доступного этому устройству. Возвращено: всегда |
|
max_media_size integer |
Максимальный размер носителя, в килобайтах, поддерживаемый этим устройством. Возвращено: всегда |
|
media_loaded boolean |
Если True, носитель для дисковода загружен, это означает, что устройство имеет доступную файловую систему и доступно. Для жёстких дисков это свойство всегда будет TRUE. Возвращено: всегда Пример: |
|
media_type string |
Тип носителя, используемый или доступный этому устройству. Возвращено: всегда Пример: |
|
min_block_size integer |
Минимальный размер блока, в байтах, для носителя, доступного этому устройству. Возвращено: всегда |
|
model string |
Модель производителя дисковода. Возвращено: всегда Пример: |
|
name string |
Метка, под которой известен объект. При наследовании свойство может быть переопределено как ключевое свойство. Возвращено: всегда Пример: |
|
needs_cleaning boolean |
Если True, устройство доступа к носителю нуждается в очистке. Возможность ручной или автоматической очистки указана в свойстве Capabilities. Возвращено: всегда |
|
number_of_media_supported integer |
Максимальное количество носителей, которые могут быть поддерживаемы или вставлены (когда устройство доступа к носителю поддерживает несколько отдельных носителей). Возвращено: всегда |
|
partitions integer |
Количество разделов на этом физическом диске, распознаваемых операционной системой. Возвращено: всегда Пример: |
|
pnp_device_id string |
Идентификатор устройства Plug and Play Windows для логического устройства. Возвращено: всегда Пример: |
|
power_management_capabilities list / elements=string |
Массив конкретных возможностей управления питанием логического устройства. Возвращено: всегда |
|
power_management_supported boolean |
Если True, устройством можно управлять с точки зрения питания (можно перевести в спящий режим и т.д.). Свойство не указывает на то, что функции управления питанием в данный момент включены, а только на то, что логическое устройство способно к управлению питанием. Возвращено: всегда |
|
scsi_bus integer |
Номер шины SCSI дисковода. Возвращено: всегда Пример: |
|
scsi_logical_unit integer |
Номер логического устройства SCSI (LUN) дисковода. Возвращено: всегда Пример: |
|
scsi_port integer |
Номер порта SCSI дисковода. Возвращено: всегда Пример: |
|
scsi_target_id integer |
Идентификационный номер SCSI дисковода. Возвращено: всегда Пример: |
|
sectors_per_track integer |
Количество секторов на каждом треке для этого физического дисковода. Возвращено: всегда Пример: |
|
serial_number string |
Номер, назначенный производителем для идентификации физического носителя. Возвращено: всегда Пример: |
|
signature integer |
Идентификатор диска. Это свойство может использоваться для идентификации общего ресурса. Возвращается: всегда |
|
size integer |
Размер дисковода. Он вычисляется путем умножения общего количества цилиндров, дорожек в каждом цилиндре, секторов на каждой дорожке и байтов в каждом секторе. Возвращается: всегда Пример: |
|
status string |
Текущий статус объекта. Могут быть определены различные рабочие и нерабочие статусы. Рабочие статусы включают: «OK», «Degraded» и «Pred Fail» (элемент, например, жесткий диск с поддержкой SMART, может работать правильно, но предсказывать сбой в ближайшем будущем). Нерабочие статусы включают: «Error», «Starting», «Stopping» и «Service». «Service» может применяться во время зеркального восстановления диска, перезагрузки списка прав доступа пользователей или другой административной работы. Не вся такая работа выполняется онлайн, но управляемый элемент не находится в состоянии «OK» и не в одном из других состояний. Возвращается: всегда Пример: |
|
status_info integer |
Состояние логического устройства. Если это свойство не относится к логическому устройству, следует использовать значение 5 (Не применимо). Возвращается: всегда |
|
system_creation_class_name string |
Значение свойства CreationClassName компьютера области действия. Возвращается: всегда Пример: |
|
system_name string |
Имя системы области действия. Возвращается: всегда Пример: |
|
total_cylinders integer |
Общее количество цилиндров на физическом дисководе. Примечание: значение этого свойства получено с помощью расширенных функций прерывания BIOS 13h. Значение может быть неточным, если диск использует схему преобразования для поддержки больших размеров дисков. Обратитесь к производителю за точными характеристиками диска. Возвращается: всегда Пример: |
|
total_heads integer |
Общее количество головок на дисководе. Примечание: значение этого свойства получено с помощью расширенных функций прерывания BIOS 13h. Значение может быть неточным, если диск использует схему преобразования для поддержки больших размеров дисков. Обратитесь к производителю за точными характеристиками диска. Возвращается: всегда Пример: |
|
total_sectors integer |
Общее количество секторов на физическом дисководе. Примечание: значение этого свойства получено с помощью расширенных функций прерывания BIOS 13h. Значение может быть неточным, если диск использует схему преобразования для поддержки больших размеров дисков. Обратитесь к производителю за точными характеристиками диска. Возвращается: всегда Пример: |
|
total_tracks integer |
Общее количество дорожек на физическом дисководе. Примечание: значение этого свойства получено с помощью расширенных функций прерывания BIOS 13h. Значение может быть неточным, если диск использует схему преобразования для поддержки больших размеров дисков. Обратитесь к производителю за точными характеристиками диска. Возвращается: всегда Пример: |
|
tracks_per_cylinder integer |
Количество дорожек в каждом цилиндре на физическом дисководе. Примечание: значение этого свойства получено с помощью расширенных функций прерывания BIOS 13h. Значение может быть неточным, если диск использует схему преобразования для поддержки больших размеров дисков. Обратитесь к производителю за точными характеристиками диска. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_disk_facts_module.html