Модуль community.windows.win_format — форматирует существующий том или новый том в существующем разделе Windows

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.windows.

Чтобы использовать модуль в плейбуке, укажите: community.windows.win_format.

Краткое описание
Параметры
Примечания
См. также
Примеры

Краткое описание

Модуль community.windows.win_format форматирует существующий том или новый том в существующем разделе Windows

Параметры

Параметр	Комментарии
allocation_unit_size integer	Задает размер кластера, используемый при форматировании тома. Если при форматировании раздела размер кластера не указан, он выбирается по умолчанию на основании размера раздела. Это значение должно быть кратно размеру физического сектора диска.
compress boolean	Включает сжатие для создаваемого тома NTFS. Сжатие NTFS не поддерживается, если значение allocation_unit_size превышает 4096. Варианты: `false` `true`
drive_letter string	Задает букву диска форматируемого тома.
file_system string	Задает файловую систему, используемую при форматировании целевого тома. Варианты: `"ntfs"` `"refs"` `"exfat"` `"fat32"` `"fat"`
force boolean	Указывает, следует ли принудительно форматировать тома, созданные не из новых разделов, или тома, у которых исходная и целевая файловые системы различаются. Варианты: `false` ← (по умолчанию) `true`
full boolean	Полное форматирование записывает данные в каждый сектор диска, занимает значительно больше времени, чем форматирование по умолчанию (быстрое), и не рекомендуется для хранилищ с тонким выделением ресурсов. Для полного форматирования укажите `true`. Варианты: `false` ← (по умолчанию) `true`
integrity_streams boolean	Включает потоки целостности для создаваемого тома ReFS. Варианты: `false` `true`
label string	Задает метку форматируемого тома.
large_frs boolean	Указывает, что следует использовать большую файловую таблицу записей (FRS). Варианты: `false` `true`
new_label string	Задает новую метку файловой системы форматируемого тома.
path string	Задает путь к форматируемому тому.

Примечания

Примечание

Для использования этого модуля требуется Microsoft Windows Server 2012, Microsoft Windows 8 или более новая версия. Чтобы проверить совместимость системы, см. https://docs.microsoft.com/en-us/windows/desktop/sysinfo/operating-system-version.
Для определения целевого тома необходимо указать один из трех параметров (drive_letter, path и label), но одновременно можно указать только один из них.
Этот модуль идемпотентен, если параметр force не указан; метки файловой системы сохраняются.
Дополнительные сведения см. в разделе https://learn.microsoft.com/en-us/windows-hardware/drivers/storage/format-msft-volume

См. также

community.windows.win_disk_facts: Показывает подключенные диски и сведения о дисках целевого узла.
community.windows.win_partition: Создает, изменяет и удаляет разделы в Windows Server.

Примеры

- name: Create a partition with drive letter D and size 5 GiB
  community.windows.win_partition:
    drive_letter: D
    partition_size: 5 GiB
    disk_number: 1

- name: Full format the newly created partition as NTFS and label it
  community.windows.win_format:
    drive_letter: D
    file_system: NTFS
    new_label: Formatted
    full: true

Авторы

Varun Chopra (@chopraaa)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_format_module.html