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

Примечание

Этот плагин является частью коллекции community.windows (версия 1.2.0).

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

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

Обзор
Параметры
Примечания
См. также
Примеры

Обзор

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

Параметры

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

Примечания

Примечание

Для использования данного модуля требуется Microsoft Windows Server 2012 или Microsoft Windows 8 или более поздняя версия. Чтобы проверить совместимость вашей системы, см. https://docs.microsoft.com/ru-ru/windows/desktop/sysinfo/operating-system-version.
Один из трех параметров (drive_letter, path и label) обязателен для определения целевого тома, но нельзя указывать более одного одновременно.
Этот модуль идемпотентен, если force не указан и метки файловой системы сохраняются.
Дополнительную информацию см. в https://docs.microsoft.com/ru-ru/previous-versions/windows/desktop/stormgmt/format-msft-volume

См. также

community.windows.win_disk_facts: Официальная документация модуля community.windows.win_disk_facts.
community.windows.win_partition: Официальная документация модуля community.windows.win_partition.

Примеры

- 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) <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.10/collections/community/windows/win_format_module.html