win_format – Форматирует существующий том или новый том на существующем разделе в Windows

Новая версия с 2.8.

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

Описание

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

Параметры

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

Примечания

Примечание

Один из трех параметров (drive_letter, path и label) обязателен для идентификации целевого тома, но одновременно нельзя указывать более одного.
Этот модуль является идемпотентным, если force не указан и метки файловой системы сохраняются.
Дополнительную информацию см. на https://docs.microsoft.com/en-us/previous-versions/windows/desktop/stormgmt/format-msft-volume

См. также

win_disk_facts – Отображает подключенные диски и информацию о дисках целевого узла: Официальная документация по модулю win_disk_facts.
win_partition – Создание, изменение и удаление разделов в Windows Server: Официальная документация по модулю win_partition.

Примеры

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

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

Статус

Данному модулю не гарантируется обратная совместимость интерфейса. [превью]
Данный модуль поддерживается сообществом Ansible. [community]

Авторы

Varun Chopra (@chopraaa) <v@chopraaa.com>

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/win_format_module.html